Check out what’s new from Firebase@ Google I/O 2021, and join our alpha program for early access to the new Remote Config personalization feature. Learn more

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

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

Шаг 1 . Настроить скоростную полосу

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

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

    fastlane add_plugin firebase_app_distribution

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

Шаг 2 . Аутентифицироваться с Firebase

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

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

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

    параметры firebase_app_distribution
    app

    Требуется только в том случае, если ваше приложение не содержит файл конфигурации Firebase ( GoogleService-Info.plist ) : идентификатор приложения Firebase вашего приложения. Вы можете найти идентификатор приложения в консоли Firebase на странице общих настроек .

    app: "1:1234567890:ios:0a1b2c3d4e5f67890"
    googleservice_info_plist_path

    Путь к вашему GoogleService-Info.plist относительно пути к заархивированному продукту. По умолчанию установлено значение GoogleService-Info.plist .

    Файл используется для получения идентификатора приложения Firebase, если параметр app не указан.

    firebase_cli_token

    Токен обновления, который печатается, когда вы запускаете действие входа в плагин (см. Аутентификация с использованием учетной записи Google выше) или когда вы аутентифицируете свою среду CI с помощью интерфейса командной строки Firebase (дополнительные сведения см. В разделе Использование интерфейса командной строки с системами CI ).

    service_credentials_file

    Путь к json-файлу вашей учетной записи службы Google. См. Выше, как пройти аутентификацию с использованием учетных данных учетной записи службы .

    ipa_path

    Заменяет apk_path (устарело). Абсолютный путь к файлу IPA, который вы хотите загрузить. Если не указано, 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"
    debug

    Логический флаг. Вы можете установить значение true для вывода подробных отладочных данных.

    Например:

    platform :ios do
        desc "My awesome app"
        lane :distribute do
            build_ios_app(...)
            # build_ios_app is a built-in fastlane action.
    
            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!"
            )
    
        end
    end
    
  2. Наконец, чтобы сделать сборку доступной для тестировщиков, запустите дорожку:

    fastlane <lane>
    .

После распространения сборки она становится доступной на панели управления распространением приложений консоли Firebase в течение 150 дней (пяти месяцев). Когда срок действия сборки истекает через 30 дней, уведомление об истечении срока действия появляется как в консоли, так и в списке сборок вашего тестировщика на их тестовом устройстве.

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