XamarinAndroid@1 - Xamarin.Android v1 工作

使用此工作來建置具有 Xamarin 的 Android 應用程式。

Syntax

# 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 時為必要。

選擇性。 在macOS) ) 上提供 MSBuild (的路徑，或在macOS上提供 xbuild (。

msbuildArchitectureOption - MSBuild 架構
輸入別名： msbuildArchitecture。 string. 選擇性。 使用時機 msbuildLocationMethod = version。 允許的值： x86 (MSBuild x86) ， x64 (MSBuild x64) 。 預設值：x86。

提供您想要執行的 MSBuild (x86、x64) 架構。

msbuildArguments - 其他自變數
string.

指定在macOS) 上傳遞至 MSBuild () 或 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
Capabilities	此工作不符合作業中後續工作的任何需求。
命令限制	任何
Settable 變數	任何
代理程式版本	1.83.0 或更新版本
工作類別	建置