このページは Cloud Translation API によって翻訳されました。

App Distribution と fastlane を使用して、プレリリース版の iOS ビルドを迅速に配布する

1. 始める前に

この Codelab では、Firebase App Distribution とその fastlane プラグインを使用して、iOS アプリをテスターに配布し、テストデバイスの UDID を収集してアプリのプロビジョニングプロファイルに登録する方法を学びます。これにより、アドホックビルドをテスターに迅速に提供できます。

学習内容

Firebase App Distribution と fastlane を使用して、プレリリース版の iOS アプリ（アドホック）をテスターにアップロードして配布する方法。
テスターとして登録し、テストデバイスに配布されたアプリをダウンロードする方法。
App Distribution の fastlane プラグインを使用してテストデバイスの UDID をエクスポートし、テストデバイスをすばやく登録する方法。
アプリのプロビジョニングプロファイルを更新して、配信用に再アップロードする方法。

必要なもの

Google アカウント
XCode 11.7 以降がインストールされている Apple マシン
Xcode でビルドされたアドホックプレリリース版 iOS アプリ
有料の Apple Developer アカウント
テスト用の物理 iOS デバイス。

iOS シミュレータアプリは Codelab のほとんどで動作しますが、シミュレータはリリースをダウンロードできません。

App Distribution テスターウェブアプリに [ダウンロード] ボタンが表示されることを確認することで、設定が機能していることを確認できます。

2. 使ってみる

fastlane を設定する

App Distribution は fastlane と統合して、アプリのプレリリース版ビルドの配布を自動化できるようにします。App Distribution は fastlane の構成と統合されます。

fastlane をインストールして設定します。
設定中にプロジェクトのルートディレクトリで fastlane init を実行し、[手動設定] を選択します。fastlane というサブディレクトリが表示されます。このサブディレクトリには、fastlane の構成に使用する Fastfile、Appfile、Pluginfile が含まれています。

Firebase CLI をインストールする

Firebase CLI もインストールする必要があります。macOS または Linux を使用している場合は、次の cURL コマンドを実行できます。

curl -sL https://firebase.tools | bash

Windows を使用している場合は、インストール手順を参照して、スタンドアロンバイナリを取得するか、npm を介してインストールしてください。

CLI をインストールしたら、firebase --version を実行すると、12.0.0 以降のバージョンが報告されます。

$ firebase --version
12.0.0

3. fastlane を使用してアプリをビルドする

アプリをビルドする

./fastlane/Appfile. で fastlane のグローバル変数を設定します。アプリの ID と Apple ID を含めます。

app_identifier("<your app's bundle identifier>")
apple_id("<your Apple id>")

最初のレーンを作成し、fastlane の build_app アクション（gym とも呼ばれます）を使用して、./fastlane/Fastfile に以下を追加してアプリをビルドします。

default_platform(:ios)

lane :build do
    build_app(export_method: "ad-hoc")
end

配布用にアプリに署名します。

この Codelab では、get_certificates（cert とも呼ばれます）を使用して独自の認証とプロファイルを管理します。これにより、署名証明書がローカルで生成され、すべてが macOS のキーチェーンに保存されます。ただし、通常は fastlane sync_code_signing action（match とも呼ばれます）を使用して、チームのコード署名証明書とプロファイルを安全に管理します。

lane :build do
    get_certificates()
    build_app(export_method: "ad-hoc")
end

get_provisioning_profile アクション（sigh とも呼ばれます）を使用して、アプリのプロビジョニングプロファイルを設定します。これにより、アプリをテスターと共有できるようになります。

lane :build do
    get_certificates()
    get_provisioning_profile(adhoc: true)
    build_app(export_method: "ad-hoc")
end

[省略可] アプリをまだ実行したことがない場合は、次のコマンドを実行して Apple Developer コンソールでアプリを作成します。

$ fastlane produce --skip_itc

最後に、レーンを実行してアプリをビルドします。

Apple ID、パスワード（キーチェーンに保存されている）、アプリのバンドル ID の入力を求められます。

$ fastlane build

問題が発生した場合は、fastlane のトラブルシューティングガイドをご覧ください。

4. アプリを Firebase にアップロードする

アプリをビルドしたので、App Distribution にアップロードする準備が整いました。

Firebase プロジェクトを作成して設定する

Firebase にログインします。
Firebase コンソールで、新しいプロジェクトを作成または追加し、プロジェクトに「UDID Export Codelab」という名前を付けます。

