XamariniOS@1 - Xamarin.iOS v1 タスク

  • [アーティクル]

このタスクをパイプラインで使用して、macOS 上の Xamarin を使用して iOS アプリをビルドします。 詳細については、「 Xamarin ガイダンス」と「 CI 中にアプリに署名する」を参照してください。

構文

# Xamarin.iOS v1
# Build an iOS app with Xamarin on macOS.
- task: XamariniOS@1
  inputs:
    solutionFile: '**/*.sln' # string. Alias: solution. Required. Solution. Default: **/*.sln.
    configuration: 'Release' # string. Required. Configuration. Default: Release.
    #clean: false # boolean. Clean. Default: false.
    #packageApp: true # boolean. Create app package. Default: true.
    #buildForSimulator: false # boolean. Alias: forSimulator. Build for iOS Simulator. Default: false.
  # Advanced
    #runNugetRestore: true # boolean. Run NuGet restore. Default: true.
    #args: # string. Arguments. 
    #workingDirectory: # string. Alias: cwd. Working directory. 
    #buildToolOption: 'xbuild' # 'xbuild' | 'msbuild'. Alias: buildTool. Build tool. Default: xbuild.
    #mdtoolFile: # string. Alias: mdtoolLocation. Build tool path. 
  # Signing & Provisioning
    #signingOption: 'file' # 'file' | 'id'. Alias: signMethod. Override using. Default: file.
    #signingIdentity: # string. Alias: iosSigningIdentity. Optional. Use when signMethod = id. Signing identity. 
    #signingUnlockDefaultKeychain: false # boolean. Alias: unlockDefaultKeychain. Optional. Use when signMethod = id. Unlock default keychain. Default: false.
    #signingDefaultKeychainPassword: # string. Alias: defaultKeychainPassword. Optional. Use when signMethod = id. Default keychain password. 
    #signingProvisioningProfileID: # string. Alias: provProfileUuid. Optional. Use when signMethod = id. Provisioning profile UUID. 
    #signingP12File: # string. Alias: p12. Optional. Use when signMethod = file. P12 certificate file. 
    #signingP12Password: # string. Alias: p12pwd. Optional. Use when signMethod = file. P12 password. 
    #signingProvisioningProfileFile: # string. Alias: provProfile. Optional. Use when signMethod = file. Provisioning profile file. 
    #signingRemoveProfile: false # boolean. Alias: removeProfile. Optional. Use when signMethod = file. Remove profile after build. Default: false.

入力

solutionFile - ソリューション
入力エイリアス: solution。 string. 必須です。 既定値: **/*.sln。

ソリューションのリポジトリ ルート Xamarin.iOS からビルドへの相対パスを指定します。 ワイルドカードを含む場合があります。


configuration - 構成
string. 必須です。 既定値: Release。

構成を指定します。 標準構成は、アドホック、AppStore、デバッグ、リリースです。


clean - きれい
boolean. 既定値: false。

省略可能。 ビルドの前にクリーン ビルド (/t:clean) を実行します。


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

に設定すると true、ビルドの一部として IPA が生成されます。


buildForSimulator - iOS シミュレーター用のビルド
入力エイリアス: forSimulator。 boolean. 既定値: false。

省略可能。 物理 iOS デバイスではなく、iOS シミュレーター用のビルド。


runNugetRestore - NuGet の復元を実行する
boolean. 既定値: true。

Xamarin iOS ソリューションでを実行 nuget restore し、参照されているすべてのパッケージをビルド前にインストールします。 nugetビルド エージェント マシンの PATH 内のツールが使用されます。 別のバージョンの NuGet を使用するか、追加の引数を設定するには、 NuGet インストーラー タスクを使用します。


args - 引数
string.

省略可能。 ビルドに使用される追加のコマンド ライン引数を指定します。


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

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


buildToolOption - ビルド ツール
入力エイリアス: buildTool。 string. 使用できる値: xbuild (xbuild (Xamarin Studio))、 msbuild (MSBuild (Visual Studio for Mac))。 既定値: xbuild。

タスクで使用するビルド ツールを指定します。


mdtoolFile - ビルド ツールパス
入力エイリアス: mdtoolLocation。 string.

省略可能。 xbuild (Xamarin Studio mono ビルド ツール) または MSBuild (Visual Studio for Mac ビルド ツール) へのパスを指定します。 値が空の場合は、既定の xbuild または MSBuild パスが使用されます。


signingOption - を使用してオーバーライドする
入力エイリアス: signMethod。 string. 使用できる値: file (ファイル コンテンツ) id 、(識別子)。 既定値: file。

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


signingIdentity - 署名 ID
入力エイリアス: iosSigningIdentity。 string. 省略可能。 の場合は signMethod = idを使用します。

ビルドの署名に使用される署名 ID をオーバーライドします。 値が空の場合は、Xcode プロジェクトの設定が使用されます。 このオプションを使用するかどうかを選択 signingUnlockDefaultKeychain する必要がある場合があります。


signingUnlockDefaultKeychain - 既定のキーチェーンのロックを解除する
入力エイリアス: unlockDefaultKeychain。 boolean. 省略可能。 の場合は signMethod = idを使用します。 既定値: false。

既定のキーチェーンのロックを解除することで、"ユーザー操作は許可されていません" エラーを解決します。


signingDefaultKeychainPassword - 既定のキーチェーン パスワード
入力エイリアス: defaultKeychainPassword。 string. 省略可能。 の場合は signMethod = idを使用します。

が設定されている場合に、既定のキーチェーンのロックを解除するパスワードを signingUnlockDefaultKeychain 指定します。


signingProvisioningProfileID - プロビジョニング プロファイル UUID
入力エイリアス: provProfileUuid。 string. 省略可能。 の場合は signMethod = idを使用します。

このビルドに使用するインストール済みプロビジョニング プロファイルの UUID を指定します。


signingP12File - P12 証明書ファイル
入力エイリアス: p12。 string. 省略可能。 の場合は signMethod = fileを使用します。

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


signingP12Password - P12 パスワード
入力エイリアス: p12pwd。 string. 省略可能。 の場合は signMethod = fileを使用します。

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


signingProvisioningProfileFile - プロビジョニング プロファイル ファイル
入力エイリアス: provProfile。 string. 省略可能。 の場合は signMethod = fileを使用します。

このビルドに使用するインストール済みプロビジョニング プロファイルオーバーライドの UUID を指定します。


signingRemoveProfile - ビルド後にプロファイルを削除する
入力エイリアス: removeProfile。 boolean. 省略可能。 の場合は signMethod = fileを使用します。 既定値: false。

ビルドの完了後に、プロビジョニング プロファイル ファイルの内容をビルド エージェントから削除することを指定します。 これは、ユーザーごとに 1 つのエージェントを実行している場合にのみ有効にします。


タスク コントロールのオプション

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

出力変数

[なし] :

必要条件

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