Xcode@5 - Xcode v5 タスク

  • [アーティクル]

このタスクを使用して、macOS で Xcode ワークスペースをビルド、テスト、またはアーカイブし、必要に応じてアプリをパッケージ化します。

構文

# Xcode v5
# Build, test, or archive an Xcode workspace on macOS. Optionally package an app.
- task: Xcode@5
  inputs:
    actions: 'build' # string. Required. Actions. Default: build.
    #configuration: '$(Configuration)' # string. Configuration. Default: $(Configuration).
    #sdk: '$(SDK)' # string. SDK. Default: $(SDK).
    #xcWorkspacePath: '**/*.xcodeproj/project.xcworkspace' # string. Workspace or project path. Default: **/*.xcodeproj/project.xcworkspace.
    #scheme: # string. Scheme. 
    #xcodeVersion: 'default' # '8' | '9' | '10' | '11' | '12' | '13' | 'default' | 'specifyPath'. Xcode version. Default: default.
    #xcodeDeveloperDir: # string. Optional. Use when xcodeVersion == specifyPath. Xcode developer path. 
  # Package options
    #packageApp: false # boolean. Create app package. Default: false.
    #archivePath: # string. Optional. Use when packageApp == true. Archive path. 
    #exportPath: 'output/$(SDK)/$(Configuration)' # string. Optional. Use when packageApp == true. Export path. Default: output/$(SDK)/$(Configuration).
    #exportOptions: 'auto' # 'auto' | 'plist' | 'specify'. Optional. Use when packageApp == true. Export options. Default: auto.
    #exportMethod: 'development' # string. Required when exportOptions == specify. Export method. Default: development.
    #exportTeamId: # string. Optional. Use when exportOptions == specify. Team ID. 
    #exportOptionsPlist: # string. Required when exportOptions == plist. Export options plist. 
    #exportArgs: # string. Optional. Use when packageApp == true. Export arguments. 
  # Signing & provisioning
    #signingOption: 'nosign' # 'nosign' | 'default' | 'manual' | 'auto'. Signing style. Default: nosign.
    #signingIdentity: # string. Optional. Use when signingOption = manual. Signing identity. 
    #provisioningProfileUuid: # string. Optional. Use when signingOption = manual. Provisioning profile UUID. 
    #provisioningProfileName: # string. Optional. Use when signingOption = manual. Provisioning profile name. 
    #teamId: # string. Optional. Use when signingOption = auto. Team ID. 
  # Devices & simulators
    #destinationPlatformOption: 'default' # 'default' | 'iOS' | 'tvOS' | 'macOS' | 'custom'. Destination platform. Default: default.
    #destinationPlatform: # string. Optional. Use when destinationPlatformOption == custom. Custom destination platform. 
    #destinationTypeOption: 'simulators' # 'simulators' | 'devices'. Optional. Use when destinationPlatformOption != default && destinationPlatformOption != macOS. Destination type. Default: simulators.
    #destinationSimulators: # string. Optional. Use when destinationPlatformOption != default && destinationPlatformOption != macOS && destinationTypeOption == simulators. Simulator. 
    #destinationDevices: # string. Optional. Use when destinationPlatformOption != default && destinationPlatformOption != macOS && destinationTypeOption == devices. Device. 
  # Advanced
    #args: # string. Arguments. 
    #workingDirectory: # string. Alias: cwd. Working directory. 
    #useXcpretty: true # boolean. Use xcpretty. Default: true.
    #xcprettyArgs: # string. Optional. Use when useXcpretty == true. Xcpretty arguments. 
    #publishJUnitResults: false # boolean. Publish test results to Azure Pipelines. Default: false.
    #testRunTitle: # string. Optional. Use when publishJUnitResults == true. Test run title.

