Google Cloud CLI を使用してテストする

このガイドでは、gcloud CLI を使用して XCTest やゲームループ テストを実行する方法について説明します。

ステップ 1: ローカル Google Cloud SDK 環境を構成する

1. Google Cloud SDK をダウンロードします。

これには gcloud CLI ツールが含まれます。

2. インストールが最新であり、gcloud firebase コマンドが含まれていることを確認します。

         gcloud components update

3. Google アカウントを使用して gcloud CLI にログインします。

         gcloud auth login

4. gcloud で Firebase プロジェクトを設定します。PROJECT_ID は Firebase プロジェクトの ID です。

        gcloud config set project PROJECT_ID

ステップ 2: テストを実行する

XCTest の実行

1. 次のコマンドを実行して、テストの .ZIP ファイルをアップロードします（アプリをまだパッケージ化していない場合は、XCTest のパッケージ化をご覧ください）。

   cd FOLDER_WITH_TEST_OUTPUT/Build/Products ; \
   zip -r MyTests.zip Debug-iphoneos YOUR_SCHEME_iphoneosDEPLOYMENT_TARGET-arm64.xctestrun

2. テスト ディメンションを選択します。

   Test Lab では、さまざまな iOS バージョン、デバイス、画面の向き、ロケールでテストを実行できます。これらの構成は、テストのテスト ディメンションと呼ばれます。各ディメンションのオプション（デバイスの iOS バージョンでサポートされている Xcode バージョンなど）を表示するには、次のコマンド中の dimension の models、versions、locales を置き換えて実行します。

   gcloud firebase test ios dimension list

   画面の向きは多少わかりやすく、オプションは portrait と landscape だけです。

   テスト ディメンションのリストを確認し、テストを実行するいくつかの組み合わせを選択します。1 日に実行できる組み合わせ数の上限については、料金プランをご覧ください。

3. 一連のテスト ディメンションを選択したら、firebase test ios run コマンドを使用して Test Lab でテストを実行できます。テストするテスト ディメンションの組み合わせごとに、個別の --device フラグを含めます。

   gcloud firebase test ios run --test PATH/TO/MyTests.zip \
    --device model=MODEL_ID_1,version=VERSION_ID_1,locale=LOCALE_1,orientation=ORIENTATION_1 \
    --device model=MODEL_ID_2,version=VERSION_ID_2,locale=LOCALE_2,orientation=ORIENTATION_2 \
    etc...

   テストがビルドされた Xcode のバージョンと、Test Lab で使用されるデフォルトの Xcode のバージョンとの間に互換性がない場合、テストが失敗する可能性があります。テストでサポートされる Xcode バージョンを指定するには、--xcode-version フラグを使用します。

   gcloud firebase test ios run --test PATH/TO/MyTests.zip \
    --device model=MODEL_ID_1,version=VERSION_ID_1,locale=LOCALE_1,orientation=ORIENTATION_1 \
    --xcode-version=15

   Firebase コンソールでテスト マトリックスを見つけやすくするために、オプションでテスト マトリックスにラベルを付けるには、次の例に示すように --client-details matrixLabel="<label>" フラグを使用します。

   gcloud beta firebase test ios run --test PATH/TO/MyTests.zip \
     --device model=MODEL_ID_1,version=VERSION_ID_1,locale=LOCALE_1,orientation=ORIENTATION_1 \
     --client-details matrixLabel="my label"

ゲームループ テストの実行

gcloud beta firebase test ios run コマンドを実行し、次のフラグを使用して実行環境を構成します。

次のコマンドでは、iPhone 8 Plus でループ 1、4、6、7、8 を実行するゲームループ テストを行います。

gcloud beta firebase test ios run
 --type game-loop --app path/to/my/App.ipa --scenario-numbers 1,4,6-8
 --device-model=iphone8plus

gcloud CLI の詳細については、リファレンス ドキュメントをご覧ください。

ステップ 3（省略可）: 今後構築するテストを自動化する

Test Lab を使用して gcloud コマンドをスクリプト化する

シェル スクリプトまたはバッチファイルを使用してモバイルアプリのテストコマンドを自動化することができます。自動化しない場合は gcloud コマンドラインを使用して実行します。次の bash スクリプトの例では、XCTest テストをタイムアウト 2 分で実行し、テストが正常に完了したかどうかを報告します。

if gcloud firebase test ios run --test MyTest.zip --timeout 2m
then
    echo "Test matrix successfully finished"
else
    echo "Test matrix exited abnormally with non-zero exit code: " $?
fi

スクリプト終了コード

Test Lab にはいくつかの終了コードが用意されており、スクリプトまたはバッチファイルを使用して実行したテストの結果を詳細に把握できます。

ステップ 4: テスト結果を調査する

テストが開始されると、[テスト結果] ページへのリンクが表示されます。選択した構成の数と、テストに対して設定されているテスト タイムアウト時間によっては、テストの実行に数分かかることがあります。テストが完了すると、テスト結果を確認できます。テスト結果の見方については、Firebase Test Lab の結果の分析をご覧ください。

次のステップ

Google Cloud SDK のドキュメントで、一般提供またはベータ版のテスト オプションを確認する。