XamarinAndroid@1 - Xamarin.Android v1 工作

XamarinAndroid@1已被取代。 最初，此工作是用來使用 Xamarin 建置 Android 應用程式。

備註

此工作已被取代，且已於 2024 年 5 月 1 日淘汰。

語法

# 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
輸入別名：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 - 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）。

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時使用 。 允許的值為：default、1.11 （JDK 11）、1.10 （JDK 10 （不支援））、1.9 （JDK 9 （不支援））、1.8 （JDK 8）、1.7 （JDK 7）、1.6 （不支援 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
功能	此工作不符合作業中後續工作的任何需求。
命令限制	任意
Settable 變數	任意
代理程式版本	1.83.0 或更新
工作類別	建造