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

アプリの配布とfastlaneを使用して、プレリリースのiOSビルドをより速く配布します

1. 始める前に

この Codelab では、 Firebase App Distributionとそのfastlaneプラグインを使用して、iOS アプリをテスターに配布し、テストデバイスの UDID を収集してアプリのプロビジョニングプロファイルに登録する方法を学習します。これにより、Ad Hoc ビルドをテスターにすばやく取得できます。手。

学習内容

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

必要なもの

Google アカウント
XCode 11.7+ がインストールされた Apple マシン
Xcode で構築された Ad Hoc プレリリース iOS アプリ
有料のApple Developer アカウント
テスト用の物理 iOS デバイス。

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

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

2. 始めましょう

ファストレーンを設定する

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

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

3. fastlane でアプリをビルドする

アプリをビルドする

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

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

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

default_platform(:ios)

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

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

このコードラボでは、 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 開発者コンソールでアプリを作成します。

$ 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 を入力します。

次のいくつかの手順をスキップして、 [Continue to console]をクリックします。 SDK は後でアプリに追加します。

プロジェクトとアプリが[プロジェクトの概要]ページで利用できるようになりました。

アプリの配布を有効にする

[リリースと監視] セクションで、 [アプリの配布]をクリックします。
条件に同意したら、[開始] をクリックして、アプリの App Distribution を有効にします。

fastlaneでディストリビューションをセットアップする

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

コマンドでオプションのプロンプトが表示された場合は、オプション 3: RubyGems.orgを選択します。

$ fastlane add_plugin firebase_app_distribution

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

$ fastlane

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

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

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

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

次のコマンドを実行します。

$ fastlane run firebase_app_distribution_login

コマンドによって認証リンクが出力されたら、ブラウザでリンクを開きます。
プロンプトが表示されたら、Google アカウントにサインインし、Firebase プロジェクトへのアクセス許可を付与します。

結果のコードをログインブラウザからコピーし、コマンドラインに貼り付けます。

ログインアクションは更新トークンを出力します。この更新トークンは、App Distribution プラグインが Firebase での認証に使用します。

FIREBASE_TOKEN環境変数を設定してトークンを渡します。

$ export FIREBASE_TOKEN= <token>

アプリを配布する

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

./fastlane/Fastfileの先頭で、 firebase_app_idという変数を定義します。 <your_app_id>を、作成したアプリの Firebase アプリ ID に置き換えます (これはプロジェクト設定ページにあります)。

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

firebase_app_id = "<your_app_id>"

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

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. テスターにアプリのダウンロードを依頼する

テスターが Ad Hoc ビルドのテストへの招待を受け入れると、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パラメータに渡しますfirebase_app_distribution.

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 プロファイルをインストールしてテストデバイスを登録する必要もあります。その後、利用可能になったリリースには、デバイスのホーム画面に追加された Web クリップを使用して、App Distribution テスター Web アプリからアクセスできます。

iOS テストデバイスで、Firebase App Distribution から送信されたメールを開き、 [開始する]リンクをタップします。リンクは必ずSafariで開いてください。
これで、App Distribution テスター Web アプリが表示されます。表示されるページで、Google アカウントでサインインし、 [招待を受け入れる] をタップします。

招待されたリリースを確認できるようになりました。いずれかのリリースの下にある[デバイスの登録]をタップします。

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

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

デバイスの一意のデバイス ID (UDID) を収集して、テストデバイスを登録します。

Firebase は、Firebase プロジェクトのすべての所有者と編集者に、テストデバイスの UDID を含むメールを送信します。

テストデバイスのホーム画面に Web クリップをインストールします。 Web クリップは App Distribution テスター Web アプリを開き、すべてのテストアプリをインストールしてアクセスできるようにします。

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

テストデバイスの UDID を Firebase に共有したので、デベロッパーとして再開できます。 App Distribution ダッシュボードの[テスター] タブで、テスター情報がアプリのリリースの下に「承認済み」のステータスで表示されるようになりました。

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

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

開発者は、テストデバイスの UDID を含むメールを Firebase から受け取ります。オプションとして、App Distribution を使用すると、複数の新しいデバイス UDID を一度に簡単に収集できます。これにより、それらを Firebase コンソールから生のテキストファイルとして直接エクスポートできます。

すべての 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 開発者コンソールへのデバイスの追加

次のレーンを作成して、UDID を Apple 開発者コンソールのデバイスリストに追加します。これにより、 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 テスター Web アプリに戻ります。

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

物理デバイスを使用している場合は、ダウンロードを押してから、アプリをインストールして実行してください!

7.おめでとう

これで、App Distribution とfastlaneを構成して、プレリリーステストプロセスを自動化できました。これで、追加のテスターを招待したり、その UDID をアプリに追加したりしたい場合は、1 つのコマンドを実行するだけで済みます: fastlane distribute 。

そのため、テスターから個別に UDID を収集したり、Apple 開発者コンソールにアクセスしてデバイスリストやプロビジョニングプロファイルを更新したりする必要はもうありません。 XCode を開く必要さえありません。

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

参考文献

iOS 向けのアプリ内 SDKなど、 Firebase App Distribution の機能を調べる
ファストレーンの詳細
チームのコード署名をmatchで管理する
fastlane をCI に統合する

アプリの配布とfastlaneを使用して、プレリリースのiOSビルドをより速く配布します

1. 始める前に

学習内容

必要なもの

2. 始めましょう

ファストレーンを設定する

3. fastlane でアプリをビルドする

アプリをビルドする

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

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

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

アプリの配布を有効にする

fastlaneでディストリビューションをセットアップする

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

アプリを配布する

5. テスターに​​アプリのダウンロードを依頼する

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

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

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

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

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

Apple 開発者コンソールへのデバイスの追加

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

レーンを再実行してビルドおよびアップロードする

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

7.おめでとう

参考文献

5. テスターにアプリのダウンロードを依頼する

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

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

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

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

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