Распространяйте приложения Android среди тестировщиков с помощью fastlane.

В этом руководстве описывается, как распространять сборки AAB среди тестировщиков с помощью fastlane — платформы с открытым исходным кодом, которая автоматизирует сборку и выпуск приложений для iOS и Android. Он следует простым инструкциям, определенным в Fastfile . После настройки fastlane и вашего Fastfile вы можете интегрировать App Distribution с вашей конфигурацией fastlane.

App Distribution интегрируется с внутренней службой обмена приложениями Google Play для обработки загружаемых вами AAB-файлов и предоставления APK-файлов, оптимизированных для конфигураций устройств ваших тестировщиков. Распространение AAB позволяет вам делать следующее:

• Запускайте оптимизированные APK-файлы (предоставляемые Google Play), оптимизированные для устройств ваших тестировщиков.

• Выявляйте и устраняйте проблемы, связанные с конкретным устройством.

• Протестируйте функции пакета приложений, такие как доставка функций Play и доставка ресурсов Play .

• Уменьшите размер загрузок для ваших тестировщиков.

Требуемые разрешения

Чтобы загрузить AAB в App Distribution , вам необходимо связать свое приложение Firebase с приложением в Google Play . Для выполнения этих действий у вас должен быть необходимый уровень доступа.

Если у вас нет необходимого доступа к Firebase, вы можете попросить владельца проекта Firebase назначить вам соответствующую роль через настройки IAM консоли Firebase . Если у вас есть вопросы о доступе к вашему проекту Firebase, включая поиск или назначение владельца, ознакомьтесь с часто задаваемыми вопросами «Разрешения и доступ к проектам Firebase» .

Следующая таблица применима к связыванию приложения Firebase с приложением в Google Play , а также к загрузке AAB.

Прежде чем начать

1. Если вы еще этого не сделали, добавьте Firebase в свой проект Android . В конце этого рабочего процесса в вашем проекте Firebase появится приложение Firebase Android.

   Если вы не используете другие продукты Firebase, вам нужно всего лишь создать проект и зарегистрировать свое приложение. Если вы решите использовать дополнительные продукты, обязательно выполните все шаги, описанные в разделе «Добавление Firebase в ваш проект Android» .

2. Чтобы создать ссылку Firebase на Google Play и загрузить файлы AAB, убедитесь, что ваше приложение соответствует следующим требованиям:

   • Приложение в Google Play и приложение Firebase для Android зарегистрированы с использованием одного и того же имени пакета.

   • Приложение в Google Play настраивается на панели приложения и распространяется на один из треков Google Play (Внутреннее тестирование, Закрытое тестирование, Открытое тестирование или Производство).

   • Проверка приложения в Google Play завершена и приложение опубликовано. Ваше приложение опубликовано, если в столбце Статус приложения отображается один из следующих статусов: Внутреннее тестирование (не черновое внутреннее тестирование), Закрытое тестирование, Открытое тестирование или Производство.

3. Свяжите свое Android-приложение Firebase со своей учетной записью разработчика Google Play:

   1. В консоли Firebase перейдите в свой settings Настройки проекта , затем выберите вкладку Интеграции .

   2. На карточке Google Play нажмите «Ссылка» .
      Если у вас уже есть ссылки на Google Play, вместо этого нажмите «Управление» .

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

   Узнайте больше о привязке к Google Play .

Шаг 1. Настройте полосу ускорения

1. Установите и настройте fastlane .

2. Чтобы добавить App Distribution в конфигурацию Fastlane, выполните следующую команду из корня вашего проекта Android:

   fastlane add_plugin firebase_app_distribution

   Если команда предложит вам вариант, выберите Option 3: RubyGems.org .

Шаг 2. Аутентификация с помощью Firebase

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

Шаг 3. Настройте Fastfile и распространите приложение.

