fastlane を使用して iOS アプリをテスターに配布する

iOS アプリと Android アプリのビルドとリリースを自動化するオープンソースプラットフォームである fastlane を使用して、ビルドをテスターに配布できます。この配布は、Fastfile で定義されたシンプルな手順に従います。fastlane と Fastfile を設定したら、App Distribution と fastlane の構成を統合できます。

手順 1. fastlane を設定する

fastlane をインストールして設定します。
fastlane の構成に App Distribution を追加するには、iOS プロジェクトのルートから次のコマンドを実行します。
```
fastlane add_plugin firebase_app_distribution
```
コマンドでオプションの選択を求めるプロンプトが表示されたら、Option 3: RubyGems.org を選択します。

手順 2. Firebase で認証する

fastlane プラグインを使用する前に、Firebase プロジェクトで認証する必要があります。これには次の 3 つの方法があります。

プラグインのログイン操作で Google アカウントにログインする

次のコマンドを実行します。
```
bundle exec fastlane run firebase_app_distribution_login
```
このコマンドにより、認証用のリンクが生成されます。
このリンクをブラウザで開きます。
プロンプトが表示されたら、Google アカウントにログインし、Firebase プロジェクトにアクセスするための権限を付与します。生成されたコードをログインブラウザからコピーして、コマンドラインに貼り付けます。ログイン操作により更新トークンが生成されます。App Distribution プラグインは、このトークンを使用して Firebase の認証を行います。
後で Fastfile を設定するときに firebase_cli_token パラメータを使用するか、FIREBASE_TOKEN 環境変数を設定することにより、前の手順のトークンをプラグインに渡します。
```
export FIREBASE_TOKEN=token
```

Firebase サービスアカウントの認証情報を使用する

サービスアカウントで認証すると、継続的インテグレーション（CI）システムでプラグインを柔軟に使用できます。サービスアカウントの認証情報を指定するには、次の 2 つの方法があります。

サービスアカウントのキーファイルを firebase_app_distribution 操作に渡します。この方法は、ビルド環境にすでにサービスアカウントのキーファイルがある場合に便利です。
サービスアカウントのキーファイルを指すように環境変数 GOOGLE_APPLICATION_CREDENTIALS を設定します。この方法は、すでに他の Google サービス（Google Cloud など）でアプリケーションのデフォルト認証情報（ADC）を構成している場合に便利です。

Google Cloud Console でプロジェクトを選択し、新しいサービスアカウントを作成します。
Firebase App Distribution 管理者のロールを追加します。
json 秘密鍵を作成し、ビルド環境からアクセスできる場所にキーを移動します。このファイルは安全な場所に保管してください。管理者が Firebase プロジェクトの App Distribution にアクセスするために、このファイルが必要になります。
（2019 年 9 月 20 日以降にアプリを作成した場合はこの手順を省略します）Google API Console で、Firebase App Distribution API を有効にします。プロンプトが表示されたら、Firebase プロジェクトと同じ名前のプロジェクトを選択します。
サービスアカウントの認証情報を指定するか、またはその場所を指定します。
1. サービスアカウントキーをレーンの firebase_app_distribution 操作に渡すには、service_credentials_file パラメータに秘密鍵の JSON ファイルのパスを設定します。
2. ADC で認証情報の場所を指定するには、環境変数 GOOGLE_APPLICATION_CREDENTIALS を秘密鍵の JSON ファイルのパスに設定します。次に例を示します。
```
 export GOOGLE_APPLICATION_CREDENTIALS=/absolute/path/to/credentials/file.json
```
  ADC での認証の詳細については、アプリケーションの認証情報を指定するをご覧ください。

Firebase CLI を使用してログインする

プロジェクトの認証方法については、Firebase CLI によるログインをご覧ください。

手順 3. Fastfile を設定してアプリを配布する

./fastlane/Fastfile のレーンに firebase_app_distribution ブロックを追加します。次のパラメータを使用して、配布を構成します。

firebase_app_distribution のパラメータ
`app`	アプリに Firebase 構成ファイル（`GoogleService-Info.plist`）が含まれていない場合にのみ必要: アプリの Firebase アプリ ID。アプリ ID は Firebase コンソールの全般設定ページで確認できます。 app: "1:1234567890:ios:0a1b2c3d4e5f67890"
`googleservice_info_plist_path`	`GoogleService-Info.plist` ファイルのパス（アーカイブしたプロダクトのパスからの相対パス）。デフォルトでは `GoogleService-Info.plist` に設定されています。 `app` パラメータが指定されていない場合は、このファイルを使用してアプリの Firebase アプリ ID を取得します。
`firebase_cli_token`	プラグインのログイン操作の実行時に出力される更新トークン（上記の Google アカウントを使用して認証するをご覧ください）、または Firebase CLI を使用して CI 環境を認証するときに出力される更新トークン（詳細については CI システムで CLI を使用するをご覧ください）。
`service_credentials_file`	Google サービスアカウントの JSON ファイルのパス。上記のサービスアカウント認証情報を使用して認証する方法をご覧ください。
`ipa_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:ios:abcd1234",
            testers: "tester1@company.com, tester2@company.com",
            release_notes: "Lots of amazing new features to test out!"
        )

    end
end

最後に、テスターがビルドを利用できるようにするためにレーンを実行します。
```
fastlane <lane>
```

ビルドを配布すると、Firebase コンソールの App Distribution ダッシュボードで 150 日間（5 か月間）利用できます。ビルドが期限切れになる 30 日前に、テストデバイス上のテスターのビルドリストとコンソールの両方に有効期限のお知らせが表示されます。

アプリのテストに招待されていないテスターには、開始するための招待メールが届きます。既存のテスターには、新しいビルドのテスト準備ができていることを知らせるメールが届きます（テストアプリのインストール手順についてはテスターの設定ガイドをご覧ください）。Firebase コンソールで各テスターのステータス（招待を承諾したか、アプリをダウンロードしたか）を確認できます。