このプロジェクトでは Google アナリティクスを有効にする必要はありません。

[プロジェクトの作成] をクリックします。

iOS アプリをプロジェクトに追加する

iOS アイコンをクリックして新しい Firebase iOS アプリを作成し、アプリのバンドル ID を入力します。

次の数個の手順はスキップして、[コンソールに進む] をクリックします。SDK は後でアプリに追加します。

これで、プロジェクトとアプリが [プロジェクトの概要] ページに表示されます。

App Distribution を有効にする

[リリースとモニタリング] セクションで、[アプリの配布] をクリックします。
利用規約に同意したら、[使ってみる] をクリックしてアプリの App Distribution を有効にします。

fastlane で配信を設定する

iOS プロジェクトのルートから次のコマンドを実行して、fastlane の構成に App Distribution を追加します。

コマンドでオプションの選択を求めるプロンプトが表示されたら、Option 3: RubyGems.org を選択します。

$ fastlane add_plugin firebase_app_distribution

プラグインがインストールされていることを確認します。

$ fastlane

出力には、インストールされているプラグインのリストに fastlane-plugin-firebase_app_distribution が表示されます。

プラグインがインストールされていることを確認したら、オプション 0 を選択してキャンセルします。

Firebase プロジェクトを認証する

fastlane プラグインを使用するには、まず Firebase プロジェクトを認証します。

次のコマンドを実行して、CLI を Google アカウントに接続します。

$ firebase login

コマンドで認証リンクが生成されたら、そのリンクをブラウザで開きます。
プロンプトが表示されたら、Google アカウントにログインし、Firebase プロジェクトにアクセスするための権限を付与します。

アプリを配布する

これで、アプリを配布する準備が整いました。

./fastlane/Fastfile の上部で、firebase_app_id という名前の変数を定義します。<your_app_id> は、作成したアプリの Firebase アプリ ID に置き換えます（この ID はプロジェクト設定ページで確認できます）。

Fastfile は Ruby で記述されているため、Ruby 構文を使用して変数を定義します。

firebase_app_id = "<your_app_id>"

ビルドレーンを呼び出し、firebase_app_distribution アクションを使用してアプリを配布する distribute という新しいレーンを追加します。

lane :distribute do
    build
    firebase_app_distribution(
        app: firebase_app_id,
        release_notes: "Try out this app!",
    )
end

新しいレーンを実行してアプリをビルドし、配布を作成します。

$ fastlane distribute

この時点で、Fastfile は次のようになります。

firebase_app_id = "<your Firebase app ID>"

default_platform(:ios)

lane :build do
    get_certificates()
    get_provisioning_profile(adhoc: true)
    build_app(export_method: "ad-hoc")
end

lane :distribute do
    build
    firebase_app_distribution(
        app: firebase_app_id,
        release_notes: "Try out this app!",
    )
end

Firebase コンソールを更新すると、アプリの新しいリリースが表示されます。

5. テスターを招待してアプリをダウンロードしてもらう

テスターがアドホックビルドのテストへの招待を承諾する場合は、UDID を共有するかどうか確認されます。テスターが同意すると、App Distribution はデバイス情報を収集し、メールで通知します。このセクションでは、配布したアプリをダウンロードしてテストするために、テスターとして自分自身を追加します。

リリースにテスターとして自分を追加する

Fastfile の上部にある firebase_app_id の下に、テスターを保持する変数を作成し、自分のメールアドレスと、試したいその他のメールアドレス（省略可）を含めます。

firebase_app_id = "<your Firebase app ID>"
app_testers = [
  "your@email.com",
  "another@email.com",
]

Ruby の Array#join メソッドを適用して、app_testers 配列をカンマ区切りの文字列に変換します。これは testers パラメータが想定している形式です。次に、結果を firebase_app_distribution. の testers パラメータに渡します。

lane :distribute do
    build
    firebase_app_distribution(
        app: firebase_app_id,
        release_notes: "Try out this app!"
        testers: app_testers.join(","),
    )
end

この時点で、Fastfile は次のようになります。

firebase_app_id = "<your Firebase app ID>"
app_testers = [
  "your@email.com",
  "another@email.com",
]

default_platform(:ios)

lane :build do
    get_certificates()
    get_provisioning_profile(adhoc: true)
    build_app(export_method: "ad-hoc")
end

