XamarinAndroid@1 - tugas Xamarin.Android v1

Gunakan tugas ini untuk membuat aplikasi Android dengan Xamarin.

Sintaks

# 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.

Input

projectFile - Proyek
Alias input: project. string. Wajib diisi. Nilai default: **/*.csproj.

Menentukan jalur relatif dari akar repositori Xamarin.Android proyek yang akan dibangun. Wildcard dapat digunakan. Untuk informasi selengkapnya, lihat Referensi pola pencocokan file. Misalnya, **/*.csproj untuk semua file csproj di semua subfolder. Proyek harus memiliki PackageForAndroid target jika Create App Package dipilih.

target - Target
string.

Menentukan target mana yang akan dibangun dalam proyek ini. Gunakan titik koma untuk memisahkan beberapa target.

outputDirectory - Direktori output
Alias input: outputDir. string.

Pilihan. Menyediakan direktori output untuk build. Contoh: $(build.binariesDirectory)/bin/Release.

configuration - Konfigurasi
string.

Menentukan konfigurasi yang ingin Anda buat. Misalnya, debug atau release.

Tip

Deklarasikan variabel build seperti BuildConfiguration pada tab variabel (memilih Allow pada Waktu Antrean) dan mereferensikannya di sini sebagai $(BuildConfiguration). Anda kemudian dapat memodifikasi platform saat mengantre build dan mengaktifkan pembuatan beberapa konfigurasi.

createAppPackage - Membuat paket aplikasi
boolean. Nilai default: true.

Melewati target, (/t:PackageForAndroid), selama build untuk menghasilkan APK.

clean - Bersih
boolean. Nilai default: false.

Melewati target bersih, (/t:clean), selama build.

msbuildLocationOption - MSBuild
Alias input: msbuildLocationMethod. string. Nilai yang diizinkan: version, location (Tentukan Lokasi). Nilai default: version.

Menentukan jalur ke MSBuild (di Windows) atau xbuild (di macOS). Perilaku defaultnya adalah mencari versi terbaru.

msbuildVersionOption - Versi MSBuild
Alias input: msbuildVersion. string. Opsional. Gunakan saat msbuildLocationMethod = version. Nilai yang diizinkan: 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). Nilai default: 15.0.

Menentukan penggunaan versi terbaru jika versi pilihan tidak dapat ditemukan. Di macOS, xbuild (Mono) atau MSBuild (Visual Studio untuk Mac) akan digunakan.

msbuildFile - Lokasi MSBuild
Alias input: msbuildLocation. string. Diperlukan saat msbuildLocationMethod = location.

Pilihan. Memasok jalur ke MSBuild (di Windows) atau xbuild (di macOS).

msbuildArchitectureOption - Arsitektur MSBuild
Alias input: msbuildArchitecture. string. Opsional. Gunakan saat msbuildLocationMethod = version. Nilai yang diizinkan: x86 (MSBuild x86), x64 (MSBuild x64). Nilai default: x86.

Memasok arsitektur (x86, x64) dari MSBuild yang ingin Anda jalankan.

msbuildArguments - Argumen tambahan
string.

Menentukan argumen tambahan yang diteruskan ke MSBuild (di Windows) atau xbuild (di macOS).

jdkOption - Pilih JDK yang akan digunakan untuk build
Alias input: jdkSelection. string. Wajib diisi. Nilai yang diizinkan: JDKVersion (Versi JDK), Path. Nilai default: JDKVersion.

Menentukan versi JDK yang digunakan tugas selama proses build. Nilai JDKVersion menentukan versi JDK yang ditemukan tugas selama build. Nilai Path menentukan jalur file untuk versi JDK.

jdkVersionOption - Versi JDK
Alias input: jdkVersion. string. Pilihan. Gunakan saat jdkSelection = JDKVersion. Nilai yang diizinkan: default, 1.11 (JDK 11), 1.10 (JDK 10 (di luar dukungan)), 1.9 (JDK 9 (di luar dukungan)), 1.8 (JDK 8), 1.7 (JDK 7), 1.6 (JDK 6 (di luar dukungan)). Nilai default: default.

Menentukan versi JDK yang akan digunakan selama build.

jdkDirectory - Jalur JDK
Alias input: jdkUserInputPath. string. Diperlukan saat jdkSelection = Path.

Menentukan versi JDK yang akan digunakan selama build di jdkSelection jalur.

jdkArchitectureOption - Arsitektur JDK
Alias input: jdkArchitecture. string. Pilihan. Gunakan saat jdkVersion != default. Nilai yang diizinkan: x86, x64. Nilai default: x64.

Memasok arsitektur (x86, x64) JDK.

Opsi kontrol tugas

Semua tugas memiliki opsi kontrol selain input tugas mereka. Untuk informasi selengkapnya, lihat Opsi kontrol dan properti tugas umum.

Variabel output

Tidak ada.

Keterangan

Gunakan tugas ini untuk membuat aplikasi Android dengan Xamarin.

Contoh

• Membangun aplikasi Xamarin Anda

Persyaratan

Persyaratan	Deskripsi
Jenis alur	YAML, Build klasik
Berjalan pada	Agen, DeploymentGroup
Permintaan	Agen yang dihost sendiri harus memiliki kemampuan yang sesuai dengan tuntutan berikut untuk menjalankan pekerjaan yang menggunakan tugas ini: MSBuild, Xamarin.Android
Kemampuan	Tugas ini tidak memenuhi tuntutan apa pun untuk tugas berikutnya dalam pekerjaan.
Pembatasan perintah	Apa pun
Variabel yang dapat diatur	Apa pun
Versi agen	1.83.0 atau lebih tinggi
Kategori tugas	Build