XamarinAndroid@1 - Xamarin.Android v1 タスク

[アーティクル]
04/16/2024

このタスクは、Xamarin で Android アプリをビルドするために使用します。

構文

# Xamarin.Android v1
# Build an Android app with Xamarin.
- task: XamarinAndroid@1
  inputs:
    projectFile: '**/*.csproj' # string. Alias: project. Required. Project. Default: **/*.csproj.
    #target: # string. Target. 
    #outputDirectory: # string. Alias: outputDir. Output directory. 
    #configuration: # string. Configuration. 
    #createAppPackage: true # boolean. Create app package. Default: true.
    #clean: false # boolean. Clean. Default: false.
  # MSBuild Options
    #msbuildLocationOption: 'version' # 'version' | 'location'. Alias: msbuildLocationMethod. MSBuild. Default: version.
    #msbuildVersionOption: '15.0' # 'latest' | '17.0' | '16.0' | '15.0' | '14.0' | '12.0' | '4.0'. Alias: msbuildVersion. Optional. Use when msbuildLocationMethod = version. MSBuild version. Default: 15.0.
    #msbuildFile: # string. Alias: msbuildLocation. Required when msbuildLocationMethod = location. MSBuild location. 
    #msbuildArchitectureOption: 'x86' # 'x86' | 'x64'. Alias: msbuildArchitecture. Optional. Use when msbuildLocationMethod = version. MSBuild architecture. Default: x86.
    #msbuildArguments: # string. Additional arguments. 
  # JDK Options
    jdkOption: 'JDKVersion' # 'JDKVersion' | 'Path'. Alias: jdkSelection. Required. Select JDK to use for the build. Default: JDKVersion.
    #jdkVersionOption: 'default' # 'default' | '1.11' | '1.10' | '1.9' | '1.8' | '1.7' | '1.6'. Alias: jdkVersion. Optional. Use when jdkSelection = JDKVersion. JDK version. Default: default.
    #jdkDirectory: # string. Alias: jdkUserInputPath. Required when jdkSelection = Path. JDK path. 
    #jdkArchitectureOption: 'x64' # 'x86' | 'x64'. Alias: jdkArchitecture. Optional. Use when jdkVersion != default. JDK architecture. Default: x64.

# Xamarin.Android v1
# Build an Android app with Xamarin.
- task: XamarinAndroid@1
  inputs:
    projectFile: '**/*.csproj' # string. Alias: project. Required. Project. Default: **/*.csproj.
    #target: # string. Target. 
    #outputDirectory: # string. Alias: outputDir. Output directory. 
    #configuration: # string. Configuration. 
    #createAppPackage: true # boolean. Create app package. Default: true.
    #clean: false # boolean. Clean. Default: false.
  # MSBuild Options
    #msbuildLocationOption: 'version' # 'version' | 'location'. Alias: msbuildLocationMethod. MSBuild. Default: version.
    #msbuildVersionOption: '15.0' # 'latest' | '15.0' | '14.0' | '12.0' | '4.0'. Alias: msbuildVersion. Optional. Use when msbuildLocationMethod = version. MSBuild version. Default: 15.0.
    #msbuildFile: # string. Alias: msbuildLocation. Required when msbuildLocationMethod = location. MSBuild location. 
    #msbuildArchitectureOption: 'x86' # 'x86' | 'x64'. Alias: msbuildArchitecture. Optional. Use when msbuildLocationMethod = version. MSBuild architecture. Default: x86.
    #msbuildArguments: # string. Additional arguments. 
  # JDK Options
    jdkOption: 'JDKVersion' # 'JDKVersion' | 'Path'. Alias: jdkSelection. Required. Select JDK to use for the build. Default: JDKVersion.
    #jdkVersionOption: 'default' # 'default' | '1.11' | '1.10' | '1.9' | '1.8' | '1.7' | '1.6'. Alias: jdkVersion. Optional. Use when jdkSelection = JDKVersion. JDK version. Default: default.
    #jdkDirectory: # string. Alias: jdkUserInputPath. Required when jdkSelection = Path. JDK path. 
    #jdkArchitectureOption: 'x64' # 'x86' | 'x64'. Alias: jdkArchitecture. Optional. Use when jdkVersion != default. JDK architecture. Default: x64.

入力

projectFile - プロジェクト
入力エイリアス: project。 string. 必須です。既定値: **/*.csproj。

ビルドするプロジェクトの Xamarin.Android リポジトリルートからの相対パスを指定します。ワイルドカードを使用できます。詳細については、「ファイルマッチングパターンリファレンス」を参照してください。たとえば、すべてのサブフォルダー内のすべての csproj ファイルには **/*.csproj を使用します。が選択されている場合Create App Package、プロジェクトにはPackageForAndroidターゲットが必要です。

target - ターゲット
string.

