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

テスト用iOSアプリのビルド

テストの目的で専用にiOSアプリをビルドすることもできます。専用のStepが、アプリと関連するテストをビルドし、.xctestrunファイルもエクスポートします。ビルド後は、アプリをサードパーティのテストサービスにアップロードするか、シミュレーターまたは実機にインストールできます。また、このStepを使用して、Firebaseを使用した仮想デバイステストを設定することもできます。

Stepはxcodebuildのbuild-for-testingアクションを使用します。詳細については、How do I implement the Build For Testing and Test Without Building features from the command line?を参照してください。

Code signing

テストデバイスへのアプリのインストールには、code signingが必要です。Xcode Build for testing for iOSのStepには組み込みのcode signing設定があり、code signingの自動プロビジョニングでの利用が可能です。ほとんどの場合、テスト用にアプリへcode signingするために他のStepは必要ありません。

iOSアプリをテスト用にビルドするには:

  1. code signingの場合は、AppleサービスアカウントをBitriseに接続していることを確認してください。

    Stepは、automatic code signingに対してApple IDおよびAPIキー認証をサポートしています。APIキー認証の使用を推奨します。

    手動code signing

    手動code signingも使用できます。その場合は、Stepのautomatic code signingオプションを設定しないでください。

  2. Workflowでyou install all of the app's dependenciesことを確認してください。

  3. 依存関係のStepまたはStepsの後に、Xcode Build for testing for iOS StepをWorkflowに追加してください。

  4. Project path入力が正しい場所を指していることを確認してください。

    入力欄では、.xcodeprojまたは.xcworkspaceファイルへのパスを指定します。ほとんどの場合、この入力を変更する必要はありません。新しいアプリを追加すると、プロジェクトスキャナーが自動的に該当するファイルを見つけ、その場所を入力のdefault valueである環境変数に保存します。

    default valueの確認

    Project path入力のdefault valueが正しい場所を指しているか不明な場合は、Env Varsタブに移動し、$BITRISE_PROJECT_PATH変数の値が.xcodeprojまたは.xcworkspaceファイルへの正しいパスになっていることを確認してください。

    CocoaPods

    依存関係管理にCocoaPodsを使用している場合は、Project path入力が.xcworkspaceファイルを指している必要があります。

  5. Scheme入力が、アプリのビルドに使用したいスキームを指していることを確認してください。

    default valueは、アプリの初期設定時に設定したスキームを保存する環境変数です。別のスキームを使用する場合は、入力欄にその名前を入力してください。

  6. ビルドしたいビルド構成を、Build Configuration入力で設定してください。

    default valueはDebugです。

    build-for-testing-step.png

  7. Device destination specifier入力でデバイスの宛先を設定します。この入力にはカンマ区切りのキーと値のペアを指定します。

    build-for-testingアクションは特定の実機がなくても実行できるため、プラットフォームを汎用的に指定することを推奨します。

    // building for physical iOS devices
    generic/platform=iOS

    // building for simulators
    generic/platform=iOS Simulator

    この入力は、xcodebuildの-destinationオプションを設定します。指定可能なオプションの詳細については、コマンドラインからユニットテストを実行するにはどうすればよいですか?を参照してください。

  8. 必要に応じて、Test plan入力で特定のテストプランを設定してください。

    この入力は、xcodebuildのbuild-for-testingアクションの-testPlanオプションを設定します。空欄のままにした場合は、Xcodeスキームで指定されたテストプランが使用されます。

  9. code signingが必要な場合は、automatic code signingオプションの使用を推奨します。Automatic code signing入力グループを見つけ、Automatic code signing method入力のドロップダウンメニューから方法を選択してください。

    auto-code-signing-input.png

    コードsigning certificate

    アプリに正しく署名するには、コードsigning certificateをBitriseにアップロードする必要があることに注意してください。

    APIキー認証の使用を推奨します。これは、App settingsページで設定するBitrise管理の認証方式です。

    代わりにStepレベルでAPI認証を制御したい場合は、App Store Connect connection override入力グループ内で別のAPIキー認証を定義する3つの入力すべてを設定することで、デフォルトのBitrise管理接続を上書きできます。

    api-connect-override.png

  10. 生成されたアーティファクトにArtifactsタブまたはTestsタブでアクセスできるようにするには、Deploy to Bitrise.io StepをWorkflowの最後に追加してください。