Создание приложений Java для Android

  • Статья

Важно!

Прекращение поддержки Центра приложений Visual Studio запланировано на 31 марта 2025 г. Хотя вы можете продолжать использовать Центр приложений Visual Studio, пока он не будет полностью выведен из эксплуатации, существует несколько рекомендуемых вариантов, на которые вы можете рассмотреть возможность миграции.

Узнайте больше о сроках поддержки и альтернативных вариантах.

Чтобы создать свое первое приложение Android, выполните следующие действия.

  1. Подключитесь к учетной записи службы репозитория (GitHub, Bitbucket, VSTS, Azure DevOps).
  2. Выберите репозиторий и ветвь, в которой находится ваше приложение.
  3. Выберите проект Android, который вы хотите создать.
  4. Настройте первую сборку.

Примечание

Чтобы приложение выполнялось на реальном устройстве, сборка должна быть подписана с помощью действительного сертификата.

Примечание

Центр приложений отслеживает проект, выполнив поиск в файлах каталога gradle (и gradlew) проекта Android. Не включайте эти файлы в проект .gitignore, так как сборка Центра приложений не сможет найти их.

Предупреждение

Из-за недавнего завершения работы JCenter некоторые приложения могут столкнуться с ошибками задачи Gradle при сборке с помощью Центра приложений. Ознакомьтесь с руководством по миграции, предоставленным Gradle. В качестве обходного решения все экземпляры jcenter() можно удалить из build.gradle файла и заменить на jcenter { url "http://jcenter.bintray.com/"}. Дополнительные сведения о завершении работы JCenter см. здесь.

1. Связывание репозитория

Если это еще не сделано, необходимо подключиться к учетной записи службы репозитория. После подключения учетной записи выберите репозиторий, в котором находится проект Android. Чтобы настроить сборку для репозитория, вам потребуется разрешение администратора и разрешение на извлечение.

2. Выбор ветви

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

3. Настройка первой сборки

Перед первой сборкой необходимо настроить проект Android.

3.1. Триггеры сборки

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

3.2. Вариант сборки

Доступные варианты сборки будут заполнены из типов сборки и вариантов продуктов, указанных в файле build.gradle (уровень приложения). Выберите вариант сборки, который следует построить.

Примечание

Сборка в Центре приложений поддерживает поиск вариантов сборки в виде сочетания типа сборки (отладка, выпуск или пользовательское определение) и одного из объявленных вариантов продукта. Обнаружение размеров вкуса (комбинаций нескольких вкусов продуктов) в настоящее время не поддерживается.

3.3. Создание пакета приложений Android (.aab)

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

Переключите параметр для пакета приложений Android, чтобы создать в .aab дополнение к .apk. build.gradle Если файл (на уровне приложения) содержит android.bundle блок, этот параметр уже включен.

3.4. Приращение номера версии

Если этот параметр включен, код версии в AndroidManifest.xml приложения автоматически увеличивается для каждой сборки. Это изменение происходит во время фактической сборки и не будет зафиксировано в репозитории.

3.5. подписывание кода;

Успешная сборка .apk создаст файл и дополнительный .aab файл, если он включен. Чтобы выпустить сборку в Play Store, она должна быть подписана действительным сертификатом, хранящимся в хранилище ключей. Чтобы подписать сборки, созданные из ветви, включите вход кода в области конфигурации, отправьте хранилище ключей в репозиторий и укажите соответствующие учетные данные в области конфигурации. Дополнительные сведения о входе кода см. в документации по подписывке кода Android в Центре приложений. Будет .aab подписан с использованием того же удостоверения, что и .apk.

3.6. Запуск успешной сборки на реальном устройстве

Используйте только что созданный APK-файл, чтобы проверить, запускается ли приложение на реальном устройстве. Это добавляет еще примерно 10 минут к общему времени сборки. Дополнительные сведения о настройке тестов запуска см. в этой статье.