lane :distribute do
    build
    firebase_app_distribution(
        app: firebase_app_id,
        release_notes: "Try out this app!",
        testers: app_testers.join(","),
    )
end

レーンを再度実行します。

$ fastlane distribute

レーンを実行すると、追加したテスターに App Distribution から招待メールが届き、新しいリリースが利用可能になったことが通知されます。Firebase コンソールで、アプリのリリースに追加したテスターを確認できるようになりました。

メールアドレスを含めたので、Firebase App Distribution からアプリのテストに招待するメールが届きます。これで、最初のテスターになりました。テストデバイスでテスターとして設定するには、以下のセクションに進んでください。

テストデバイスを登録する

テスターとして、テストに招待されたアプリのリリースにアクセスするには、テストデバイスで Google にログインする必要があります。テストビルドはアドホックリリースであるため、Firebase プロファイルをインストールしてテストデバイスも登録する必要があります。その後、利用可能になったリリースには、デバイスのホーム画面に追加されたウェブクリップを使用して、App Distribution テスターウェブアプリからアクセスできます。

iOS テストデバイスで、Firebase App Distribution から送信されたメールを開き、[使ってみる] リンクをタップします。リンクは必ず Safari で開いてください。
App Distribution テスターウェブアプリが表示されます。表示されたページで、Google アカウントでログインし、[招待を承諾] をタップします。

招待されたリリースが表示されるようになりました。いずれかのリリースで [Register device] をタップします。

プロンプトが表示されたら、Firebase プロファイルをダウンロードし、設定アプリにインストールします。

プロファイルをインストールすると、Firebase に次の権限が付与されます。

デバイスの一意のデバイス ID（UDID）を収集して、テストデバイスを登録する。

Firebase プロジェクトのオーナーと編集者全員に、テストデバイスの UDID が記載されたメールが Firebase から送信されます。

テストデバイスのホーム画面にウェブクリップをインストールします。ウェブクリップを開くと、App Distribution テスターウェブアプリが開き、すべてのテスト用アプリをインストールしてアクセスできるようになります。

App Distribution テスターウェブアプリで、テストデバイスがアプリのリリースに登録されました。

テストデバイスの UDID を Firebase に共有したので、デベロッパーとして続行できます。App Distribution ダッシュボードの [テスター] タブに、アプリのリリースとともにテスターの情報が表示され、ステータスが [承認済み] になっています。

次のセクションでは、デバイスの UDID をアプリのプロビジョニングプロファイルに追加し、テストデバイスで動作するアプリのバージョンをビルドします。

テスターデバイスの UDID をエクスポートする

デベロッパーには、テストデバイスの UDID が記載されたメールが Firebase から届きます。App Distribution では、Firebase コンソールから直接、複数の新しいデバイスの UDID を一度に収集して、未加工のテキストファイルとしてエクスポートすることもできます。

すべての UDID をエクスポートするには、[テスターとグループ] タブを開きます。

[Apple UDID をエクスポート] をクリックします。

このファイルには、テストデバイスの UDID が含まれている必要があります。

Device ID            Device Name                            Device Platform
1234567890     udid.codelab.tester@gmail.com - iPhone SE 2nd Gen        ios

UDID は、次のセクションで説明するように、fastlane を使用してコマンドラインからエクスポートすることもできます。

6. アプリのプロビジョニングプロファイルを更新して再ビルドする

次に、テストデバイスの UDID をアプリのプロビジョニングプロファイルに追加し、デバイスで動作するアプリのバージョンを再ビルドして、新しいバージョンを配布します。

UDID エクスポートのレーンを追加

Fastfile の先頭に別の変数を追加し、テスターのデバイスの UDID がダウンロードされるファイルパスに設定します。

firebase_app_id = "<your Firebase app ID>"
app_testers = [
  "your@email.com",
  "another@email.com",
]
tester_udids_file = "tester_udids.txt"

コンソールから行ったのと同じように、App Distribution プラグインの UDID エクスポートアクションを使用してテスターの UDID をダウンロードする新しいレーンを設定します。

lane :download_udids do
    firebase_app_distribution_get_udids(
        app: firebase_app_id,
        output_file: tester_udids_file,
    )
end

次のレーンを実行して UDID をダウンロードします。

$ fastlane download_udids

ダウンロードしたファイル（テストデバイスの UDID が含まれているはずです）を印刷します。

$ cat tester_udids.txt

Apple デベロッパーコンソールにデバイスを追加する

