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

Постройте сами вместо того, чтобы загружать

AndroidAPS недоступен для скачивания из-за законодательства, касающегося медицинских устройств. Построить приложение для собственного использования вполне законно, но вам не разрешается передавать копию другим! См. раздел FAQ.

## Важные Примечания

** Конфигурация по требованию ** не поддерживается текущей версией модуля Android Gradle!

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

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

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

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

Пошаговое руководство

Подробное описание шагов, необходимых для создания файла APK.

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

Следуйте инструкциям на странице установки git.

Установите Android Studio

Cледующие снимки экрана были сделаны c Android Studio версии 3.6.1. Экран может выглядеть несколько иначе в зависимости от используемой версии Android Studio. Но следует постараться найти свое решение установки. Помощь от сообщества здесь.

Одна из наиболее важных заповедей при установке Android Studio: ** Будьте терпеливы! ** Во время установки и настройки Android Studio загружает многие элементы, которые отнимают время.

Установите Android Studio и настройте при первом запуске.

Выберите “Не импортировать настройки”, так как вы не использовали их раньше.

Не импортируйте настройки

Решите, хотите ли вы совместно использовать данные с Google или нет.

Обмен данными с Google

На следующем экране нажмите кнопку “Далее”.

Экран приветствия

Выберите “Стандартная” установка и нажмите “Далее”.

Стандартная установка

Для интерфейса выберите тему, которая вам нравится. (В этом руководстве мы использовали “Светлую”.) Затем нажмите кнопку “Далее”. Это всего лишь цветовая схема. Можете выбрать любую (напр. Darcula для темного режима). Этот выбор не влияет на построение APK.

цветовая схема UI

Нажмите “Далее” в диалоге “Проверить настройки”.

Подтвердить настройки

Подождите, пока Android Studio скачивает дополнительные компоненты и будет терпеливы. После того, как все загрузится кнопка “Готово”, станет синей. Теперь нажмите на кнопку.

Загрузка компонентов

Задайте путь к git в параметрах

Убедитесь, что git установлен на вашем компьютере.

На экране приветствия Android Studio нажмите на маленький треугольник (1. на следующем снимке экрана) и выберите “Настройки” (2.).

Параметры Android Studio с экрана приветствия

Windows

  • Нажмите на маленький треугольник рядом с Контролем Версий (1.) чтобы открыть подменю.
  • Нажмите Git (2.).
  • Убедитесь, что выбран метод обновления “Слияние” (merge) (3.).
  • Проверьте, может ли Android Studio найти путь к файлу git.exe автоматически, нажав кнопку “Тест” (4.)

Параметры Android Studio

  • Если автоматическая настройка будет успешной, то будет показана версия git.
  • Нажмите кнопку “OK” в диалоговом окне (1.) и “OK” в окне параметров (2.).

Автоматическая установка git успешно выполнена

  • В случае, если файл git.exe не найден, нажмите кнопку “OK” в диалоговом окне (1), а затем кнопку с тремя точками (2.).
  • Используйте функцию поиск в проводнике Windows для поиска “git.exe”, если вы не уверены в том, где его можно найти. Вы ищете файл git.exe, находящийся в папке \bin.
  • Выберите путь к файлу git.exe и убедитесь, что вы выбрали папку ** \bin\ ** (3.) и нажмите кнопку “OK” (4).
  • Закройте окно параметров, нажав кнопку “OK” (5.).

Автоматическая установка git не выполнена

  • Перезагрузите компьютер, чтобы обновить системную среду.

Mac

  • Любая версия git должна работать. Например https://git-scm.com/download/mac.
  • Используйте homebrew для установки git: $ brew install git.
  • Подробности об установке git см. в официальной документации git .
  • Если вы устанавливаете git через homebrew, то нет необходимости изменять какие-либо настройки. На всякий случай: Их можно найти здесь: Android Studio - Настройки.

Скачайте код AndroidAPS

  • Если вы еще не перезагрузили компьютер после настройки пути к git в параметрах, сделайте это сейчас. Необходимо обновить системную среду.
  • На экране приветствия Android Studio щелкните на маленьком треугольнике справа от “Изъять проект из системы управления версиями” (1.).
  • Выберите “Git” (2).

Извлечение проекта из системы управления версиями окна приветствия

  • Если вы уже открыли Android Studio и не видите экран приветствия, то выберите File (1.) > New (2.) > Project from Version Control... (3.) > Git (4.).