# Xcode v5
# Build, test, or archive an Xcode workspace on macOS. Optionally package an app.
- task: Xcode@5
  inputs:
    actions: 'build' # string. Required. Actions. Default: build.
    #configuration: '$(Configuration)' # string. Configuration. Default: $(Configuration).
    #sdk: '$(SDK)' # string. SDK. Default: $(SDK).
    #xcWorkspacePath: '**/*.xcodeproj/project.xcworkspace' # string. Workspace or project path. Default: **/*.xcodeproj/project.xcworkspace.
    #scheme: # string. Scheme. 
    #xcodeVersion: 'default' # '8' | '9' | '10' | '11' | 'default' | 'specifyPath'. Xcode version. Default: default.
    #xcodeDeveloperDir: # string. Optional. Use when xcodeVersion == specifyPath. Xcode developer path. 
  # Package options
    #packageApp: false # boolean. Create app package. Default: false.
    #archivePath: # string. Optional. Use when packageApp == true. Archive path. 
    #exportPath: 'output/$(SDK)/$(Configuration)' # string. Optional. Use when packageApp == true. Export path. Default: output/$(SDK)/$(Configuration).
    #exportOptions: 'auto' # 'auto' | 'plist' | 'specify'. Optional. Use when packageApp == true. Export options. Default: auto.
    #exportMethod: 'development' # string. Required when exportOptions == specify. Export method. Default: development.
    #exportTeamId: # string. Optional. Use when exportOptions == specify. Team ID. 
    #exportOptionsPlist: # string. Required when exportOptions == plist. Export options plist. 
    #exportArgs: # string. Optional. Use when packageApp == true. Export arguments. 
  # Signing & provisioning
    #signingOption: 'nosign' # 'nosign' | 'default' | 'manual' | 'auto'. Signing style. Default: nosign.
    #signingIdentity: # string. Optional. Use when signingOption = manual. Signing identity. 
    #provisioningProfileUuid: # string. Optional. Use when signingOption = manual. Provisioning profile UUID. 
    #provisioningProfileName: # string. Optional. Use when signingOption = manual. Provisioning profile name. 
    #teamId: # string. Optional. Use when signingOption = auto. Team ID. 
  # Devices & simulators
    #destinationPlatformOption: 'default' # 'default' | 'iOS' | 'tvOS' | 'macOS' | 'custom'. Destination platform. Default: default.
    #destinationPlatform: # string. Optional. Use when destinationPlatformOption == custom. Custom destination platform. 
    #destinationTypeOption: 'simulators' # 'simulators' | 'devices'. Optional. Use when destinationPlatformOption != default && destinationPlatformOption != macOS. Destination type. Default: simulators.
    #destinationSimulators: # string. Optional. Use when destinationPlatformOption != default && destinationPlatformOption != macOS && destinationTypeOption == simulators. Simulator. 
    #destinationDevices: # string. Optional. Use when destinationPlatformOption != default && destinationPlatformOption != macOS && destinationTypeOption == devices. Device. 
  # Advanced
    #args: # string. Arguments. 
    #workingDirectory: # string. Alias: cwd. Working directory. 
    #useXcpretty: true # boolean. Use xcpretty. Default: true.
    #xcprettyArgs: # string. Optional. Use when useXcpretty == true. Xcpretty arguments. 
    #publishJUnitResults: false # boolean. Publish test results to Azure Pipelines. Default: false.
    #testRunTitle: # string. Optional. Use when publishJUnitResults == true. Test run title.

