XamariniOS@1 - Tugas Xamarin.iOS v1

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 v1
# Build an iOS app with Xamarin on macOS.
- task: XamariniOS@1
  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: true # boolean. Run NuGet restore. Default: true.
    #args: # string. Arguments. 
    #workingDirectory: # string. Alias: cwd. Working directory. 
    #buildToolOption: 'xbuild' # 'xbuild' | 'msbuild'. Alias: buildTool. Build tool. Default: xbuild.
    #mdtoolFile: # string. Alias: mdtoolLocation. Build tool path. 
  # Signing & Provisioning
    #signingOption: 'file' # 'file' | 'id'. Alias: signMethod. Override using. Default: file.
    #signingIdentity: # string. Alias: iosSigningIdentity. Optional. Use when signMethod = id. Signing identity. 
    #signingUnlockDefaultKeychain: false # boolean. Alias: unlockDefaultKeychain. Optional. Use when signMethod = id. Unlock default keychain. Default: false.
    #signingDefaultKeychainPassword: # string. Alias: defaultKeychainPassword. Optional. Use when signMethod = id. Default keychain password. 
    #signingProvisioningProfileID: # string. Alias: provProfileUuid. Optional. Use when signMethod = id. Provisioning profile UUID. 
    #signingP12File: # string. Alias: p12. Optional. Use when signMethod = file. P12 certificate file. 
    #signingP12Password: # string. Alias: p12pwd. Optional. Use when signMethod = file. P12 password. 
    #signingProvisioningProfileFile: # string. Alias: provProfile. Optional. Use when signMethod = file. Provisioning profile file. 
    #signingRemoveProfile: false # boolean. Alias: removeProfile. Optional. Use when signMethod = file. Remove profile after build. Default: false.

Input

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

Menentukan jalur relatif dari akar Xamarin.iOS repositori solusi 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: true.

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

workingDirectory - Direktori kerja
Alias input: cwd. string.

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

buildToolOption - Alat build
Alias input: buildTool. string. Nilai yang diizinkan: xbuild (xbuild (Xamarin Studio)), msbuild (MSBuild (Visual Studio untuk Mac)). Nilai default: xbuild.

Menentukan alat build yang akan digunakan tugas.

mdtoolFile - Jalur alat build
Alias input: 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.

signingOption - Mengesampingkan menggunakan
Alias input: signMethod. string. Nilai yang diizinkan: file (Konten File), id (Pengidentifikasi). Nilai default: file.

Gunakan input ini jika build menggunakan metode penandatanganan atau provisi yang berbeda dari default. Pilih file untuk menggunakan sertifikat P12 dan profil provisi. Pilih id untuk mengambil pengaturan penandatanganan dari Rantai Kunci default dan profil yang telah diinstal sebelumnya. Biarkan bidang terkait kosong jika Anda tidak ingin mengambil alih pengaturan build default.

signingIdentity - Identitas penandatanganan
Alias input: iosSigningIdentity. string. Pilihan. Gunakan saat signMethod = id.

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.

signingUnlockDefaultKeychain - Buka kunci rantai kunci default
Alias input: unlockDefaultKeychain. boolean. Pilihan. Gunakan saat signMethod = id. Nilai default: false.

Mengatasi kesalahan "Interaksi pengguna tidak diizinkan" dengan membuka kunci rantai kunci default.

signingDefaultKeychainPassword - Kata sandi rantai kunci default
Alias input: defaultKeychainPassword. string. Pilihan. Gunakan saat signMethod = id.

Menentukan kata sandi untuk membuka kunci rantai kunci default saat signingUnlockDefaultKeychain diatur.

signingProvisioningProfileID - UUID profil provisi
Alias input: provProfileUuid. string. Pilihan. Gunakan saat signMethod = id.

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

signingP12File - File sertifikat P12
Alias input: p12. string. Pilihan. Gunakan saat signMethod = file.

Menentukan jalur relatif ke file sertifikat P12 berformat PKCS12 yang berisi sertifikat penandatanganan yang akan digunakan untuk build ini.

signingP12Password - Kata sandi P12
Alias input: p12pwd. string. Pilihan. Gunakan saat signMethod = file.

Menentukan kata sandi ke file sertifikat P12. Gunakan variabel build untuk mengenkripsi nilai ini.

signingProvisioningProfileFile - Memprovisikan file profil
Alias input: provProfile. string. Pilihan. Gunakan saat signMethod = file.

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

signingRemoveProfile - Menghapus profil setelah build
Alias input: removeProfile. boolean. Pilihan. Gunakan saat signMethod = file. Nilai default: false.

Menentukan bahwa konten file profil provisi harus dihapus dari agen build setelah build selesai. Hanya aktifkan ini jika Anda menjalankan satu agen per pengguna..

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.

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