Извлечение проекта из системы управления версиями в Android Studio

  • Заполните URL-адрес главного репозитория AndroidAPS (“https://github.com/MilosKozak/AndroidAPS”) и нажмите “clone” (клонировать).
  • Выберите каталог для сохранения клонированного кода.
  • Нажмите кнопку “Test” (2.).
  • Если тест не может быть завершен успешно, проверьте еще раз адрес, и нажмите “Проверить”.
  • Если URL-адрес введен правильно появится сообщение “подключение успешно” (3.).
  • Нажмите кнопку “Клонировать” (4.).

Клонирование репозитория

  • Не нажимайте “Background”, пока клонируется репозиторий!

Клонирования репозитория - без фоновых действий

  • После того, как репозиторий клонирован успешно, откройте локальную копию, нажав кнопку “Да”.

Открытие репозитория

  • В правом нижнем углу появится информация о том, что в Android Studio выполняются фоновые задачи.

Фоновые задания

  • Предоставьте доступ, если ваш брандмауэр просит разрешения.

Разрешение брандмауэра (Java)

  • После завершения фоновых задач вы, вероятно, увидите следующее сообщение об ошибке:

Лицензия SDK

Загрузите Android SDK

  • Нажмите Файл > Настройки.

Открыть настройки

  • Нажмите на маленький треугольник рядом с Appearance & Behaviour (1.).
  • Щелкните на небольшом треугольнике рядом с System Settings (2.) и выберите Android SDK (3.)
  • Установите флажок слева от “Android 9.0 (Pie)” (4.) (API Level 28).

Параметры SDK

  • Подтвердите изменения, нажав кнопку OK.

Подтвердить изменения SDK

  • Примите лицензионное соглашение (1.) и нажмите “Далее” (2.).

Принять лицензию SDK

  • Дождитесь завершения установки.

Ожидание во время установки SDK

  • После завершения установки SDK кнопка “Finish” станет синей. Нажмите на кнопку.

Завершения установки пакета SDK

  • Android Studio может рекомендовать обновить систему gradle. Не обновляйте gradle! Это может привести к трудностям!
  • Если вы видите информацию в нижней правой части окна Android Studio, что модуль Android Gradile готов к обновлениям, щелкните по тексту “update” (1.) и в диалоговом окне выберите “Don’t remind me again for this project” (2.).

Не обновляем gradle

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

Подписание означает, что вы подписываете созданное вами приложение, но цифровым способом, как цифровым отпечатком пальца в самом приложении. Это необходимо потому, что Android имеет правило, согласно которому принимается только подписанный код для запуска по соображениям безопасности. Для получения дополнительной информации перейдите по этой ссылке.

  • Нажмите “Build” в строке меню и выберите “Generate Signed Bundle / APK...”.

Построение apk

  • Выберите “APK” (1.) вместо “Android App Bundle” и нажмите кнопку “Далее” (2.).

Apk вместо пакета

  • Убедитесь, что модуль имеет значение “app” (1.).

  • Нажмите “Create new” (cоздать новый...) для создания магазина ключей.

    В этом случае магазин ключей является всего лишь файлом, в котором хранится информация о цифровой подписи. Он зашифрован и информация защищена паролями.

Создание хранилища ключей

  • Нажмите на символ папки (1.), чтобы выбрать путь к хранилищу ключей.
  • Выберите путь к хранилищу ключей (2.). **Не сохраняйте в той же папке, что и проект. Необходимо использовать другой каталог! ** Одна из опций может быть ваша домашняя папка.
  • Введите имя файла для хранилища ключей (3).
  • Нажмите “OK” (4.).
  • Пароли для хранилища ключей и ключа не должны быть очень сложными. Обязательно запомните их или запишите в безопасное место. В случае, если вы не запомните пароли смотрите устранение неполадок для потерянных ключей .
  • Введите (5.) и подтвердите (6.) пароль для хранилища ключей.
  • Сделайте то же самое для ключа (7. + 8.).
  • Срок действия (9.) по умолчанию составляет 25 лет. Изменять значение по умолчанию не требуется.
  • Необходимо ввести имя и фамилию (10). Вся остальная информация необязательна.
  • Когда закончите, нажмите кнопку “OK” (11.).

Путь к магазину ключей

  • Убедитесь, что поле для запоминания паролей отмечено (1.). Так что вам не нужно вводить их снова при следующей сборке apk (то есть при обновлении до новой версии AndroidAPS).
  • Нажмите “Далее” (2.).

Запомнить пароль

  • Выберите вариант компоновки “fullRelease” (1.).
  • Отметьте флажки V1 и V2 для подписи версий (2.).
  • Нажмите Finish. (3.)

Завершение сборки

  • После завершения сборки Android Studio покажет информацию “APK (s) сгенерировано успешно ...”.
  • В случае, если сборка не удалась, обратитесь к разделу поиск и устранение неисправностей.
  • Самый простой способ найти apk это нажать на кнопку “журнал событий”.

Построено успешно - журнал событий

  • В секции журнала событий нажмите «locate».

Журнал событий - обнаружить apk

  • app-full-release.apk это файл, который вы ищете.

Расположение файла apk

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

Самый простой способ перенести приложение на ваш телефон - через кабель USB или Google Drive. Обратите внимание, что передача по почте может вызвать трудности и не является предпочтительным способом.

На вашем телефоне необходимо разрешить установку из неизвестных источников. Инструкции, как это сделать, можно найти в интернете (например здесь или здесь).

Идентифицируйте ресивер при использовании xDrip+

Смотрите страницу xDrip+

Устранение неполадок

См. отдельную страницу устранение неполадок Android Studio.