# Xcode v5
# Build, test, or archive an Xcode workspace on macOS. Optionally package an app.
- task: Xcode@5
  inputs:
    actions: 'build' # string. Required. Actions. Default: build.
    #configuration: '$(Configuration)' # string. Configuration. Default: $(Configuration).
    #sdk: '$(SDK)' # string. SDK. Default: $(SDK).
    #xcWorkspacePath: '**/*.xcodeproj/project.xcworkspace' # string. Workspace or project path. Default: **/*.xcodeproj/project.xcworkspace.
    #scheme: # string. Scheme. 
    #xcodeVersion: 'default' # '8' | '9' | '10' | '11' | 'default' | 'specifyPath'. Xcode version. Default: default.
    #xcodeDeveloperDir: # string. Optional. Use when xcodeVersion == specifyPath. Xcode developer path. 
  # Package options
    #packageApp: false # boolean. Create app package. Default: false.
    #archivePath: # string. Optional. Use when packageApp == true. Archive path. 
    #exportPath: 'output/$(SDK)/$(Configuration)' # string. Optional. Use when packageApp == true. Export path. Default: output/$(SDK)/$(Configuration).
    #exportOptions: 'auto' # 'auto' | 'plist' | 'specify'. Optional. Use when packageApp == true. Export options. Default: auto.
    #exportMethod: 'development' # string. Required when exportOptions == specify. Export method. Default: development.
    #exportTeamId: # string. Optional. Use when exportOptions == specify. Team ID. 
    #exportOptionsPlist: # string. Required when exportOptions == plist. Export options plist. 
    #exportArgs: # string. Optional. Use when packageApp == true. Export arguments. 
  # Signing & provisioning
    #signingOption: 'nosign' # 'nosign' | 'default' | 'manual' | 'auto'. Signing style. Default: nosign.
    #signingIdentity: # string. Optional. Use when signingOption = manual. Signing identity. 
    #provisioningProfileUuid: # string. Optional. Use when signingOption = manual. Provisioning profile UUID. 
    #provisioningProfileName: # string. Optional. Use when signingOption = manual. Provisioning profile name. 
    #teamId: # string. Optional. Use when signingOption = auto. Team ID. 
  # Devices & simulators
    #destinationPlatformOption: 'default' # 'default' | 'iOS' | 'tvOS' | 'macOS' | 'custom'. Destination platform. Default: default.
    #destinationPlatform: # string. Optional. Use when destinationPlatformOption == custom. Custom destination platform. 
    #destinationTypeOption: 'simulators' # 'simulators' | 'devices'. Optional. Use when destinationPlatformOption != default && destinationPlatformOption != macOS. Destination type. Default: simulators.
    #destinationSimulators: 'iPhone 7' # string. Optional. Use when destinationPlatformOption != default && destinationPlatformOption != macOS && destinationTypeOption == simulators. Simulator. Default: iPhone 7.
    #destinationDevices: # string. Optional. Use when destinationPlatformOption != default && destinationPlatformOption != macOS && destinationTypeOption == devices. Device. 
  # Advanced
    #args: # string. Arguments. 
    #workingDirectory: # string. Alias: cwd. Working directory. 
    #useXcpretty: true # boolean. Use xcpretty. Default: true.
    #publishJUnitResults: false # boolean. Publish test results to Azure Pipelines. Default: false.

