1. Обзор
В этой лабораторной работе вы узнаете, как распространять выпуски Android App Bundle среди тестировщиков с помощью Firebase App Distribution и его плагина Gradle. App Distribution предоставляет центральный узел для управления предварительными версиями вашего приложения и тестировщиками, которых вы приглашаете для каждого выпуска.
Что вы узнаете
- Как связать ваше приложение Firebase с Google Play
- Как упаковать и собрать приложение в виде набора приложений
- Как создать релиз и поделиться им с тестерами
- Как загружать и тестировать новые релизы в качестве тестера
Что вам понадобится
- Последняя версия Android Studio
- Подписанный пакетный файл, созданный в Android Studio.
- Аккаунт разработчика Google Play, владельцем или администратором которого вы являетесь.
- Ваше приложение в Google Play настроено на панели приложений Google Play и имеет следующий статус :
- Приложение распространяется по одному из направлений Google Play (внутреннее тестирование, закрытое тестирование, открытое тестирование или производство).
- Проверка приложения в Google Play завершена, и приложение опубликовано. Ваше приложение опубликовано, если в столбце Статус приложения отображается один из следующих статусов: Внутреннее тестирование (не Черновик внутреннего тестирования), Закрытое тестирование, Открытое тестирование или Производство.
- Адрес электронной почты, который вы можете использовать в качестве тестировщика для получения новых приглашений на сборку от Firebase.
2. Создайте проект Firebase
- Войдите в Firebase .
- В консоли Firebase нажмите «Добавить проект» и назовите свой проект «AppBundlesCodelab». Запомните идентификатор проекта для вашего проекта Firebase. Если вы не измените идентификатор проекта, Firebase автоматически присвоит вашему проекту уникальный идентификатор.
- (Необязательно) При появлении запроса включите Google Analytics.
- Выполните оставшиеся шаги, затем нажмите «Создать проект» .
Добавьте свой пакет приложений в проект
- В консоли Firebase нажмите Добавить приложение .
- При регистрации приложения обязательно используйте то же имя пакета , что и приложение, загруженное в вашу учетную запись разработчика Google Play. Наконец, нажмите «Зарегистрировать приложение» .
- Выполните оставшиеся шаги, чтобы добавить в приложение файл конфигурации Firebase (
google-services.json). Обратите внимание, что для Android приложение App Distribution не имеет Firebase SDK, который можно добавить в ваше приложение. - Щелкните Продолжить в консоли .
Ссылка на GooglePlay
- В консоли Firebase перейдите в настройки вашего проекта .
- На вкладке «Интеграции» нажмите «Ссылка» на карточке Google Play .
- Следуйте инструкциям на экране, чтобы включить интеграцию с распространением приложений, затем выберите только что созданное приложение Firebase, чтобы связать его с Google Play.
Теперь, когда вы выполнили эти шаги, ваше приложение Firebase будет связано с вашим приложением в вашей учетной записи разработчика Google Play, если имена пакетов приложений совпадают.
3. Добавьте распространение приложений в свой проект
Добавьте плагин Gradle для распространения приложений.
Теперь вы будете использовать Android Studio для добавления App Distribution и его плагина Gradle в свое приложение.
- В файле Gradle уровня проекта (
android/build.gradle.kts) добавьте подключаемый модуль App Distribution Gradle в блокplugins.plugins { //... // Add the App Distribution Gradle plugin id("com.google.firebase.appdistribution") version "4.0.0" apply false } - В файле настроек Gradle на уровне проекта (
android/settings.gradle.kts) добавьте репозиторий Google Maven в блокpluginManagement.pluginManagement { // Check that you have Google's Maven repository (if not, add it). repositories { google() mavenCentral() } } - В файле Gradle на уровне приложения (
android/app/build.gradle.kts) добавьте плагин App Distribution в блокplugins.plugins { //... // Add the App Distribution plugin id("com.google.firebase.appdistribution") } - Если вы находитесь за корпоративным прокси-сервером или брандмауэром, добавьте следующее системное свойство Java, которое позволяет службе распространения приложений загружать ваши дистрибутивы в Firebase:
-Djavax.net.ssl.trustStore=/path/to/truststore -Djavax.net.ssl.trustStorePassword=password
Аутентифицируйте свой проект Firebase
Прежде чем вы сможете использовать плагин Gradle, вам необходимо аутентифицировать свой проект Firebase. Для этой лаборатории кода вы войдете в свою учетную запись Google с помощью интерфейса командной строки Firebase .
Запустите следующую команду в корне вашего проекта Android:
~/your-android-project$ firebase login
Справочная документация содержит более подробную информацию.
4. Настройте свойства пакета в Android Studio.
На этом шаге вы добавите себя в качестве тестировщика сборки, которую будете распространять позже. Как только вы распространяете сборку, тестировщики получают уведомления по электронной почте от Firebase с приглашением протестировать новую сборку.
В app/build.gradle.kts добавьте раздел firebaseAppDistribution и включите следующие параметры:
-
appID: идентификатор вашего приложения в Firebase. Вы можете найти его на вкладке «Общие» в настройках вашего проекта . -
artifactType: тип файла вашего приложения (AAB). -
testers: адреса электронной почты ваших тестировщиков. Для этой лаборатории кода добавьте свой собственный адрес электронной почты, чтобы вы могли протестировать свою сборку после ее распространения.
Например:
android {
// ...
buildTypes {
getByName("release") {
firebaseAppDistribution {
appId = "yourAppId"
artifactType = "AAB"
testers = "ali@example.com, bri@example.com, cal@example.com"
}
}
}
// ...
}
Как вариант, вы также можете переопределить значения, установленные в вашем build.gradle.kts , передав аргументы командной строки в виде -PappDistribution- property-name = property-value .
5. Создайте и распространите выпуск
- Запустите задачу
bundle Variant, чтобы создать файл пакетов приложений:$ ./gradlew :base:bundleRelease - Найдите пакет в каталоге сборки вашего приложения (расположение по умолчанию —
app/build/outputs/bundle/release). - Чтобы распространить выпуск, создайте целевые пакеты
bundleReleaseиappDistributionUploadReleaseс помощью оболочки Gradle вашего проекта. Включите токен Firebase (тот, который вы получили на шаге 3: добавление распространения приложений в свое приложение).export FIREBASE_TOKEN=your_firebase_token ./gradlew --stop // Only needed for environment variable changes ./gradlew bundleRelease appDistributionUploadRelease
Теперь тестировщики будут получать по электронной почте приглашения загрузить и протестировать сборку. Как разработчик, вы теперь можете отслеживать сборку на вкладке «Релизы» панели управления распространением приложений.
6. Загрузите и протестируйте свою версию
В этом разделе вы настроитесь в качестве тестировщика, чтобы загрузить распространяемый вами выпуск. Как тестировщик, вам необходимо аутентифицировать свое тестовое устройство и включить внутренний общий доступ к приложению в приложении Google Play Store.
- На тестовом устройстве войдите в свою учетную запись электронной почты тестера и откройте приглашение от Firebase.
- Войдите в свою учетную запись Google и примите приглашение протестировать распределенную версию. Как вариант, вы также можете загрузить Firebase App Tester , который предотвращает добавление загруженных выпусков в папку
Downloadsвашего устройства. Он также отображает дополнительную информацию о выпусках, такую как ход загрузки и версия выпуска.
- Нажмите «Загрузить» в выпуске, чтобы установить его из Play Store.
- При появлении запроса выполните оставшиеся шаги, чтобы включить внутренний общий доступ к приложению (инструкции отображаются на тестовом устройстве, и их нужно выполнить только один раз).
После завершения загрузки ваш выпуск автоматически появится в виде ярлыка на главном экране вашего устройства.
7. Поздравляем!
Вы только что использовали Firebase App Distribution для загрузки набора приложений и распространения версии среди тестировщиков.
Следующие шаги
- Перейдите к документации по распространению приложений , чтобы узнать больше о том, как управлять тестировщиками для вашего выпуска.
- Информацию о других инструментах, которые можно использовать для развертывания приложения, см. в разделе Сборка и тестирование набора приложений для Android .