Xcode@3 - Xcode Build v3 タスク

このタスクを使用して、macOS 上に Xcode ワークスペースを構築します。

# Xcode Build v3
# Build an Xcode workspace on macOS.
- task: Xcode@3
  inputs:
    actions: 'build' # string. Required. Actions. Default: build.
    #configuration: '$(Configuration)' # string. Configuration. Default: $(Configuration).
    #sdk: '$(SDK)' # string. SDK. Default: $(SDK).
    #xcWorkspacePath: '**/*.xcodeproj/*.xcworkspace' # string. Workspace/Project Path. Default: **/*.xcodeproj/*.xcworkspace.
    #scheme: # string. Scheme. 
    #packageApp: true # boolean. Create App Package. Default: true.
  # Package Options
    #archivePath: # string. Archive Path. 
    #exportPath: 'output/$(SDK)/$(Configuration)' # string. Export Path. Default: output/$(SDK)/$(Configuration).
    #exportOptions: 'auto' # 'auto' | 'plist' | 'specify'. 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. Export Arguments. 
  # Signing & Provisioning
    #xcode8AutomaticSigning: false # boolean. Automatic Signing. Default: false.
    #teamId: # string. Optional. Use when xcode8AutomaticSigning = true. Team ID. 
    #signMethod: 'file' # 'file' | 'id'. Override Using. Default: file.
    #iosSigningIdentity: # string. Optional. Use when signMethod = id. Signing Identity. 
    #unlockDefaultKeychain: false # boolean. Optional. Use when signMethod = id. Unlock Default Keychain. Default: false.
    #defaultKeychainPassword: # string. Optional. Use when signMethod = id. Default Keychain Password. 
    #provProfileUuid: # string. Optional. Use when signMethod = id. Provisioning Profile UUID. 
    #p12: # string. Optional. Use when signMethod = file. P12 Certificate File. 
    #p12pwd: # string. Optional. Use when signMethod = file. P12 Password. 
    #provProfile: # string. Optional. Use when signMethod = file. Provisioning Profile File. 
    #removeProfile: false # boolean. Optional. Use when signMethod = file. Remove Profile After Build. Default: false.
  # Advanced
    #args: # string. Arguments. 
    #cwd: # string. Working Directory. 
    outputPattern: 'output/$(SDK)/$(Configuration)' # string. Required. Output Directory. Default: output/$(SDK)/$(Configuration).
    #xcodeDeveloperDir: # string. Xcode Developer Path. 
    #useXcpretty: false # boolean. Use xcpretty. Default: false.
    #publishJUnitResults: false # boolean. Publish to VSTS/TFS. Default: false.

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

アクションのスペース区切りのリストを指定します。 有効なオプションは build、clean、test、analyze、archive です。 例: build clean はクリーン ビルドを実行します。 Apple: Building from the command line with Xcode FAQを参照してください。

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

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

sdk - SDKについて
string。 既定値: $(SDK)。

指定した SDK に対して Xcode プロジェクトまたはワークスペースをビルドします。 xcodebuild -showsdks を実行して、SDK の有効な一覧を確認します。

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

任意。 リポジトリ ルートから Xcode ワークスペースまたはプロジェクトへの相対パスを指定します。 たとえば、MyApp/MyApp.xcworkspace や MyApp/MyApp.xcworkspace/MyApp.xcodeproj などです。 「Advanced Arguments」で-target flagを使用する場合は、空白のままにします。

scheme - スキーム
string。

任意。 Xcode スキーム名を指定します。 共有スキーム である必要があります (Xcode の [マネージド スキームの ] の下の [共有] チェックボックス)。 ワークスペースが指定されている場合は必須です。

packageApp - アプリ パッケージの作成
boolean。 既定値: true。

IPA がビルドの一部として生成されるかどうかを指定します。 Xcode 7 および Xcode 8 でアーカイブをエクスポートする場合は、「 パッケージ オプション 」セクションで追加の入力を確認してください。

archivePath - アーカイブ パス
string。

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

exportPath - エクスポート パス
string。 既定値: output/$(SDK)/$(Configuration)。

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

exportOptions - エクスポートオプション
string。 使用できる値: auto、plist、specify。 既定値: auto。

アーカイブのエクスポート時に エクスポート オプション を渡す方法を指定します。

