シミュレーター向けiOSアプリのビルド

iOSアプリは、iOSまたはtvOSシミュレータープラットフォーム向けにビルドできます。

これには、Xcode Build for Simulator Stepが必要です。Stepは.appファイルを作成し、任意のmacOSデバイスにインストールしたり、テスターなどに送付したりできます。code signingはまったく必要ないため、iOSアプリの配布可能なバージョンを簡単に作成する方法です。

Stepは.xctestrunファイルも作成し、これを使ってテストを実行できます。.appファイルと.xctestrunファイルはどちらも、その出力変数を参照する後続のStepsからアクセスでき、ビルドアーティファクトとしてダウンロードすることもできます。

シミュレーター向けにアプリをビルドするには：

Workflow Editor
Configuration YAML

Workflowに必要な依存関係をすべてインストールしていることを確認してください。

さまざまな依存関係マネージャー向けに専用のStepsを用意しています。例：
依存関係をインストールするStepの後に、Xcode Build for Simulator StepをWorkflowに追加してください。
Project pathの入力が、.xcodeprojファイルまたは.xcworkspaceファイルのいずれかを指していることを確認してください。

この入力は、xcodebuildコマンドの-projectオプションまたは-workspaceオプションを設定します。ほとんどの場合、アプリの追加プロセスでプロジェクトスキャナーによってアプリが自動的に設定されていれば、default valueを変更する必要はありません。
Schemeの入力には、アプリのビルドに使用するXcodeスキームの名前を設定してください。

この入力は、xcodebuildコマンドの-schemeオプションを設定します。default valueは、アプリを追加して初回設定を行う際に作成される環境変数です。別のスキームを使用する場合は、ここにその名前を入力できます。

ビルド設定
デフォルトでは、Stepはスキームで指定されたビルド設定を使用します。ただし、これを上書きして別のビルド設定を使用することもできます。その場合は、目的のビルド設定の名前をConfiguration name入力に追加してください。この入力は任意で、選択したスキームで指定されたビルド設定を使用したくない場合にのみ必要です。
Xcodeプロジェクトでは、いつでも新しいビルド設定を作成できます。プロジェクトへのビルド設定ファイルの追加を参照してください。
Device destination specifierの入力で、generic/platform=iOS Simulatorを選択してください。
必要に応じて、Build settings (xcconfig), allow code signingの入力をCODE_SIGNING_ALLOWED=YESに設定してください。これにより、ビルド中にcode signingファイルをインストールできるようになります。

通常、シミュレーター向けにビルドしたアプリにはcode signingは必要ありません。ただし、特定のテストケースやサードパーティの依存関係では必要になる場合があります。code signingの設定方法については、iOS code signingを参照してください。
アプリをビルドアーティファクトとして利用できるようにするには、Deploy to Bitrise.io StepをWorkflowの最後に追加してください。デフォルトでは、Stepの設定を変更する必要はありません。

Workflowに必要な依存関係をすべてインストールしていることを確認してください。

さまざまな依存関係マネージャー向けに専用のStepsを用意しています。例：

依存関係をインストールするStepの後に、xcode-build-for-simulator StepをWorkflowに追加してください。

workflows:    
  primary:
    steps:
      - cocoapods-install
      - xcode-build-for-simulator:
          inputs:

project_pathの入力が、.xcodeprojファイルまたは.xcworkspaceファイルのいずれかを指していることを確認してください。

この入力は、xcodebuildコマンドの-projectオプションまたは-workspaceオプションを設定します。ほとんどの場合、アプリの追加プロセスでプロジェクトスキャナーによってアプリが自動的に設定されていれば、default valueを変更する必要はありません。
```
- xcode-build-for-simulator:
    inputs:
      - project_path: $BITRISE_PROJECT_PATH
```
schemeの入力には、アプリのビルドに使用するXcodeスキームの名前を設定してください。

この入力は、xcodebuildコマンドの-schemeオプションを設定します。default valueは、アプリを追加して初回設定を行う際に作成される環境変数です。別のスキームを使用する場合は、スキーム名を正しく入力するようにしてください。
```
- xcode-build-for-simulator:
    inputs:
      - scheme: $BITRISE_SCHEME
      - project_path: $BITRISE_PROJECT_PATH
```
ビルド設定
デフォルトでは、Stepはスキームで指定されたビルド設定を使用します。ただし、これを上書きして別のビルド設定を使用することもできます。その場合は、目的のビルド設定の名前をconfigurationの入力に追加してください。この入力は任意で、選択したスキームで指定されたビルド設定を使用したくない場合にのみ必要です。
Xcodeプロジェクトでは、いつでも新しいビルド設定を作成できます。プロジェクトへのビルド設定ファイルの追加を参照してください。

destinationの入力をgeneric/platform=iOS Simulatorに設定してください。

- xcode-build-for-simulator:
    inputs:
      - scheme: $BITRISE_SCHEME
      - destination: generic/platform=iOS Simulator
      - project_path: $BITRISE_PROJECT_PATH

必要に応じて、xcconfig_contentの入力に値CODE_SIGNING_ALLOWED=YESを設定してください。これにより、ビルド中にcode signingファイルをインストールできるようになります。

通常、シミュレーター向けにビルドしたアプリにはcode signingは必要ありません。ただし、特定のテストケースやサードパーティの依存関係では必要になる場合があります。code signingの設定方法については、iOS code signingを参照してください。
```
- xcode-build-for-simulator:
    inputs:
      - scheme: $BITRISE_SCHEME
      - destination: generic/platform=iOS Simulator
      - xcconfig_content: |-
          CODE_SIGNING_ALLOWED=YES            
          COMPILER_INDEX_STORE_ENABLE = NO
      - project_path: $BITRISE_PROJECT_PATH
```

アプリをビルドアーティファクトとして利用できるようにするには、deploy-to-bitrise-io StepをWorkflowの最後に追加してください。デフォルトでは、Stepの設定を変更する必要はありません。

workflows:
  primary:
    steps:
      - cocoapods-install: {}
      - xcode-build-for-simulator:
          inputs:
            - scheme: $BITRISE_SCHEME
            - destination: generic/platform=iOS Simulator
            - xcconfig_content: |-
                CODE_SIGNING_ALLOWED=YES
                COMPILER_INDEX_STORE_ENABLE = NO
            - project_path: $BITRISE_PROJECT_PATH
      - deploy-to-bitrise-io: {}

関連情報