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

テスターにビルドを配布するには Firebase CLI を使用します。CLI ツールを使用すると、ビルドのテスターとリリースノートを指定し、ビルドを配布できます。

始める前に

まだ Firebase を iOS プロジェクトに追加していない場合は追加します。

注意: Firebase にアプリを登録する際に入力するバンドル ID は、配布するアプリと同じにしてください。バンドル ID の値は大文字と小文字が区別されます。Firebase プロジェクトに登録された後、Firebase でアプリのバンドル ID を変更することはできません。

他の Firebase プロダクトを使用していない場合は、プロジェクトを作成してアプリを登録するだけでかまいません。ただし、今後追加のプロダクトを使用する場合は、上記のリンク先のページのステップをすべて完了してください。

ステップ 1. アプリをビルドする

アプリのプレリリース版をテスターに配布する準備が整ったら、署名付きの配布用アーカイブを作成します。以下の要件を満たしていれば、通常のビルドプロセスを使用できます。

• 開発チーム以外にアプリを配布するには、Ad Hoc または Enterprise のいずれかの配布プロファイルを使用する必要があります。
  注: iOS アプリケーション（エンタープライズ署名アプリも含まれる）を配布する場合は、Apple が定めるデベロッパー ポリシーと利用規約を遵守する必要があります。
• アプリで Game Center、APNs（さらに Cloud Messaging）、iCloud を使用する場合は、プロビジョニング プロファイルでワイルドカード ID ではなく、明示的なアプリ ID を使用する必要があります。
• Ad Hoc 配布プロファイルを使用する場合は、テスターのデバイスに固有のデバイス ID（UDID）を含める必要があります。新しい iOS テスターがテスト プログラムに登録されるたびに、プロビジョニング プロファイルを更新し、テスターのデバイスの UDID を追加する必要があります。追加のテスター デバイスの登録をご覧ください。
• 前回のビルド以降にコードを変更した場合（つまり、登録済みデバイスの更新のみを目的として再ビルドするのではない場合）、ビルド ターゲットでユーザーに表示されるバージョン番号（Version）と一意のビルド番号（Build）を更新します。

ビルドが完了すると、指定したフォルダに IPA ファイルと一部のログファイルが保存されます。次のステップで、IPA ファイルをテスターに配布します。

ステップ 2. テスターにアプリを配布する

テスターにアプリを配布するには、Firebase CLI を使用して IPA ファイルをアップロードします。

1. Firebase CLI の最新バージョンをインストールするか、最新バージョンに更新します（ご使用の OS 固有の CLI のスタンドアロン バイナリをダウンロードすることをおすすめします）。ログインして、プロジェクトにアクセスできることを確認してください。
   注: CI 環境で Firebase CLI を使用している場合は、サービス アカウントまたは login:ci で認証を行うこともできます。
2. Firebase コンソールの App Distribution ページで、配布するアプリを選択し、[開始] をクリックします。

3. appdistribution:distribute コマンドを実行してアプリをアップロードし、テスターに配布します。次のパラメータを使用して配布を構成します。

   appdistribution:distribute オプション
   --app	必須: アプリの Firebase アプリ ID。アプリ ID は Firebase コンソールの全般設定ページで確認できます。 --app 1:1234567890:ios:0a1b2c3d4e5f67890
   --token	Firebase CLI を使用して CI 環境を認証するときに出力される更新トークン（詳細については CI システムで CLI を使用するをご覧ください）。 --token "$FIREBASE_TOKEN"
   --release-notes --release-notes-file	このビルドのリリースノート。 リリースノートを直接指定します。 --release-notes "Text of release notes" または、プレーン テキスト ファイルのパスを指定します。 --release-notes-file "/path/to/release-notes.txt"
   --testers --testers-file	招待するテスターのメールアドレス。 メールアドレスのカンマ区切りのリストとしてテスターを指定します。 --testers "[e-mail], [e-mail], [e-mail]" または、メールアドレスのカンマ区切りのリストを含む書式なしテキスト ファイルへのパスを指定します。 --testers-file "/path/to/testers.txt"
   --groups --groups-file	招待するテスター グループ（テスターを管理するをご覧ください）。グループはグループ エイリアスで指定します。これは、Firebase コンソールで検索できます。 グループをカンマ区切りのリストとして指定します。 --groups "qa-team, trusted-testers" または、グループ名のカンマ区切りのリストを含む書式なしテキスト ファイルのパスを指定します。 --groups-file "/path/to/groups.txt"
   --debug	詳細なログを出力するためのフラグ。

   例:

   firebase appdistribution:distribute test.ipa  \
       --app 1:1234567890:ios:0a1b2c3d4e5f67890  \
       --release-notes "Bug fixes and improvements" --testers-file testers.txt
   

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

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

ステップ 3. 追加のテスター デバイスを登録する

招待を受け入れたテスターが、Enterprise プロファイルを使用して未署名のビルドをテストしようとすると、デバイスの UDID を共有するかどうか確認されます。テスターが同意すると、App Distribution はデバイスから UDID を収集し、新しく共有された UDID をメールで通知します。

このようなメールが届いたら、次のステップに従ってプロビジョニング プロファイルを更新して UDID を追加し、新しいビルドをテスターに配布します。

1. Apple Developer ポータルの Add Devices ページで、受信したメールに記載されている新しい UDID を登録します。
2. iOS Provisioning Profiles ページで、登録済みのデバイスをプロビジョニング プロファイルに追加します。
3. プロビジョニング プロファイルをダウンロードし、このプロファイルでアプリを再ビルドします。登録済みデバイスの更新だけを目的に再ビルドする場合は、ビルド番号またはバージョンを更新しないでください。
4. Firebase コンソールまたは CLI からアプリを再配布します。同じビルド番号とバージョンのビルドをすでに配布している場合は、新しく登録されたデバイスのユーザーだけに通知メールが送信されます。