exportMethod - エクスポート方法
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。

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

xcode8AutomaticSigning - 自動署名
boolean。 既定値: false。

Xcode 8 または Xcode 9 プロジェクトが自動署名用に構成されている場合は、この入力を使用します。

teamId - チーム ID
string。 任意。 xcode8AutomaticSigning = trueするときに使用します。

10 桁の開発者チーム ID を指定します。 これは、複数の開発チームのメンバーである場合に必要です。

signMethod - オーバーライド方法
string。 使用できる値: file (ファイル コンテンツ)、id (識別子)。 既定値: file。

ビルドで既定とは異なる署名またはプロビジョニング方法を使用する場合は、この入力を使用します。 P12 証明書とプロビジョニング プロファイルを使用する File Contents を選択します。 デフォルトのキーチェーンとプリインストールされたプロファイルから署名設定を取得するには、[ Identifiers ] を選択します。 既定のビルド設定をオーバーライドしない場合は、対応するフィールドを空白のままにします。

iosSigningIdentity - 署名 ID
string。 任意。 signMethod = idするときに使用します。

ビルドの署名に使用される署名 ID の上書きを指定します。 既定値は Xcode プロジェクト設定です。 「デフォルトのキーチェーンをロック解除 」を選択する必要がある場合があります。

unlockDefaultKeychain - デフォルトのキーチェーンのロックを解除
boolean。 任意。 signMethod = idするときに使用します。 既定値: false。

デフォルトのキーチェーンのロックを解除することで、 ユーザー操作が許可されない エラーを解決します。

defaultKeychainPassword - デフォルトのキーチェーンパスワード
string。 任意。 signMethod = idするときに使用します。

デフォルトのキーチェーンのロックを解除するためのパスワードを指定します。

provProfileUuid - プロビジョニング プロファイル UUID
string。 任意。 signMethod = idするときに使用します。

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

p12 - P12 証明書ファイル
string。 任意。 signMethod = fileするときに使用します。

ビルドに使用する署名証明書を含む PKCS12 形式の P12 証明書ファイルへの相対パスを指定します。

p12pwd - P12パスワード
string。 任意。 signMethod = fileするときに使用します。

P12 証明書ファイルのパスワードを指定します。 ビルド変数を使用して暗号化します。

provProfile - プロビジョニング プロファイル ファイル
string。 任意。 signMethod = fileするときに使用します。

ビルドに使用するプロビジョニング プロファイルの上書きを含むファイルへの相対パスを指定します。 異なるスキームまたはターゲットを持つ個別のビルド タスクを使用して、1 つのワークスペース (iOS、WatchKit、tvOS) 内のターゲットごとにプロビジョニング プロファイルを指定します。

ビルド後のプロファイルの削除の removeProfile -
boolean。 任意。 signMethod = fileするときに使用します。 既定値: false。

ビルドの完了後に、プロビジョニング プロファイル ファイルの内容をビルド エージェントから削除します。 ユーザーごとに 1 つのエージェントを実行しているかどうかのみを確認してください。

args - 引数
string。

ビルドに使用する追加のコマンドライン引数を指定します。 この入力は、ワークスペースとスキームを指定する代わりに -target または -project を使用する場合に便利です。

cwd - 作業ディレクトリの
string。

ビルド実行の作業ディレクトリを指定します。 既定値はリポジトリのルートです。

outputPattern - 出力ディレクトリ
string。 必須。 既定値: output/$(SDK)/$(Configuration)。

ビルド出力 (バイナリ) が配置される相対パスを指定します。

xcodeDeveloperDir - Xcode開発者パス
string。

任意。 Xcode Developer フォルダーへのパスを指定します (システムの既定値でない場合)。 Xcodeの複数のバージョンがシステムにインストールされている場合に使用します。 たとえば、 /Applications/Xcode 7.app/Contents/Developerと指定します。

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

出力 xcodebuild フォーマットし、JUnit テスト結果レポートを生成します。 エージェント・ホストにインストールする必要があります。 詳しくは、xcpretty についての記事をご覧ください。

publishJUnitResults - VSTS/TFS に発行する
boolean。 既定値: false。

xctool を使用して生成された JUnit テスト結果は、VSTS/TFS に発行されます。

なし。