メインコンテンツまでスキップ

iOSのデバイステスト

BitriseのiOSデバイステストソリューションを使うと、実機を用意して登録することなく、物理デバイス上でiOSアプリのUIテストを実行できます。必要なのは、専用のStepsを使用し、アプリをテストしたいデバイスの種類を設定することだけです。Stepの利用に制限はなく、制限されるのは全体のビルド時間の上限のみです。また、FlutterやReact Nativeなど、他のフレームワークで開発されたiOSアプリでも動作します。

本デバイステストソリューションはFirebase Test Labをベースにしています。Googleのデータセンターで稼働する実際の本番デバイスを使用してアプリをテストします。デバイスには最新のAPIが書き込まれており、ロケール設定をカスタマイズできます。テスト結果のログ、動画、スクリーンショットはBitriseで確認できます。

iOSアプリの場合、Firebase Test LabはXCTestテストを実行します。利用可能なデバイスの一覧はこちらから確認できます。

制限事項

全体のビルド時間によって制限される場合があります。また、1回のビルドに含められるiOS Device TestingStepは1つのみで、実行できるテストの種類も1つだけである点にご注意ください。これは、BitriseがビルドスラッグをFirebase Test Labに送信するためです。同じビルドスラッグを送信するとBuild already existsエラーが発生します。

iOSアプリでFirebaseを使ってデバイステストを実行するClick to copy link​

Firebase Test Labソリューションを使ってiOSアプリのデバイステストを実行するには、Workflowに2つのStepsを追加する必要があります。

  • Xcode Build for testing for iOS。
  • iOS Device Testing。
マルチプラットフォームアプリ

Stepは、FlutterやReact Nativeなど、他のフレームワークで構築されたiOSアプリのデバイステストも実行できます。Xcode Build for testing for iOSStepがアプリの.xcodeprojまたは.xcworkspaceファイルにアクセスできるようにするだけです。

Xcode Build for testing for iOSStepは、xcodebuildコマンドのbuild-for-testingアクションを実行します。これにより、iOSアプリのXcodeスキームで定義されたテストがビルドされます。Stepは、テストディレクトリ(デフォルトではDebug-iphoneos)とxctestrunファイルを含む.zipファイルをエクスポートします。

このStepを使用するには、テストアプリ用のcode signingファイルが必要です。自動プロビジョニングと手動プロビジョニングのどちらかを選択できます。

iOS Device TestingStepは、この.zipファイルのパス(環境変数としてエクスポートされたもの)を入力として受け取ってテストを実行し、テスト結果をBitriseにエクスポートします。

自動と手動のcode signingアセット管理

Xcode Build for testing for iOSStepは、プロビジョニングプロファイルを手動で管理する必要なく、code signingアセットを管理できます。必要なのは、Step(後述)で該当する入力項目を選択し、正しい証明書をCode Signingタブにアップロードすることだけです。これがautomatic code signingアセット管理方式です。

手動のcode signingアセット管理を選択する場合は、Xcode Build for testing for iOSStepの前にCertificate and Profile InstallerStepを追加してください。前者がcode signingアセット管理を担当し、後者がプロジェクトをビルドします。Xcode Build for testing for iOSStepのAutomatic code signing method入力がoffに設定されていることを確認してください。

以下の手順では、Xcode Build for testing for iOSStepを使用してBitriseでautomatic code signingアセット管理を設定する方法を詳しく説明します。

  1. Xcode Build for testing for iOSStepをWorkflowに追加します。

    テスト用にビルドする

    本ガイドでは、デバイステスト用にアプリを設定する際に最も重要な入力項目のみを説明します。Stepの詳細については、Xcode Build for testing for iOSを参照してください。

  2. Scheme name入力で、使用するXcodeスキームを設定します。デフォルトでは、この入力の値はアプリの作成時に保存される$BITRISE_SCHEME環境変数です。

  3. Build Configuration入力で、使用するXcodeビルド構成の名前を追加します。

    構成が指定されていない場合は、Xcodeプロジェクトのデフォルトのビルド構成が使用されます。

  4. StepのDevice destination specifier入力で、xcodebuildの宛先オプションを設定します。

    default valueはgeneric/platform=iOSです。つまり、テストは任意のiOSデバイスで実行できます。

  5. Automatic code signing method入力を、code signingに使用するApple service connectionに設定します。使用できるオプションは次のとおりです。

    • automatic code signingを行わない場合はoff。
    • APIキー認証を使用する場合はapi-key。
    • Apple ID認証を使用する場合はapple-id。
  6. iOS Device TestingStepをWorkflowに追加します。StepはXcode Build for testing for iOSStepの後に配置する必要があります。

    APIの設定入力項目

    Test APIに関連する入力項目(Test API's base URLおよびAPI token)は、グラフィカルなUI上では変更できません。これらの値を変更しないでください。

  7. Test devices入力フィールドで、アプリをテストするデバイスを指定します。

    利用可能なデバイスの一覧はこちらから確認できます。複数のデバイスを次の形式で入力に追加できます。deviceID,version,language,orientation

  8. Workflowに、バージョン1.4.1以降のDeploy to Bitrise.ioStepが含まれていることを確認してください。Stepの古いバージョンでは、Testsタブで結果を確認できません。

  9. ビルドを開始する。

すべてうまくいけば、ビルドアーティファクトの中、またはTestsタブで結果を確認できるはずです。