XamariniOS@2 - Tugas Xamarin.iOS v2

Artikel
06/11/2024

Gunakan tugas ini dalam alur untuk membangun aplikasi iOS dengan Xamarin di macOS. Untuk informasi selengkapnya, lihat panduan Xamarin dan Menandatangani aplikasi Anda selama CI.

Sintaks

# Xamarin.iOS v2
# Build an iOS app with Xamarin on macOS.
- task: XamariniOS@2
  inputs:
    solutionFile: '**/*.sln' # string. Alias: solution. Required. Solution. Default: **/*.sln.
    configuration: 'Release' # string. Required. Configuration. Default: Release.
    #clean: false # boolean. Clean. Default: false.
    #packageApp: true # boolean. Create app package. Default: true.
    #buildForSimulator: false # boolean. Alias: forSimulator. Build for iOS Simulator. Default: false.
  # Advanced
    #runNugetRestore: false # boolean. Run NuGet restore. Default: false.
    #args: # string. Arguments. 
    #workingDirectory: # string. Alias: cwd. Working directory. 
    #mdtoolFile: # string. Alias: buildToolLocation | mdtoolLocation. Build tool path. 
  # Signing & Provisioning
    #signingIdentity: # string. Alias: iosSigningIdentity. Signing identity. 
    #signingProvisioningProfileID: # string. Alias: provProfileUuid. Provisioning profile UUID.

Input

solutionFile - Solusi
Alias input: solution. string. Wajib diisi. Nilai default: **/*.sln.

Menentukan jalur relatif dari akar Xamarin.iOS repositori solusi atau proyek csproj ke build. Mungkin berisi kartubebas.

configuration - Konfigurasi
string. Wajib diisi. Nilai default: Release.

Menentukan konfigurasi. Konfigurasi standar adalah Ad-Hoc, AppStore, Debug, dan Release.

clean - Bersih
boolean. Nilai default: false.

Opsional. Menjalankan build bersih (/t:clean) sebelum build.

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

Jika diatur ke true, menghasilkan IPA sebagai bagian dari build.

buildForSimulator - Build untuk Simulator iOS
Alias input: forSimulator. boolean. Nilai default: false.

Pilihan. Build untuk Simulator iOS alih-alih perangkat iOS fisik.

runNugetRestore - Jalankan pemulihan NuGet
boolean. Nilai default: false.

nuget restore Berjalan pada solusi Xamarin iOS untuk menginstal semua paket yang dirujuk sebelum build. Alat nuget di PATH mesin agen build digunakan. Untuk menggunakan versi NuGet yang berbeda atau mengatur argumen tambahan, gunakan Tugas Penginstal NuGet.

args - Argumen
string.

Opsional. Menentukan argumen baris perintah tambahan yang digunakan untuk membangun.

workingDirectory - Direktori kerja
Alias input: cwd. string.

Pilihan. Menentukan direktori kerja tempat build akan berjalan. Jika nilai kosong, akar repositori digunakan.

mdtoolFile - Jalur alat build
Alias input: buildToolLocation | mdtoolLocation. string.

Pilihan. Memasok jalur ke xbuild (alat build mono Xamarin Studio) atau MSBuild (alat build Visual Studio untuk Mac). Jika nilai kosong, jalur xbuild atau MSBuild default digunakan.

signingIdentity - Identitas penandatanganan
Alias input: iosSigningIdentity. string.

Pilihan. Mengambil alih identitas penandatanganan yang akan digunakan untuk menandatangani build. Jika nilai kosong, pengaturan dalam proyek Xcode akan digunakan. Anda mungkin perlu memilih signingUnlockDefaultKeychain jika Anda menggunakan opsi ini.

signingProvisioningProfileID - UUID profil provisi
Alias input: provProfileUuid. string.

Pilihan. Menentukan UUID dari penimpaan profil provisi yang terinstal yang akan digunakan untuk build ini.

Opsi kontrol tugas

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

Variabel output

Tidak ada.

Keterangan

Gunakan tugas ini dalam alur untuk membangun aplikasi iOS dengan Xamarin di macOS. Untuk informasi selengkapnya, lihat panduan Xamarin dan Menandatangani aplikasi Anda selama CI.

Apa yang baru dalam versi tugas ini

Pengaturan pendaftaran iOS telah dihapus dari tugas. Gunakan Secure Files dengan tugas Install Apple Certificate pendukung dan Install Apple Provisioning Profile untuk menyiapkan penandatanganan. Opsi yang diperbarui untuk bekerja lebih baik dengan Visual Studio for Mac.

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: Xamarin.iOS
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	Semua versi agen yang didukung.
Kategori tugas	Build

Bagikan melalui