XamarinAndroid@1 - Xamarin.Android v1 任务

使用此任务通过 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.

输入

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。

指定 Windows) 上的 MSBuild (或 macOS) 上的 xbuild (的路径。 默认行为是搜索最新版本。

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) 。

msbuildFile - MSBuild 位置
输入别名： msbuildLocation。 string. 当 msbuildLocationMethod = location 时，需要此选项。

可选。 提供 Windows) 上的 MSBuild (或 macOS) 上的 xbuild (的路径。

msbuildArchitectureOption - MSBuild 体系结构
输入别名： msbuildArchitecture。 string. 可选。 在 时 msbuildLocationMethod = version使用 。 允许的值： x86 (MSBuild x86) ， x64 (MSBuild x64) 。 默认值：x86。

提供要运行的 MSBuild (x86、x64) 体系结构。

msbuildArguments - 其他参数
string.

指定传递给 Windows) 上的 MSBuild (或 macOS) 上的 xbuild (的其他参数。

jdkOption - 选择要用于生成的 JDK
输入别名： jdkSelection。 string. 必需。 允许的值： JDKVersion (JDK 版本) 。 Path 默认值：JDKVersion。

指定任务在生成过程中使用的 JDK 版本。 JDKVersion值指定任务在生成期间发现的 JDK 版本。 值 Path 指定 JDK 版本的文件路径。

jdkVersionOption - JDK 版本
输入别名： jdkVersion。 string. 可选。 在 时 jdkSelection = JDKVersion使用 。 允许的值： default、 1.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 时，需要此选项。

指定在路径处生成 jdkSelection 期间要使用的 JDK 版本。

jdkArchitectureOption - JDK 体系结构
输入别名： jdkArchitecture。 string. 可选。 在 时 jdkVersion != default使用 。 允许的值：x86、x64。 默认值：x64。

提供 JDK (x86、x64) 体系结构。

任务控制选项

除了任务输入，所有任务都有控制选项。 有关详细信息，请参阅 控制选项和常见任务属性。

输出变量

无。

备注

使用此任务通过 Xamarin 生成 Android 应用。

示例

• 生成 Xamarin 应用

要求

要求	说明
管道类型	YAML，经典版本
运行平台	Agent、DeploymentGroup
需求	自承载代理必须具有满足以下要求的功能才能运行使用此任务的作业：MSBuild、Xamarin.Android
功能	此任务不满足作业中后续任务的任何要求。
命令限制	任意
可设置变量	任意
代理版本	1.83.0 或更高版本
任务类别	构建