このプロジェクトでビルドするターゲットを指定します。複数のターゲットを区切るには、セミコロンを使用します。

outputDirectory - 出力ディレクトリ
入力エイリアス: outputDir。 string.

省略可能。ビルドの出力ディレクトリを提供します。例: $(build.binariesDirectory)/bin/Release。

configuration - 構成
string.

ビルドする構成を指定します。たとえば、debug または release です。

ヒント

[変数] タブでなどの BuildConfiguration ビルド変数を宣言し ([キュー時刻] を選択 Allow )、ここで $(BuildConfiguration)として参照します。その後、ビルドをキューに入れるときにプラットフォームを変更し、複数の構成のビルドを有効にすることができます。

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

ビルド中にターゲット (/t:PackageForAndroid)を渡して APK を生成します。

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

ビルド中に、クリーンターゲット (/t:clean)を渡します。

msbuildLocationOption - Msbuild
入力エイリアス: msbuildLocationMethod。 string. 使用できる値: version、 location (場所の指定)。既定値: version。

MSBuild (Windows の場合) または xbuild (macOS の場合) へのパスを指定します。既定の動作では、最新バージョンを検索します。

msbuildVersionOption - MSBuild のバージョン
入力エイリアス: msbuildVersion。 string. 省略可能。の場合は msbuildLocationMethod = versionを使用します。使用できる値: latest、 17.0 (MSBuild 17.0)、 16.0 (MSBuild 16.0) 15.0 、(MSBuild 15.0) 14.0 、(MSBuild 14.0) 12.0 、(MSBuild 12.0) 4.0 、(MSBuild 4.0)。既定値: 15.0。

優先バージョンが見つからない場合に、最新バージョンの使用を指定します。 macOS では、xbuild (Mono) または MSBuild (Visual Studio for Mac) が使用されます。

msbuildVersionOption - MSBuild のバージョン
入力エイリアス: msbuildVersion。 string. 省略可能。の場合は msbuildLocationMethod = versionを使用します。使用できる値: latest、 15.0 (MSBuild 15.0)、 14.0 (MSBuild 14.0) 12.0 、(MSBuild 12.0) 4.0 、(MSBuild 4.0)。既定値: 15.0。

msbuildFile - MSBuild の場所
入力エイリアス: msbuildLocation。 string. msbuildLocationMethod = location の場合に必要です。

省略可能。 MSBuild (Windows の場合) または xbuild (macOS の場合) へのパスを指定します。

msbuildArchitectureOption - MSBuild アーキテクチャ
入力エイリアス: msbuildArchitecture。 string. 省略可能。の場合は msbuildLocationMethod = versionを使用します。使用できる値: x86 (MSBuild x86)、 x64 (MSBuild x64)。既定値: x86。

実行する MSBuild のアーキテクチャ (x86、x64) を提供します。

msbuildArguments - 追加の引数
string.

MSBuild (Windows の場合) または xbuild (macOS の場合) に渡される追加の引数を指定します。

jdkOption - ビルドに使用する JDK を選択します
入力エイリアス: jdkSelection。 string. 必須です。使用できる値: JDKVersion (JDK バージョン)、 Path。既定値: JDKVersion。

ビルドプロセス中にタスクが使用する JDK バージョンを指定します。値は JDKVersion 、ビルド中にタスクが検出する JDK バージョンを指定します。値は Path 、JDK バージョンのファイルパスを指定します。

jdkVersionOption - JDK バージョン
入力エイリアス: jdkVersion。 string. 省略可能。の場合は jdkSelection = JDKVersionを使用します。使用できる値は、 default1.11 、(JDK 11)、 1.10 (JDK 10 (サポート対象外)、 1.9 (JDK 9 (サポート対象外)、 1.8 (JDK 8) 1.7 、(JDK 7)、 1.6 (JDK 6 (サポート対象外)) です。既定値: default。

ビルド中に使用する JDK バージョンを指定します。

jdkDirectory - JDK パス
入力エイリアス: jdkUserInputPath。 string. jdkSelection = Path の場合に必要です。

ビルド時にパスで使用する JDK バージョンを jdkSelection 指定します。

jdkArchitectureOption - JDK アーキテクチャ
入力エイリアス: jdkArchitecture。 string. 省略可能。の場合は jdkVersion != defaultを使用します。使用できる値: x86、x64。既定値: x64。

JDK のアーキテクチャ (x86、x64) を提供します。

タスク制御オプション

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

出力変数

[なし] :

解説

このタスクは、Xamarin で Android アプリをビルドするために使用します。

例

Xamarin アプリをビルドする

要件

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

XamarinAndroid@1 - Xamarin.Android v1 タスク

構文

入力

タスク制御オプション

出力変数

解説

例

要件

フィードバック

フィードバック

その他のリソース