Создание андроид-приложения (APK)

Build yourself instead of download

AndroidAPS is not available as download due to regulation for medial devices. It is legal to build the app for your own use but you must not give a copy to others! See FAQ page for dertails.

## Important notes

Please note With AndroidAPS version 2.3 it is not possible to build the APK with the latest Android Studio version. Please use Android Studio 3.4 from here.

Please note when building AndroidAPS 2.0 apk: Configuration on demand is not supported by the current version of the Android Gradle plugin!

Если сборка выполнена с ошибкой, относящейся к “выборочной конфигурации”, можно сделать следующее:

  • Откройте окно настроек, нажав Файл > Настройки (на Mac, Android Studio > Настройки).
  • В левой панели нажмите Сборка, Выполнение, Развертывание > Компилятор.
  • Снимите флажок с ячейки “выборочная конфигурация”.
  • Нажмите Применить или OK.

Эта статья разделена на две части.

  • В обзорной части находится объяснение того, какие шаги необходимы для создания файла APK.
  • В пошаговой инструкции вы найдете снимки экранов установки. Поскольку версии Android Studio - среды разработки программного обеспечения, в которой мы будем создавать APK - меняются очень быстро, точного соответствия вашей сборке вы не увидите, но общее представление о том, как это делается, получите. Android Studio работает на Windows, Mac OS X и Linux, и между каждой платформой возможны незначительные различия. Если вы обнаружите, что что-то важное выполняется неправильно или отсутствует, сообщите в группе facebook “AndroidAPS users” или в чате Gitter Android APS или AndroidAPSwiki чтобы мы могли устранить проблему.

Главный экран, Начало

In general, the steps necessary to build the APK file:

  • Установить git
  • Установить и настроить Android Studio.
  • Используя Git  клонировать исходный код центрального репозитория Github, где разработчики разместили код приложения.
  • В Android Studio открыть клонированный проект в качестве активного.
  • Построить подписанный APK.
  • Переместите подписанный APK на ваш телефон.

Step by step walkthrough

Detailed description of the steps necessary to build the APK file.

Установите git (если у вас его нет)

Windows

  • Любая версия git должна работать. Например https://git-scm.com/download/win

  • Убедитесь, что знаете путь установки. Он потребуется вам позже после установки Android Studio.

    Путь установки Git

Mac

Install Android Studio

The following screenshots have been taken from Android Studio Version 3.1.3. Your screen might look a bit different depending on the Android Studio version you use. But you should be able to find your way through. Help from the community is provided for example in the AndroidAPS Facebook group and other places.

Install Android Studio and setup during first start.

Select “Do not import settings” as you have not used it before.

Снимок экрана 1

Click “Next”.

Screenshot 2

Select “Standard” installation and click “Next”.

Screenshot 3