3.7. Настройка из файла build.gradle (уровень приложения)

Из файла Gradle будут собираться конкретные сведения о сборке, включая зависимости, версию средств сборки, типы сборки и варианты продуктов.

3.8. Распространение сборки

Каждую успешную сборку из ветви можно настроить для распространения в ранее созданную группу рассылки или в место назначения хранилища. Вы можете добавить новую группу рассылки или настроить подключение к хранилищу из службы распространения. Всегда есть группа рассылки по умолчанию с именем "Участники совместной работы", в которую входят все пользователи, имеющие доступ к приложению.

Примечание

При распространении в Google Play Store предпочтительнее использовать пакет приложений Android (.aab) и будет распространяться, если он включен. Для групп рассылки Центра приложений и Intune назначений магазинов будет использоваться обычный .apk.aab, даже если также создается .

4. Создание результатов

После активации сборки она может находиться в следующих состояниях:

  • queued — сборка находится в очереди, ожидающей освобождения ресурсов.
  • building — приложение создает и выполняет связанные задачи.
  • succeeded — сборка успешно завершена.
  • failed — сборка завершена, но завершилась сбоем. Вы можете скачать и проверить журнал сборки для устранения неполадок.
  • canceled — сборка была отменена действием пользователя или истекло время ожидания.

4.1. Журналы сборки

Для завершенной сборки (успешной или неудачной) скачайте журналы, чтобы узнать больше о том, как была выполнена сборка. Центр приложений предоставляет архив со следующими файлами:

|-- 1_build.txt (this is the general build log)
|-- build (this folder contains a separate log file for each build step)
    |-- <build-step-1>
    |-- <build-step-2>
    |--
    |-- <build-step-n> (e.g. n_Post Job Cleanup.txt)

Журналы для конкретных этапов сборки (расположенные в каталоге сборки или архиве) полезны для устранения неполадок и понимания того, на каком этапе и почему произошел сбой сборки.

4.2. Пакет приложения (APK)

ПАКЕТ APK — это пакет, содержащий приложение и ресурсы Android. Если сборка подписана правильно, пакет APK можно установить на реальном устройстве и развернуть в Магазине Play. Если сборка не подписана, пакет APK можно запустить в эмуляторе или использовать для других целей.

4.3. Создание нескольких apk

Если конфигурация приложения создает несколько apk, необходимо также создать универсальный пакет APK. Наша система сборки работает с одним main APK-файлом и пропускает все пакеты AP, относящиеся к определенной плотности экрана или ЦП. Дополнительные сведения о разбиениях APK и создании универсального пакета APK см. в руководстве по разбиениям ABI.

4.4. Файл сопоставления деобфускации (mapping.txt)

Файл mapping.txt содержит сведения о том, как сопоставить скрытые трассировки стека для приложения с именами исходных классов и методов.

  • Если вы ранее интегрировали пакет SDK центра приложений в свое приложение с включенным модулем отчетов о сбоях и использовали Proguard или R8 для минификации и маскировки двоичного файла приложения, служба отчетов о сбоях требует, чтобы этот mapping.txt файл для сборки отображал отчеты о сбоях, читаемые человеком (обезобученные).
  • Если вы ранее интегрировали другой пакет SDK для создания отчетов о сбоях в приложении (например, пакет SDK HockeyApp), для соответствующей службы требуется mapping.txt , чтобы файл отображал читаемые отчеты о сбоях.

5. Поддерживаемые версии и требования

Минимальная версия, поддерживаемая для создания приложений Android, — 7.0 (УРОВЕНЬ API 24). Приложения Android могут иметь более низкий минимальный уровень API, необходимый для запуска, но должны быть ориентированы на API по крайней мере уровня 24.

Для правильной настройки приложений необходимо выполнять сборку с помощью Gradle и подключаемого модуля Android Gradle. Репозиторий должен содержать оболочку Gradle.

См. также: Сведения о компьютере для облачной сборки