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にエクスポートします。
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アセット管理を設定する方法を詳しく説明します。
- Workflow Editor
- Configuration YAML
-
Xcode Build for testing for iOSStepをWorkflowに追加します。
テスト用にビルドする本ガイドでは、デバイステスト用にアプリを設定する際に最も重要な入力項目のみを説明します。Stepの詳細については、Xcode Build for testing for iOSを参照してください。
-
Scheme name入力で、使用するXcodeスキームを設定します。デフォルトでは、この入力の値はアプリの作成時に保存される
$BITRISE_SCHEME環境変数です。 -
Build Configuration入力で、使用するXcodeビルド構成の名前を追加します。
構成が指定されていない場合は、Xcodeプロジェクトのデフォルトのビルド構成が使用されます。
-
StepのDevice destination specifier入力で、
xcodebuildの宛先オプションを設定します。default valueは
generic/platform=iOSです。つまり、テストは任意のiOSデバイスで実行できます。 -
Automatic code signing method入力を、code signingに使用するApple service connectionに設定します。使用できるオプションは次のとおりです。
- automatic code signingを行わない場合は
off。 - APIキー認証を使用する場合は
api-key。 - Apple ID認証を使用する場合は
apple-id。
- automatic code signingを行わない場合は
-
iOS Device TestingStepをWorkflowに追加します。StepはXcode Build for testing for iOSStepの後に配置する必要があります。
APIの設定入力項目Test APIに関連する入力項目(Test API's base URLおよびAPI token)は、グラフィカルなUI上では変更できません。これらの値を変更しないでください。
-
Test devices入力フィールドで、アプリをテストするデバイスを指 定します。
利用可能なデバイスの一覧はこちらから確認できます。複数のデバイスを次の形式で入力に追加できます。
deviceID,version,language,orientation -
Workflowに、バージョン1.4.1以降のDeploy to Bitrise.ioStepが含まれていることを確認してください。Stepの古いバージョンでは、Testsタブで結果を確認できません。
-
xcode-build-for-testStepをWorkflowに追加します。テスト用にビルドする本ガイドでは、デバイステスト用にアプリを設定する際に最も重要な入力項目のみを説明します。Stepの詳細については、Xcode Build for testing for iOSを参照してください。
my-workflow:steps:- git-clone: {}- xcode-build-for-test:inputs: -
scheme入力で、使用するXcodeスキームを設定します。デフォルトでは、この入力の 値はアプリの作成時に保存される$BITRISE_SCHEME環境変数です。my-workflow:steps:- git-clone: {}- xcode-build-for-test:inputs:- scheme: $BITRISE_SCHEME -
configuration入力で、使用するXcodeビルド構成の名前を追加します。構成が指定されていない場合は、Xcodeプロジェクトのデフォルトのビルド構成が使用されます。
my-workflow:steps:- git-clone: {}- xcode-build-for-test:inputs:- scheme: $BITRISE_SCHEME- configuration: Debug -
Stepの
destination入力で、xcodebuildの宛先オプションを設定します。default valueは
generic/platform=iOSです。つまり、テストは任意のiOSデバイスで実行できます。my-workflow:steps:- git-clone: {}- xcode-build-for-test:inputs:- scheme: $BITRISE_SCHEME- configuration: Debug- destination: generic/platform=iOS -
automatic_code_signing入力を、code signingに使用するApple service connectionに設定します。使用できるオプションは次のとおりです。- automatic code signingを行わない場合は
off。 - APIキー認証を使用する場合は
api-key。 - Apple ID認証を使用する場合は
apple-id。
my-workflow:steps:- git-clone: {}- xcode-build-for-test:inputs:- scheme: $BITRISE_SCHEME- configuration: Debug- destination: generic/platform=iOS- automatic_code_signing: api-key - automatic code signingを行わない場合は
-
virtual-device-testing-for-iosStepをWorkflowに追加します。Stepはxcode-build-for-testStepの後に配置する必要があります。my-workflow:steps:- git-clone: {}- xcode-build-for-test:inputs:- scheme: $BITRISE_SCHEME- configuration: Debug- destination: generic/platform=iOS- automatic_code_signing: api-key- virtual-device-testing-for-ios:inputs: -
test_devices入力フィールドで、アプリをテストするデバイスを指定します。利用可能なデバイスの一覧はこちらから確認できます。複数のデバイスを次の形式で入力に追加できます。
deviceID,version,language,orientationmy-workflow:steps:- git-clone: {}- xcode-build-for-test:inputs:- scheme: $BITRISE_SCHEME- configuration: Debug- destination: generic/platform=iOS- automatic_code_signing: api-key- virtual-device-testing-for-ios:inputs:- test_devices: 'iphone8,16.6,en,portrait -
Workflowに、バージョン1.4.1以降の
deploy-to-bitrise-ioStepが含まれていることを確認してください。Stepの古いバージョンでは、Testsタブで結果を確認できません。fmy-workflow:steps:- git-clone: {}- xcode-build-for-test:inputs:- scheme: $BITRISE_SCHEME- configuration: Debug- destination: generic/platform=iOS- test_plan: test- automatic_code_signing: api-key- project_path: $BITRISE_PROJECT_PATH- virtual-device-testing-for-ios:inputs:- test_devices: 'iphone8,16.6,en,portrait'- deploy-to-bitrise-io: {}
すべてうまくいけば、ビルドアーティファクトの中、またはTestsタブで結果を確認できるはずです。