# Xcode v5
# Build, test, or archive an Xcode workspace on macOS. Optionally package an app.
- task: Xcode@5
  inputs:
    actions: 'build' # string. Required. Actions. Default: build.
    #configuration: '$(Configuration)' # string. Configuration. Default: $(Configuration).
    #sdk: '$(SDK)' # string. SDK. Default: $(SDK).
    #xcWorkspacePath: '**/*.xcodeproj/project.xcworkspace' # string. Workspace or project path. Default: **/*.xcodeproj/project.xcworkspace.
    #scheme: # string. Scheme. 
    #xcodeVersion: 'default' # '8' | '9' | '10' | 'default' | 'specifyPath'. Xcode version. Default: default.
    #xcodeDeveloperDir: # string. Optional. Use when xcodeVersion == specifyPath. Xcode developer path. 
  # Package options
    #packageApp: false # boolean. Create app package. Default: false.
    #archivePath: # string. Optional. Use when packageApp == true. Archive path. 
    #exportPath: 'output/$(SDK)/$(Configuration)' # string. Optional. Use when packageApp == true. Export path. Default: output/$(SDK)/$(Configuration).
    #exportOptions: 'auto' # 'auto' | 'plist' | 'specify'. Optional. Use when packageApp == true. Export options. Default: auto.
    #exportMethod: 'development' # string. Required when exportOptions == specify. Export method. Default: development.
    #exportTeamId: # string. Optional. Use when exportOptions == specify. Team ID. 
    #exportOptionsPlist: # string. Required when exportOptions == plist. Export options plist. 
    #exportArgs: # string. Optional. Use when packageApp == true. Export arguments. 
  # Signing & provisioning
    #signingOption: 'nosign' # 'nosign' | 'default' | 'manual' | 'auto'. Signing style. Default: nosign.
    #signingIdentity: # string. Optional. Use when signingOption = manual. Signing identity. 
    #provisioningProfileUuid: # string. Optional. Use when signingOption = manual. Provisioning profile UUID. 
    #provisioningProfileName: # string. Optional. Use when signingOption = manual. Provisioning profile name. 
    #teamId: # string. Optional. Use when signingOption = auto. Team ID. 
  # Devices & simulators
    #destinationPlatformOption: 'default' # 'default' | 'iOS' | 'tvOS' | 'macOS' | 'custom'. Destination platform. Default: default.
    #destinationPlatform: # string. Optional. Use when destinationPlatformOption == custom. Custom destination platform. 
    #destinationTypeOption: 'simulators' # 'simulators' | 'devices'. Optional. Use when destinationPlatformOption != default && destinationPlatformOption != macOS. Destination type. Default: simulators.
    #destinationSimulators: 'iPhone 7' # string. Optional. Use when destinationPlatformOption != default && destinationPlatformOption != macOS && destinationTypeOption == simulators. Simulator. Default: iPhone 7.
    #destinationDevices: # string. Optional. Use when destinationPlatformOption != default && destinationPlatformOption != macOS && destinationTypeOption == devices. Device. 
  # Advanced
    #args: # string. Arguments. 
    #workingDirectory: # string. Alias: cwd. Working directory. 
    #useXcpretty: true # boolean. Use xcpretty. Default: true.
    #publishJUnitResults: false # boolean. Publish test results to Azure Pipelines. Default: false.

# Xcode v5
# Build, test, or archive an Xcode workspace on macOS. Optionally package an app.
- task: Xcode@5
  inputs:
    actions: 'build' # string. Required. Actions. Default: build.
    #configuration: '$(Configuration)' # string. Configuration. Default: $(Configuration).
    #sdk: '$(SDK)' # string. SDK. Default: $(SDK).
    #xcWorkspacePath: '**/*.xcodeproj/project.xcworkspace' # string. Workspace or project path. Default: **/*.xcodeproj/project.xcworkspace.
    #scheme: # string. Scheme. 
    #xcodeVersion: 'default' # '8' | '9' | '10' | 'default' | 'specifyPath'. Xcode version. Default: default.
    #xcodeDeveloperDir: # string. Optional. Use when xcodeVersion == specifyPath. Xcode developer path. 
  # Package options
    #packageApp: false # boolean. Create app package. Default: false.
    #archivePath: # string. Optional. Use when packageApp == true. Archive path. 
    #exportPath: 'output/$(SDK)/$(Configuration)' # string. Optional. Use when packageApp == true. Export path. Default: output/$(SDK)/$(Configuration).
    #exportOptions: 'auto' # 'auto' | 'plist' | 'specify'. Optional. Use when packageApp == true. Export options. Default: auto.
    #exportMethod: 'development' # string. Required when exportOptions == specify. Export method. Default: development.
    #exportTeamId: # string. Optional. Use when exportOptions == specify. Team ID. 
    #exportOptionsPlist: # string. Required when exportOptions == plist. Export options plist. 
    #exportArgs: # string. Optional. Use when packageApp == true. Export arguments. 
  # Signing & provisioning
    #signingOption: 'nosign' # 'nosign' | 'default' | 'manual' | 'auto'. Signing style. Default: nosign.
    #signingIdentity: # string. Optional. Use when signingOption = manual. Signing identity. 
    #provisioningProfileUuid: # string. Optional. Use when signingOption = manual. Provisioning profile UUID. 
    #provisioningProfileName: # string. Optional. Use when signingOption = manual. Provisioning profile name. 
    #teamId: # string. Optional. Use when signingOption = auto. Team ID. 
  # Devices & simulators
    #destinationPlatformOption: 'default' # 'default' | 'iOS' | 'tvOS' | 'macOS' | 'custom'. Destination platform. Default: default.
    #destinationPlatform: # string. Optional. Use when destinationPlatformOption == custom. Custom destination platform. 
    #destinationTypeOption: 'simulators' # 'simulators' | 'devices'. Optional. Use when destinationPlatformOption != default && destinationPlatformOption != macOS. Destination type. Default: simulators.
    #destinationSimulators: 'iPhone 7' # string. Optional. Use when destinationPlatformOption != default && destinationPlatformOption != macOS && destinationTypeOption == simulators. Simulator. Default: iPhone 7.
    #destinationDevices: # string. Optional. Use when destinationPlatformOption != default && destinationPlatformOption != macOS && destinationTypeOption == devices. Device. 
  # Advanced
    #args: # string. Arguments. 
    #workingDirectory: # string. Alias: cwd. Working directory. 
    #useXcpretty: true # boolean. Use xcpretty. Default: true.
    #publishJUnitResults: false # boolean. Publish test results to Azure Pipelines/TFS. Default: false.

