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

1. Обзор

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

В этой лабораторной работе вы узнаете, как распространять выпуски 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

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

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

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

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

    изображение5.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 в качестве зависимостей buildscript к вашему приложению.

  1. В файле 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`
        }
    }
    
  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`
    
    // ...
    
  3. Если вы находитесь за корпоративным прокси-сервером или брандмауэром, добавьте следующее системное свойство Java, которое позволяет службе распространения приложений загружать ваши дистрибутивы в Firebase:
    -Djavax.net.ssl.trustStore=/path/to/truststore -Djavax.net.ssl.trustStorePassword=password
    

Аутентифицируйте свой проект Firebase

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

  1. Запустите следующую команду в корне вашего проекта Android:
    ~/your-android-project$ ./gradlew appDistributionLogin
    
  2. Когда команда напечатает ссылку для аутентификации, откройте ее в браузере. При появлении запроса войдите в свою учетную запись Google и предоставьте разрешение на доступ к вашему проекту Firebase. Команда Gradle печатает токен обновления, который подключаемый модуль App Distribution использует для аутентификации в Firebase.
  3. Задайте для переменной среды 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. Создайте и распространите выпуск

  1. Запустите задачу bundle Variant , чтобы создать файл пакетов приложений:
    $ ./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 для загрузки набора приложений и распространения версии среди тестировщиков.

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