Распространение выпусков пакета приложений среди тестировщиков - Codelab

1. Обзор

изображение10.png

В этой лабораторной работе вы узнаете, как распространять выпуски Android App Bundle среди тестировщиков с помощью Firebase App Distribution и его плагина Gradle. Распространение приложений предоставляет вам центральный центр управления предварительными версиями вашего приложения и тестировщиками, которых вы приглашаете для каждого выпуска.

Что вы узнаете

  • Как связать ваше приложение Firebase с Google Play
  • Как упаковать и собрать приложение в виде пакета приложений
  • Как создать релиз и поделиться им с живыми тестировщиками
  • Как загружать и тестировать новые выпуски в качестве тестировщика

Что вам понадобится

  • Последняя версия Android Studio
  • Подписанный файл пакета, созданный вами в Android Studio.
  • Аккаунт разработчика Google Play, владельцем или администратором которого вы являетесь.
  • Ваше приложение в Google Play настроено на панели управления приложением Google Play и имеет следующий статус :
    • Приложение распространяется по одному из треков Google Play (Внутреннее тестирование, Закрытое тестирование, Открытое тестирование или Производство).
    • Проверка приложения в Google Play завершена и приложение опубликовано. Ваше приложение опубликовано, если в столбце Статус приложения отображается один из следующих статусов: Внутреннее тестирование (не черновое внутреннее тестирование), Закрытое тестирование, Открытое тестирование или Производство.
  • Адрес электронной почты, который вы можете использовать в качестве тестировщика для получения приглашений на новую сборку от Firebase.

2. Создайте проект Firebase.

  1. Войдите в Firebase .
  2. В консоли Firebase нажмите «Добавить проект» и назовите свой проект «AppBundlesCodelab». Запомните идентификатор вашего проекта Firebase. Если вы не измените идентификатор проекта, Firebase автоматически присвоит уникальный идентификатор вашему проекту.

    image8.png
  3. (Необязательно) При появлении запроса включите Google Analytics.
  4. Выполните оставшиеся шаги, затем нажмите «Создать проект» .

Добавьте пакет приложений в проект

  1. В консоли Firebase нажмите «Добавить приложение» .

    image5.png
  2. При регистрации приложения обязательно используйте то же имя пакета , что и у приложения, загруженного в вашу учетную запись разработчика Google Play. Наконец, нажмите «Зарегистрировать приложение» .
  3. Выполните оставшиеся шаги, чтобы добавить файл конфигурации Firebase вашего приложения ( google-services.json ) в ваше приложение. Обратите внимание, что для Android у App Distribution нет Firebase SDK, который можно добавить в ваше приложение.
  4. Нажмите «Продолжить работу с консолью» .
  1. В консоли Firebase перейдите в настройки проекта .

    изображение2.png
  2. На вкладке «Интеграции» нажмите «Ссылка» на карточке Google Play .
  3. Следуйте инструкциям на экране, чтобы включить интеграцию с распространением приложений, затем выберите только что созданное приложение Firebase, чтобы связать его с Google Play.

Теперь, когда вы выполнили эти шаги, ваше приложение Firebase будет связано с вашим приложением в вашей учетной записи разработчика Google Play, если имена пакетов приложений совпадают.

3. Добавьте распространение приложений в свой проект.

Добавьте плагин Gradle для распространения приложений.

Теперь вы будете использовать Android Studio, чтобы добавить в свое приложение App Distribution и его плагин Gradle.

  1. В файле Gradle уровня проекта ( android/build.gradle.kts ) добавьте плагин Gradle App Distribution в блок plugins .
    plugins {
         //...
    
         // Add the App Distribution Gradle plugin
         id("com.google.firebase.appdistribution") version "4.0.0" apply false
    }
    
  2. В файле настроек Gradle на уровне проекта ( android/settings.gradle.kts ) добавьте репозиторий Google Maven в блок pluginManagement .
     pluginManagement {
         // Check that you have Google's Maven repository (if not, add it).
         repositories {
             google()
             mavenCentral()
         }
     }
    
  3. В файле Gradle уровня приложения ( android/app/build.gradle.kts ) добавьте плагин App Distribution в блок plugins .
    plugins {
         //...
    
         // Add the App Distribution plugin
         id("com.google.firebase.appdistribution")
    }
    
  4. Если вы используете корпоративный прокси-сервер или брандмауэр, добавьте следующее системное свойство Java, которое позволит App Distribution загружать ваши дистрибутивы в 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. Сборка и распространение релиза

  1. Запустите задачу bundle Variant Gradle, чтобы создать файл пакетов приложений:
    $ ./gradlew :base:bundleRelease
    
  2. Найдите пакет в каталоге сборки вашего приложения (по умолчанию — app/build/outputs/bundle/release ).
  3. Чтобы распространить выпуск, создайте целевые объекты 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.

  1. На тестовом устройстве войдите в свою учетную запись электронной почты тестера и откройте приглашение от Firebase.

    изображение6.png
  2. Войдите в свою учетную запись Google и примите приглашение протестировать распространяемую версию. В качестве опции вы также можете скачать Firebase App Tester , который предотвращает добавление загруженных выпусков в папку Downloads вашего устройства. Он также отображает дополнительную информацию о выпусках, например ход загрузки и версию выпуска.

    изображение9.png
  3. Нажмите «Загрузить» рядом с выпуском, чтобы установить его из Play Store.
  4. При появлении запроса выполните оставшиеся шаги, чтобы включить внутренний общий доступ к приложениям (инструкции отображаются на тестовом устройстве, и их необходимо выполнить только один раз).

После завершения загрузки ваш выпуск автоматически появится в виде ярлыка на главном экране вашего устройства.

7. Поздравляем!

Вы только что использовали Firebase App Distribution, чтобы загрузить пакет приложений и распространить выпуск среди тестировщиков.

Следующие шаги