1. На дорожке ./fastlane/Fastfile добавьте блок firebase_app_distribution . Для настройки раздачи используйте следующие параметры:

   параметры firebase_app_distribution
   app	Обязательно : идентификатор приложения Firebase вашего приложения. Идентификатор приложения можно найти в консоли Firebase на странице «Общие настройки» . app: "1:1234567890:android:0a1b2c3d4e5f67890"
   firebase_cli_token	Токен обновления, который печатается при аутентификации вашей среды CI с помощью Firebase CLI (дополнительную информацию см. в разделе Использование CLI с системами CI ).
   service_credentials_file	Путь к json-файлу вашей учетной записи службы Google. См. выше информацию о том, как пройти аутентификацию с использованием учетных данных служебной учетной записи .
   android_artifact_type	Указывает тип файла Android (APK или AAB).
   android_artifact_path	Заменяет apk_path (устарело). Абсолютный путь к файлу APK или AAB, который вы хотите загрузить. Если не указано, fastlane определяет местоположение файла по полосе, в которой файл был создан.
   release_notes release_notes_file	Примечания к выпуску для этой сборки. Вы можете указать примечания к выпуску напрямую: release_notes: "Text of release notes" Или укажите путь к текстовому файлу: release_notes_file: "/path/to/release-notes.txt"
   testers testers_file	Адреса электронной почты тестировщиков, которых вы хотите пригласить. Вы можете указать тестировщиков в виде списка адресов электронной почты, разделенных запятыми: testers: "ali@example.com, bri@example.com, cal@example.com" Или вы можете указать путь к текстовому файлу, содержащему список адресов электронной почты, разделенных запятыми: testers_file: "/path/to/testers.txt"
   groups groups_file	Группы тестировщиков, которые вы хотите пригласить (см. «Управление тестировщиками »). Группы указываются с помощью групповые псевдонимы , который вы можете найти в консоли Firebase . Вы можете указать группы в виде списка, разделенного запятыми: groups: "qa-team, trusted-testers" Или вы можете указать путь к текстовому файлу, содержащему список имен групп, разделенных запятыми: groups_file: "/path/to/groups.txt"
   test_devices test_devices_file	Следующие типы распространения являются частью бета-функции автоматического тестировщика . Тестовые устройства, на которые вы хотите распространять сборки (см. Автоматические тесты ). Вы можете указать тестовые устройства в виде списка тестовых устройств, разделенных точкой с запятой: test_devices: "model=shiba,version=34,locale=en,orientation=portrait;model=b0q,version=33,locale=en,orientation=portrait" Или вы можете указать путь к текстовому файлу, содержащему список тестовых устройств, разделенных точкой с запятой: test_devices_file: "/path/to/test-devices.txt"
   test_username	Имя пользователя для автоматического входа в систему, которое будет использоваться во время автоматических тестов .
   test_password test_password_file	Пароль для автоматического входа в систему, который будет использоваться во время автоматических тестов . Или вы можете указать путь к текстовому файлу, содержащему пароль: test_password_file: "/path/to/test-password.txt"
   test_username_resource	Имя ресурса для поля имени пользователя для автоматического входа в систему, которое будет использоваться во время автоматических тестов .
   test_password_resource	Имя ресурса для поля пароля для автоматического входа в систему, которое будет использоваться во время автоматических тестов .
   test_non_blocking	Запускайте автоматические тесты асинхронно. Посетите консоль Firebase, чтобы увидеть результаты автоматического тестирования.
   debug	Логический флаг. Вы можете установить для этого параметра true чтобы печатать подробный вывод отладки.

platform :android do
    desc "My awesome app"
    lane :distribute do
        build_android_app(task: "bundle", ...)
        # build_android_app is a built-in fastlane action.
        release = firebase_app_distribution(
            app: "1:123456789:android:abcd1234",
            testers: "tester1@company.com, tester2@company.com",
            release_notes: "Lots of amazing new features to test out!",
            android_artifact_type: "AAB"
        )
    end
end

fastlane <lane>

lane :increment_version do
  latest_release = firebase_app_distribution_get_latest_release(
    app: "<your Firebase app ID>"
  )
  increment_version_code({ version_code: latest_release[:buildVersion].to_i + 1 })
end

# Use lanes to add or remove testers from a project.
lane(:add_testers) do
  firebase_app_distribution_add_testers(
    emails: "foo@google.com,bar@google.com"
    # or file: "/path/to/testers.txt"
    group_alias: "qa-team" # (Optional) add testers to this group
  )
end

lane(:remove_testers) do
  firebase_app_distribution_remove_testers(
    emails: "foo@google.com,bar@google.com"
    # or file: "/path/to/testers.txt"
    group_alias: "qa-team" # (Optional) remove testers from this group only
  )
end

# Add or remove testers with the terminal
$ fastlane add_testers
$ fastlane remove_testers

fastlane run firebase_app_distribution_create_group display_name:"QA Team" alias:"qa-team"
fastlane run firebase_app_distribution_add_testers group_alias:"qa-team" emails:"foo@google.com,bar@google.com"
fastlane run firebase_app_distribution_remove_testers group_alias:"qa-team" emails:"foo@google.com,bar@google.com"
fastlane run firebase_app_distribution_delete_group alias:"qa-team"

app: "1:1234567890:android:0a1b2c3d4e5f67890"