1. Обзор
В этой лабораторной работе вы узнаете, как распространять выпуски Android App Bundle среди тестировщиков с помощью Firebase App Distribution и его плагина Gradle. App Distribution предоставляет центральный узел для управления предварительными версиями вашего приложения и тестировщиками, которых вы приглашаете для каждого выпуска.
Что вы узнаете
- Как связать ваше приложение Firebase с Google Play
- Как упаковать и собрать приложение в виде набора приложений
- Как создать релиз и поделиться им с тестерами
- Как загружать и тестировать новые версии в качестве тестера
Что вам понадобится
- Android-студия v4.0+
- Подписанный файл пакета, созданный в 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, который можно добавить в ваше приложение. - Щелкните Продолжить в консоли .
Ссылка на Google Play
- В консоли Firebase перейдите в настройки вашего проекта .
- На вкладке «Интеграции» нажмите «Ссылка» на карточке Google Play .
- Следуйте инструкциям на экране, чтобы включить интеграцию с распространением приложений, затем выберите только что созданное приложение Firebase, чтобы связать его с Google Play.
Теперь, когда вы выполнили эти шаги, ваше приложение Firebase будет связано с вашим приложением в вашей учетной записи разработчика Google Play, если имена пакетов приложений совпадают.
3. Добавьте распространение приложений в свой проект
Добавьте плагин Gradle для распространения приложений.
Теперь вы будете использовать Android Studio для добавления App Distribution и его плагина Gradle в качестве зависимостей buildscript к вашему приложению.
- В файле Gradle на уровне проекта (
android/build.gradle) добавьте плагин App Distribution Gradle и репозиторий Google Maven.buildscript { repositories { // Check that you have Google's Maven repository (if not, add it). google() mavenCentral() } dependencies { // Add the App Distribution Gradle plugin classpath `com.google.firebase:firebase-appdistribution-gradle:2.1.2` } } - В файле Gradle на уровне приложения (
android/app/build.gradle) добавьте плагин App Distribution:apply plugin: `com.android.application` // ... // Apply the App Distribution Gradle plugin apply plugin: `com.google.firebase.appdistribution` // ... - Если вы находитесь за корпоративным прокси-сервером или брандмауэром, добавьте следующее системное свойство Java, которое позволяет службе распространения приложений загружать ваши дистрибутивы в Firebase:
-Djavax.net.ssl.trustStore=/path/to/truststore -Djavax.net.ssl.trustStorePassword=password
Аутентифицируйте свой проект Firebase
Прежде чем вы сможете использовать плагин Gradle, вам необходимо аутентифицировать свой проект Firebase. Для этой лаборатории кода вы войдете в свою учетную запись Google, используя действие входа в систему плагина.
- Запустите следующую команду в корне вашего проекта Android:
~/your-android-project$ ./gradlew appDistributionLogin - Когда команда напечатает ссылку для аутентификации, откройте ее в браузере. При появлении запроса войдите в свою учетную запись Google и предоставьте разрешение на доступ к вашему проекту Firebase. Команда Gradle печатает токен обновления, который подключаемый модуль App Distribution использует для аутентификации в Firebase.
- Задайте для переменной среды
FIREBASE_TOKENтокен из предыдущего шага:~/your-android-project$ export FIREBASE_TOKEN=your_firebase_token
4. Настройте свойства пакета в Android Studio.
На этом шаге вы добавите себя в качестве тестировщика сборки, которую будете распространять позже. Как только вы распространяете сборку, тестировщики получают уведомления по электронной почте от Firebase с приглашением протестировать новую сборку.
В app/build.gradle добавьте раздел firebaseAppDistribution и включите следующие параметры:
-
appID: идентификатор вашего приложения в Firebase. Вы можете найти его на вкладке «Общие» в настройках вашего проекта . -
artifactType: тип файла вашего приложения (AAB). -
testers: адреса электронной почты ваших тестировщиков. Для этой лаборатории кода добавьте свой собственный адрес электронной почты, чтобы вы могли протестировать свою сборку после ее распространения.
Например:
android {
// ...
buildTypes {
release {
firebaseAppDistribution {
appId="yourAppId"
artifactType="AAB"
testers="your@exampleemail.com, cerseimartell.772371@email.com"
}
}
}
// ...
}
Как вариант, вы также можете переопределить значения, установленные в вашем build.gradle , передав аргументы командной строки в виде -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 .