入力

actions - アクション
string. 必須です。 既定値: build。

アクションのスペース区切りのリストを指定します。 有効なオプションには、build、、clean、testanalyze、 がありますarchive。 たとえば、clean build はクリーンビルドを実行します。 「Apple: Building from the command line with Xcode FAQ」を参照してください。


configuration - 構成
string. 既定値: $(Configuration)。

ビルドする Xcode プロジェクトまたはワークスペースの構成を指定します。 変数を使用する場合は、[変数] タブで値 (例: Release) を指定します。


sdk - Sdk
string. 既定値: $(SDK)。

Xcode プロジェクトまたはワークスペースをビルドするときに使用する SDK を指定します。 macOS ターミナル アプリケーションから を実行 xcodebuild -showsdks して、SDK の有効な一覧を表示します。 変数を使用する場合は、[変数] タブで値 (例: iphonesimulator) を指定します。


xcWorkspacePath - ワークスペースまたはプロジェクト パス
string. 既定値: **/*.xcodeproj/project.xcworkspace。

省略可能。 リポジトリのルートから Xcode ワークスペースまたはプロジェクトへの相対パスを指定します。 たとえば、MyApp/MyApp.xcworkspace または MyApp/MyApp.xcodeproj です。 ワイルドカードを使用できます。 ファイル マッチング パターンの詳細を確認してください。


scheme - スキーム
string.

省略可能。 Xcode スキーム名を指定します。 共有スキームである必要があります (Xcode の [マネージド スキーム ] の下の [共有] チェックボックス)。 スキームを指定せず、指定したワークスペースに 1 つの共有スキームがある場合は、ワークスペース スキームが使用されます。


xcodeVersion - Xcode バージョン
string. 使用できる値: 8 (Xcode 8)、 9 (Xcode 9)、 10 (Xcode 10) 11 、(Xcode 11) 12 、(Xcode 12) 13 、(Xcode 13) default、 specifyPath (パスの指定)。 既定値: default。

Xcode のターゲット バージョンを指定します。 エージェント コンピューターで Xcode の既定のバージョンを使用する場合に選択 Default します。 バージョン番号を指定する (例: ) は、 Xcode 9エージェント コンピューター上の環境変数によって設定されるバージョンの場所 (例: XCODE_9_DEVELOPER_DIR=/Applications/Xcode_9.0.0.app/Contents/Developer) に依存します。 Xcode 開発者ディレクトリへの特定のパスを指定する場合に選択 Specify path します。


xcodeVersion - Xcode バージョン
string. 使用できる値: 8 (Xcode 8)、 9 (Xcode 9)、 10 (Xcode 10) 11 、(Xcode 11)、 default、 specifyPath (パスの指定)。 既定値: default。

Xcode のターゲット バージョンを指定します。 エージェント コンピューターで Xcode の既定のバージョンを使用する場合に選択 Default します。 バージョン番号を指定する (例: ) は、 Xcode 9エージェント コンピューター上の環境変数によって設定されるバージョンの場所 (例: XCODE_9_DEVELOPER_DIR=/Applications/Xcode_9.0.0.app/Contents/Developer) に依存します。 Xcode 開発者ディレクトリへの特定のパスを指定する場合に選択 Specify path します。


xcodeVersion - Xcode バージョン
string. 使用できる値: 8 (Xcode 8)、 9 (Xcode 9)、 10 (Xcode 10)、 default、 specifyPath (パスの指定)。 既定値: default。

Xcode のターゲット バージョンを指定します。 エージェント コンピューターで Xcode の既定のバージョンを使用する場合に選択 Default します。 バージョン番号を指定する (例: ) は、 Xcode 9エージェント コンピューター上の環境変数によって設定されるバージョンの場所 (例: XCODE_9_DEVELOPER_DIR=/Applications/Xcode_9.0.0.app/Contents/Developer) に依存します。 Xcode 開発者ディレクトリへの特定のパスを指定する場合に選択 Specify path します。


xcodeDeveloperDir - Xcode 開発者パス
string. 省略可能。 の場合は xcodeVersion == specifyPathを使用します。

特定の Xcode 開発者ディレクトリへのパスを指定します (例: /Applications/Xcode_9.0.0.app/Contents/Developer)。 この入力は、エージェント コンピューターに Xcode の複数のバージョンがインストールされている場合に便利です。


packageApp - アプリ パッケージを作成する
boolean. 既定値: false。

IPA アプリ パッケージ ファイルをビルドの一部として生成するかどうかを指定します。


archivePath - アーカイブ パス
string. 省略可能。 の場合は packageApp == trueを使用します。

作成されたアーカイブが配置されるディレクトリを指定します。


exportPath - エクスポート パス
string. 省略可能。 の場合は packageApp == trueを使用します。 既定値: output/$(SDK)/$(Configuration)。

アーカイブからエクスポートされた製品の宛先を指定します。


exportOptions - エクスポート オプション
string. 省略可能。 の場合は packageApp == trueを使用します。 使用できる値: auto (自動)、 plist、 specify。 既定値: auto。

アーカイブをエクスポートするためのオプションを指定します。 の既定値 Automatic を選択すると、エクスポート方法がアーカイブから自動的に検出されます。 エクスポート オプションを含む plist ファイルを指定する場合に選択 Plist します。 特定のエクスポート方法とチーム ID を指定する場合に選択Specifyします。


exportMethod - Export メソッド
string. exportOptions == specify の場合に必要です。 既定値: development。

Xcode がアーカイブのエクスポートに使用するメソッドを指定します。 例: app-store、package、ad-hoc、enterprise、development。


exportTeamId - チーム ID
string. 省略可能。 の場合は exportOptions == specifyを使用します。

エクスポート時に使用する Apple Developer Portal の 10 文字のチーム ID を指定します。


exportOptionsPlist - エクスポート オプション plist
string. exportOptions == plist の場合に必要です。

エクスポート時に使用するオプションを含む plist ファイルへのパスを指定します。


exportArgs - 引数をエクスポートする
string. 省略可能。 の場合は packageApp == trueを使用します。

エクスポート中に使用される追加のコマンド ライン引数を指定します。


signingOption - 署名スタイル
string. 使用できる値: nosign (コード署名なし)、 default (プロジェクトの既定値) manual 、(手動署名)、 auto (自動署名)。 既定値: nosign。

ビルドに署名する方法を指定します。 署名を無効にする場合に選択 Do not code sign します。 プロジェクトの署名構成のみを使用する場合に選択 Project defaults します。 手動署名を強制し、必要に応じて署名 ID とプロビジョニング プロファイルを指定する場合に選択 Manual signing します。 自動署名を強制し、必要に応じて開発チーム ID を指定する場合に選択 Automatic signing します。 プロジェクトに署名が必要な場合は、「 Apple...のインストール 」タスクを使用して、Xcode ビルドの前に証明書とプロビジョニング プロファイルをインストールします。


signingIdentity - 署名 ID
string. 省略可能。 の場合は signingOption = manualを使用します。

ビルドに署名する署名 ID オーバーライドを指定します。 エージェント コンピューターで既定のキーチェーンのロックを解除する必要がある場合があります。 値を入力しない場合は、Xcode プロジェクトの設定が使用されます。


provisioningProfileUuid - プロビジョニング プロファイル UUID
string. 省略可能。 の場合は signingOption = manualを使用します。

ビルドに使用されるインストール済みプロビジョニング プロファイルの UUID を指定します。 異なるスキームまたはターゲットを持つ個別のビルド タスクを使用して、1 つのワークスペース (iOS、tvOS、watchOS) のターゲット別にプロビジョニング プロファイルを指定します。


provisioningProfileName - プロビジョニング プロファイル名
string. 省略可能。 の場合は signingOption = manualを使用します。

ビルドに使用されるインストール済みプロビジョニング プロファイルの名前を指定します。 指定した場合、これはプロビジョニング プロファイル UUID よりも優先されます。 異なるスキームまたはターゲットを持つ個別のビルド タスクを使用して、1 つのワークスペース (iOS、tvOS、watchOS) のターゲット別にプロビジョニング プロファイルを指定します。


teamId - チーム ID
string. 省略可能。 の場合は signingOption = autoを使用します。

複数の開発チームのメンバーである場合は必須です。 10 文字の開発チーム ID を指定します。


destinationPlatformOption - 移行先プラットフォーム
string. 使用できる値: default、(iOS および watchOS)tvOS、、、macOScustom。 iOS 既定値: default。

汎用ビルド デバイスが無効な場合に UI テストに使用されるターゲット デバイスのプラットフォームを指定します。 この一覧に含まれていないプラットフォームを指定することを選択 Custom します。 が選択されている場合 Default 、シミュレーターやデバイスは対象とされません。


destinationPlatform - カスタム変換先プラットフォーム
string. 省略可能。 の場合は destinationPlatformOption == customを使用します。

汎用ビルド デバイスが無効な場合に UI テストに使用される移行先デバイスのプラットフォームを指定します。 一覧に含まれていないプラットフォームを指定することを選択 Custom します。 が選択されている場合 Default 、シミュレーターもデバイスも対象とされません。


destinationTypeOption - 変換先の種類
string. 省略可能。 の場合は destinationPlatformOption != default && destinationPlatformOption != macOSを使用します。 使用できる値: simulators (シミュレーター)、 devices (接続されているデバイス)。 既定値: simulators。

UI テストに使用する変換先の種類を指定します。 デバイスは、ケーブルまたはネットワーク接続を介してビルドを実行する Mac に接続されている必要があります。 詳細については、「Xcode の デバイスとシミュレーター 」を参照してください。


destinationSimulators - シミュレータ
string. 省略可能。 の場合は destinationPlatformOption != default && destinationPlatformOption != macOS && destinationTypeOption == simulatorsを使用します。

UI テストに使用される Xcode シミュレーター名を指定します。 たとえば、 iPhone X (iOS と watchOS) や Apple TV 4K (tvOS) などです。 オプションのターゲット OS バージョンは、 などのiPhone X,OS=11.1形式OS=<versionNumber>で指定できます。 詳細については、ホストされている macOS エージェントにインストールされているシミュレーターの一覧を参照してください。


destinationSimulators - シミュレータ
string. 省略可能。 の場合は destinationPlatformOption != default && destinationPlatformOption != macOS && destinationTypeOption == simulatorsを使用します。 既定値: iPhone 7。

UI テストに使用される Xcode シミュレーター名を指定します。 たとえば、 iPhone X (iOS と watchOS) や Apple TV 4K (tvOS) などです。 オプションのターゲット OS バージョンは、 などのiPhone X,OS=11.1形式OS=<versionNumber>で指定できます。 詳細については、ホストされている macOS エージェントにインストールされているシミュレーターの一覧を参照してください。


destinationDevices - デバイス
string. 省略可能。 の場合は destinationPlatformOption != default && destinationPlatformOption != macOS && destinationTypeOption == devicesを使用します。

などの Raisa's iPadUI テストに使用されるデバイスの名前を指定します。 現在サポートされているデバイスは 1 つだけです。 Apple では、デバイス名にアポストロフィ (') は使用できません。 代わりに、右一重引用符 (') を使用できます。


args - 引数
string.

省略可能。 ビルドに使用する追加のコマンド ライン引数を指定します。 この入力は、ワークスペース/プロジェクトとスキームの代わりに または -project 引数を指定-targetする場合に便利です。 「Apple: Building from the command line with Xcode FAQ」を参照してください。


workingDirectory - 作業ディレクトリ
入力エイリアス: cwd。 string.

省略可能。 ビルドを実行する作業ディレクトリを指定します。 値を入力しない場合は、リポジトリのルートが使用されます。


useXcpretty - xcpretty を使用する
boolean. 既定値: true。

を使用 xcpretty して出力の書式を設定 xcodebuild するかどうかを指定します。 xcpretty はエージェント マシンにインストールする必要があります (Azure Pipelines でホストされるビルド エージェントにプレインストールされます)。 がインストールされていない場合 xcpretty は、生 xcodebuild 出力が表示されます。 詳細については 、「xcpretty 」を参照してください。


xcprettyArgs - Xcpretty 引数
string. 省略可能。 の場合は useXcpretty == trueを使用します。

が有効な場合 xcpretty 、この入力は の引数を指定します xcpretty。 GitHub の xcpretty 引数の一覧を参照してください。


publishJUnitResults - テスト結果を Azure Pipelines に発行する
boolean. 既定値: false。

JUnit テスト結果を Azure Pipelines に発行するかどうかを指定します。 JUnit テスト結果を生成するには、これを有効にする必要 xcpretty があります。


publishJUnitResults - テスト結果を Azure Pipelines/TFS に発行する
boolean. 既定値: false。

JUnit テスト結果を Azure Pipelines/TFS に発行するかどうかを指定します。 JUnit テスト結果を生成するには、これを有効にする必要 xcpretty があります。


testRunTitle - テスト実行のタイトル
string. 省略可能。 の場合は publishJUnitResults == trueを使用します。

と publishJUnitResults が有効になっている場合xcprettyは、テストの実行タイトルを指定できます。


タスク制御オプション

すべてのタスクには、タスク入力に加えて制御オプションがあります。 詳細については、「 コントロール オプションと一般的なタスク プロパティ」を参照してください。

出力変数

[なし] :

解説

このタスクを使用して、macOS で Xcode ワークスペースをビルド、テスト、またはアーカイブし、必要に応じてアプリをパッケージ化します。

複数のプロビジョニング プロファイルの使用

現時点では、Xcode タスク (iOS アプリ拡張機能など) に対して複数のプロビジョニング プロファイルはサポートされません。

例

Xcode アプリをビルドする

要件

要件 説明
パイプラインの種類 YAML、クラシック ビルド
実行日 エージェント、DeploymentGroup
確認要求 セルフホステッド エージェントには、このタスクを使用するジョブを実行するために、次の要求に一致する機能が必要です。
Capabilities このタスクは、ジョブ内の後続のタスクに対する要求を満たしていません。
コマンドの制限 Any
設定可能な変数 Any
エージェントのバージョン サポートされているすべてのエージェント バージョン。
タスクのカテゴリ Build