Прочитать на английском

Поделиться через


Создание приложений 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 (уровень приложения). Выберите вариант сборки.

Примечание

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

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, ее необходимо подписать с действительным сертификатом, хранящимся в хранилище ключей. Чтобы подписать сборки из ветви, включите вход кода в область конфигурации, отправьте хранилище ключей в репозиторий и укажите соответствующие учетные данные в области конфигурации. Дополнительные сведения о входе в код в документации по подписи кода Android в Центре приложений. Он .aab будет подписан с помощью одних и того же учетных данных, что .apkи .

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

Используйте только что созданный ФАЙЛ APK, чтобы проверить, запускается ли приложение на реальном устройстве. Это добавляет около 10 минут к общему времени сборки. Узнайте больше о настройке тестов запуска.

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

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

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

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

Примечание

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

4. Результаты сборки

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

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

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. Создание нескольких API

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

4.4. Файл сопоставления деobfuscation-mapping (mapping.txt)

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

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

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

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

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

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