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

image10.png

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

Что ты узнаешь

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

Что тебе понадобится

  • Android Studio версии 4.0 +
  • Подписанный файл пакета, созданный вами в Android Studio.
  • Учетная запись разработчика Google Play, владельцем или администратором которой вы являетесь.
  • Ваше приложение в Google Play является установка на Play приложение панели Google , и она имеет следующий статус :
    • Приложение находится в опубликованном состоянии, а это означает , что он не в проекте , и его рассмотрение завершено (столбец Состояние обновления в Google Play консоли пуста).
    • Приложение распространяется на одном из следующих треков Google Play: внутреннее тестирование, закрытое, открытое тестирование или производство.
  • Адрес электронной почты, который вы можете использовать в качестве тестировщика для получения приглашений на новую сборку от 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 нет SDK Firebase для добавления в ваше приложение.
  4. Нажмите Продолжить , чтобы утешить.
  1. В Firebase консоли перейдите в настройки проекта.

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

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

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

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

  1. В вашем проектном уровне Gradle файл ( android/build.gradle ), добавьте App Distribution Gradle плагин и репозиторий Maven Google.
    buildscript {
        repositories {
            // Check that you have Google's Maven repository (if not, add it).
            google()
            jcenter()
        }
        dependencies {
            // Add the App Distribution Gradle plugin
            classpath `com.google.firebase:firebase-appdistribution-gradle:2.1.2`
        }
    }
    
  2. В вашем приложении уровень Gradle файл ( android/app/build.gradle ), добавьте App плагина распространения:
    apply plugin: `com.android.application`
    
    // ...
    
    // Apply the App Distribution Gradle plugin
    apply plugin: `com.google.firebase.appdistribution`
    
    // ...
    
  3. Если вы находитесь за корпоративный прокси - сервер или брандмауэр, добавьте следующую Java системное свойство , которое позволяет App Distribution загружать распределяла 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 печатает токен обновления, который плагин распространения приложений использует для аутентификации с помощью Firebase.
  3. Установите переменные окружения FIREBASE_TOKEN в маркер из предыдущего шага:
    ~/your-android-project$ export FIREBASE_TOKEN=your_firebase_token
    

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

В вашем app/build.gradle , добавьте firebaseAppDistribution раздел и включают в себя следующие параметры:

  • appID : Ваше приложение в Firebase App ID. Вы можете найти его в закладке Общие в настройках проекта.
  • 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 .

  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
    

Теперь тестировщики будут получать по электронной почте приглашения загрузить и протестировать сборку. Как разработчик, вы можете контролировать сборку на вкладке Релизы приборной панели распределения App.

В этом разделе вы будете настроены в качестве тестировщика, чтобы загрузить распространяемую вами версию. Как тестировщик, вам необходимо аутентифицировать свое тестовое устройство и включить внутренний общий доступ к приложению в приложении Google Play Store.

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

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

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

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

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

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