Select the theme for the user interface you like. (In this manual we used “Intellij”. Then click “Next”. This is just the color scheme. You can select any you like (i.e. “Darcula” for dark mode). This selection has no influence on building the APK.

Screenshot 4

Click “Next” on the “Verify Settings” dialog.

Screenshot 5

The Android emulator (to emulate the smartphone on your PC or Mac) is not used to build the APK. You can click “Finish” to finish the installation and read the documentation later on demand.

Screenshot 6

Android Studio is downloading a lot of software components it uses. You can click on the “Show Details” button to the what happens but that’s not important at all.

Screenshot 7

Screenshot 8

After the downloads are completed click the “Finish” button.

Screenshot 9

  • Аплодисменты, аплодисменты. Установка Android Studio завершена и можно приступить к клонированию исходного кода. Можно сделать короткий перерыв.

Set git path in preferences

Windows

  • Укажите Studio, где находится git.exe: Файл - Настройки

    Android Studio - открыть настройки

  • В следующем окне: Управление версиями - Git

  • Выберите правильный путь: .../Git/bin

  • Убедитесь, что выбран метод обновления “Объединение”.

    Android Studio - путь GIT

Mac

  • Если вы устанавливаете git через homebrew, то нет необходимости изменять какие-либо настройки. На всякий случай: Их можно найти здесь: Android Studio - Настройки.

Download code and additional components

  • Используйте клон Git в Android Studio, как показано на снимках экрана ниже. Выберите “Проверить проект из системы управления версиями” при помощи Git в качестве конкретной системы управления версиями.

Screenshot 10

Version_Control_Git

Fill in the URL to the main AndroidAPS repository (“https://github.com/MilosKozak/AndroidAPS”) and click “clone”.

Screenshot 13

Android Studio will start cloning. Don’t click “Background” as it goes fast and makes things more complicated at the moment.

Screenshot 14

Finish the checkout from version control with opening the project by clicking “Yes”.

Screenshot 15

Use the standard “default gradle wrapper” and click “OK”.

Screenshot 16

Read and close the “Tip of Day” screen of Android Studio by pressing “Close”.

Screenshot 17

  • Отлично, теперь у нас есть своя копия исходного кода и мы готовы начать сборку.
  • Теперь мы приближаемся к нашему первому сообщению об ошибке. К счастью, Android Studio будет сразу предлагать нам решения.

Click “Install missing platform(s) and sync project” as Android Studio needs to install a missing platform.

Screenshot 18

Accept the license agreement by selecting “Accept” and clicking “Next”.

Screenshot 19

As it is said in the dialog please wait until the download is finished.

Screenshot 20

Now it’s finished. Please click “Finish”.

Screenshot 21

Aaaahhh, next error. But Android Studio suggests a similar solution. Click “Install Build Tools and sync project” as Android Studio needs to download missing Tools.

Screenshot 22

As it is said in the dialog please wait until the download is finished.

Screenshot 23

Now it’s finished. Please click “Finish”.

Screenshot 24

And another error to handle as Android Studio needs to download again a missing platform. Click “Install missing platform(s) and sync project”.

Screenshot 25

As it is said in the dialog please wait until the download is finished.

Screenshot 26

Now it’s finished. Please click “Finish”.

Screenshot 27

Click “Install Build Tools and sync project” as Android Studio needs to download missing Tools.

Screenshot 28

As it is said in the dialog please wait until the download is finished.

Screenshot 29

Now it’s finished. Please click “Finish”.

Screenshot 30

Yeah, the error messages are gone and the first gradle build is runing. Maybe it’s time to drink some water?

Screenshot 31

Android Studio recommends to update the gradle system. Never update gradle! This might lead to difficulties!

Please click “Don’t remind me again for this project”.

Screenshot 32

The build is running again.

Screenshot 33

Yeah, the first build is successful but we are not finished.

Screenshot 34

Создание подписанного APK

В меню выберите “Build”(выполнить сборку) и затем “Generate Signed Bundle / APK...”(создать подписанный пакет программ). (Меню в Android Studio изменилось с сентября 2018 года. In older versions select in the menu “Build” and then “Generate Signed APK...”.)

Signing means that you sign your generated app but in a digital way as a kind of digital fingerprint in the app itself. Это необходимо потому, что Android имеет правило, согласно которому принимается только подписанный код для запуска по соображениям безопасности. Для получения дополнительной информации по этой теме перейдите по ссылке здесь. Безопасность - это глубокая и сложная тема, нам она сейчас не нужна.

Снимок экрана 39a

В следующем диалоговом окне выберите “APK” вместо “Android App Bundle” и нажмите кнопку “Далее”.

Снимок экрана 39b

Выберите “app” (приложение) и нажмите “Next” (далее).

Снимок экрана 40

Click “Create new...” to start creating your keystore. A keystore in this case is nothing more than a file in which the information for signing is stored. It is encrypted and the information is secured with passwords. We suggest storing it in your home folder and remember the passwords but if you lose this information it’s not a big issue because then you just have to create a new one. Best practice is to store this information carefully.

Screenshot 41

  • Заполните информацию для следующего диалога.
    • Путь к хранилищу ключа: путь к файлу магазина ключей
    • Поля пароля для хранения ключей даются, чтобы дважды проверить ввод.
    • Alias - это имя для нужного вам ключа. Вы можете оставить его по умолчанию или дать ему имя, которое придумаете.
    • Поля пароля под ключом нужны для самого ключа. Как всегда, дважды проверьте ошибки на вводе.
    • Можно оставить срок валидности по умолчанию 25 лет.
    • Обязательны к заполнению только имя и фамилия, но можно заполнить остальную информацию. Затем нажмите “OK”.

Screenshot 42

Fill in the information of the last dialog in this dialog and click “Next”.

Screenshot 43

Выберите “full” (полный) в качестве атрибута для сгенерированного приложения. Выберите V1 “Jar Signature” (V2 необязательно) и нажмите “Finish” (закончить). В дальнейшем может пригодиться следующая информация.

  • ‘Release’ должен быть вашим выбором по умолчанию для “Build Type”(типа сборки), ‘Debug’ только для программистов.
  • Выберите тип сборки, который хотите создать.
    • полный (с автоматически принимаемыми рекомендациями в закрытом цикле)
    • открытый цикл (рекомендации, адресованные пользователю, выполняются вручную)
    • управление помпой (дистанционное управление помпой, без функционирования цикла)
    • nsclient (например, отображаются данные другого пользователя, могут добавляться записи портала лечения/назначений)

Снимок экрана 44

В журнале событий вы увидите, что подписанное приложение (APK) было создано успешно.

Снимок экрана 45

Нажмите на ссылку “Найти” в журнале событий.

Снимок экрана 46

Перенос приложения на смартфон

Открывается окно файлового менеджера. Может выглядеть немного иначе в вашей системе, поскольку я использую Linux. В Windows это будет File Explorer (проводник), а на Mac OS X Finder (поисковик). Там вы увидите каталог с созданным APK файлом. К сожалению, это неверное место, так как “wear-release.apk” не является подписанным приложением, которое мы ищем.

Снимок экрана 47

Перейдите к папке AndroidAPS/app/full/release, чтобы найти файл “app-full-release.apk”. Перенесите этот файл на смартфон Android. Вы можете сделать это по-своему, напр. загрузкой в облако, переносом с компьютера по кабелю или используя электронную почту. В этом примере я использую Gmail, так как для меня такой перенос привычнее. Для установки на нашем смартфоне следует дать системе Android разрешение сделать установку из Gmail, которая обычно запрещена. Если переносите установщик другим способом, поступите соответственно.

Снимок экрана 48

В настройках смартфона есть область “установка неизвестных приложений” где я даю Gmail право устанавливать APK файлы, которые я получаю через Gmail.

Выберите “Разрешить из этого источника”. После установки вы можете отключить его снова.

Установка приложений из неизвестных источников

Последний шаг - нажать на файл APK, который я получил через Gmail и установить приложение. Если APK не установливается и у вас более старая версия AndroidAPS на телефоне, подписанная другим ключом, то нужно сначала удалить более старое приложение; при этом не забудьте экспортировать ваши настройки!

Да, все получилось, теперь можно начать настройку AndroidAPS (CGMS, помпа) и т. д.