次のレーンを作成して、Apple デベロッパーコンソールのデバイスリストに UDID を追加します。これにより、fastlane の register_devices アクションを使用してプロビジョニングプロファイルに追加できます。

lane :add_new_devices do
    register_devices(devices_file: tester_udids_file)
end

次に、レーンを実行します。

$ fastlane add_new_devices

デベロッパーコンソールのデバイスリストに新しいデバイスが表示されます。

プロビジョニングプロファイルにデバイスを追加する

build レーンのプロビジョニングプロファイルステップに force 引数を追加して、ビルドするたびに新しいデバイスを強制的に選択するようにします。

lane :build do
    get_certificates()
    get_provisioning_profile(adhoc: true, force: true)
    build_app(export_method: "ad-hoc")
end

レーンを再実行してビルドとアップロードを行う

次に、新しいレーンで distribute レーンを更新して、デバイスをプロビジョニングプロファイルに追加し、アプリを再ビルドして配布します。

distribute から新しいレーンを呼び出します。

lane :distribute do
    download_udids
    add_new_devices
    build
    firebase_app_distribution(
        app: "1:123456789:ios:abcd1234",
        release_notes: "Try out this app!"
        testers: app_testers.join(","),
    )
end

distribute レーンを実行します。

$ fastlane distribute

この時点で、Fastfile は次のようになります。

firebase_app_id = "<your Firebase app ID>"
app_testers = [
  "your@email.com",
  "another@email.com",
]
tester_udids_file = "tester_udids.txt"

default_platform(:ios)

lane :build do
    get_certificates()
    get_provisioning_profile(adhoc: true, force: true)
    build_app(export_method: "ad-hoc")
end

lane :distribute do
    download_udids
    add_new_devices
    build
    firebase_app_distribution(
        app: firebase_app_id,
        release_notes: "Try out this app!",
        testers: app_testers.join(","),
    )
end

lane :download_udids do
    firebase_app_distribution_get_udids(
        app: firebase_app_id,
        output_file: tester_udids_file,
    )
end

lane :add_new_devices do
    register_devices(devices_file: tester_udids_file)
end

テストデバイスからリリースをダウンロードする

アプリにテストデバイスの UDID が含まれるようになったので、テストデバイスにインストールできます。

テストデバイスで、メールのリンクまたはデバイスのホーム画面のアイコンを使用して、App Distribution テスターウェブアプリに戻ります。

UDID Codelab アプリに移動すると、リリースをダウンロードする準備ができていることがわかります。

実機をお使いの場合は、ダウンロードを押して、アプリをインストールして実行してください。

7. 完了

これで、プレリリーステストプロセスを自動化するように App Distribution と fastlane を構成しました。これで、テスターを追加したり、アプリに UDID を追加したりする際に、fastlane distribute というコマンドを 1 つ実行するだけで済むようになりました。

テスターから UDID を個別に収集したり、Apple Developer Console にアクセスしてデバイスリストやプロビジョニングプロファイルを更新したりする必要はなくなります。Xcode を開く必要もありません。

このワークフローは、継続的インテグレーション環境で 1 時間ごとまたは 1 日ごとに実行するように簡単に設定できます。

App Distribution と fastlane を使用して、プレリリース版の iOS ビルドを迅速に配布する

1. 始める前に

学習内容

必要なもの

2. 使ってみる

fastlane を設定する

Firebase CLI をインストールする

3. fastlane を使用してアプリをビルドする

アプリをビルドする

4. アプリを Firebase にアップロードする

Firebase プロジェクトを作成して設定する

iOS アプリをプロジェクトに追加する

App Distribution を有効にする

fastlane で配信を設定する

Firebase プロジェクトを認証する

アプリを配布する

5. テスターを招待してアプリをダウンロードしてもらう

リリースにテスターとして自分を追加する

テストデバイスを登録する

テスター デバイスの UDID をエクスポートする

6. アプリのプロビジョニング プロファイルを更新して再ビルドする

UDID エクスポートのレーンを追加

Apple デベロッパー コンソールにデバイスを追加する

プロビジョニング プロファイルにデバイスを追加する

レーンを再実行してビルドとアップロードを行う

テストデバイスからリリースをダウンロードする

7. 完了

関連情報

テスターデバイスの UDID をエクスポートする

6. アプリのプロビジョニングプロファイルを更新して再ビルドする

Apple デベロッパーコンソールにデバイスを追加する

プロビジョニングプロファイルにデバイスを追加する