Xcode@5 - Tugas Xcode v5

Gunakan tugas ini untuk membangun, menguji, atau mengarsipkan ruang kerja Xcode di macOS, dan secara opsional mengemas aplikasi.

Sintaks

# Xcode v5
# Build, test, or archive an Xcode workspace on macOS. Optionally package an app.
- task: Xcode@5
  inputs:
    actions: 'build' # string. Required. Actions. Default: build.
    #configuration: '$(Configuration)' # string. Configuration. Default: $(Configuration).
    #sdk: '$(SDK)' # string. SDK. Default: $(SDK).
    #xcWorkspacePath: '**/*.xcodeproj/project.xcworkspace' # string. Workspace or project path. Default: **/*.xcodeproj/project.xcworkspace.
    #scheme: # string. Scheme. 
    #xcodeVersion: 'default' # '8' | '9' | '10' | '11' | '12' | '13' | 'default' | 'specifyPath'. Xcode version. Default: default.
    #xcodeDeveloperDir: # string. Optional. Use when xcodeVersion == specifyPath. Xcode developer path. 
  # Package options
    #packageApp: false # boolean. Create app package. Default: false.
    #archivePath: # string. Optional. Use when packageApp == true. Archive path. 
    #exportPath: 'output/$(SDK)/$(Configuration)' # string. Optional. Use when packageApp == true. Export path. Default: output/$(SDK)/$(Configuration).
    #exportOptions: 'auto' # 'auto' | 'plist' | 'specify'. Optional. Use when packageApp == true. Export options. Default: auto.
    #exportMethod: 'development' # string. Required when exportOptions == specify. Export method. Default: development.
    #exportTeamId: # string. Optional. Use when exportOptions == specify. Team ID. 
    #exportOptionsPlist: # string. Required when exportOptions == plist. Export options plist. 
    #exportArgs: # string. Optional. Use when packageApp == true. Export arguments. 
  # Signing & provisioning
    #signingOption: 'nosign' # 'nosign' | 'default' | 'manual' | 'auto'. Signing style. Default: nosign.
    #signingIdentity: # string. Optional. Use when signingOption = manual. Signing identity. 
    #provisioningProfileUuid: # string. Optional. Use when signingOption = manual. Provisioning profile UUID. 
    #provisioningProfileName: # string. Optional. Use when signingOption = manual. Provisioning profile name. 
    #teamId: # string. Optional. Use when signingOption = auto. Team ID. 
  # Devices & simulators
    #destinationPlatformOption: 'default' # 'default' | 'iOS' | 'tvOS' | 'macOS' | 'custom'. Destination platform. Default: default.
    #destinationPlatform: # string. Optional. Use when destinationPlatformOption == custom. Custom destination platform. 
    #destinationTypeOption: 'simulators' # 'simulators' | 'devices'. Optional. Use when destinationPlatformOption != default && destinationPlatformOption != macOS. Destination type. Default: simulators.
    #destinationSimulators: # string. Optional. Use when destinationPlatformOption != default && destinationPlatformOption != macOS && destinationTypeOption == simulators. Simulator. 
    #destinationDevices: # string. Optional. Use when destinationPlatformOption != default && destinationPlatformOption != macOS && destinationTypeOption == devices. Device. 
  # Advanced
    #args: # string. Arguments. 
    #workingDirectory: # string. Alias: cwd. Working directory. 
    #useXcpretty: true # boolean. Use xcpretty. Default: true.
    #xcprettyArgs: # string. Optional. Use when useXcpretty == true. Xcpretty arguments. 
    #publishJUnitResults: false # boolean. Publish test results to Azure Pipelines. Default: false.
    #testRunTitle: # string. Optional. Use when publishJUnitResults == true. Test run title.

Input

actions - Tindakan
string. Wajib diisi. Nilai default: build.

Menentukan daftar tindakan yang dibatasi spasi. Beberapa opsi yang valid adalah build, , cleantest, analyze, dan archive. Misalnya,clean build melakukan build bersih. Lihat Apple: Membangun dari baris perintah dengan FAQ Xcode.

configuration - Konfigurasi
string. Nilai default: $(Configuration).

Menentukan proyek Xcode atau konfigurasi ruang kerja yang akan dibangun. Saat menggunakan variabel, tentukan nilai (misalnya, Release) pada tab Variabel .

sdk - SDK
string. Nilai default: $(SDK).

Menentukan SDK yang akan digunakan saat membangun proyek atau ruang kerja Xcode. Dari aplikasi Terminal macOS, jalankan xcodebuild -showsdks untuk menampilkan daftar SDK yang valid. Saat menggunakan variabel, tentukan nilai (misalnya, iphonesimulator) pada tab Variabel .

xcWorkspacePath - Ruang kerja atau jalur proyek
string. Nilai default: **/*.xcodeproj/project.xcworkspace.

Pilihan. Menentukan jalur relatif dari akar repositori ke ruang kerja atau proyek Xcode. Misalnya, MyApp/MyApp.xcworkspace atau MyApp/MyApp.xcodeproj. Wildcard dapat digunakan. Pelajari selengkapnya tentang pola pencocokan file.

scheme - Skema
string.

Pilihan. Menentukan nama skema Xcode. Harus berupa skema bersama (kotak centang bersama di bawah Skema Terkelola di Xcode). Jika Anda tidak menentukan skema, dan ruang kerja yang ditentukan memiliki satu skema bersama, skema ruang kerja akan digunakan.

xcodeVersion - Versi Xcode
string. Nilai yang diizinkan: 8 (Xcode 8), 9 (Xcode 9), 10 (Xcode 10), 11 (Xcode 11), 12 (Xcode 12), 13 (Xcode 13), default, specifyPath (Tentukan jalur). Nilai default: default.

Menentukan versi target Xcode. Pilih Default untuk menggunakan versi default Xcode pada komputer agen. Menentukan nomor versi (misalnya, Xcode 9) bergantung pada lokasi versi yang akan diatur oleh variabel lingkungan pada komputer agen (misalnya, XCODE_9_DEVELOPER_DIR=/Applications/Xcode_9.0.0.app/Contents/Developer). Pilih Specify path untuk menyediakan jalur tertentu ke direktori pengembang Xcode.

xcodeDeveloperDir - Jalur pengembang Xcode
string. Opsional. Gunakan saat xcodeVersion == specifyPath.

Menentukan jalur ke direktori pengembang Xcode tertentu (misalnya, /Applications/Xcode_9.0.0.app/Contents/Developer). Input ini berguna ketika beberapa versi Xcode diinstal pada mesin agen.

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

Menentukan apakah file paket aplikasi IPA dihasilkan sebagai bagian dari build.

archivePath - Jalur arsip
string. Pilihan. Gunakan saat packageApp == true.

Menentukan direktori tempat arsip yang dibuat ditempatkan.

exportPath - Jalur ekspor
string. Pilihan. Gunakan saat packageApp == true. Nilai default: output/$(SDK)/$(Configuration).

Menentukan tujuan untuk produk yang diekspor dari arsip.

exportOptions - Opsi ekspor
string. Pilihan. Gunakan saat packageApp == true. Nilai yang diizinkan: auto (Otomatis), plist, specify. Nilai default: auto.

Menentukan opsi untuk mengekspor arsip. Ketika nilai Automatic default dipilih, metode ekspor secara otomatis terdeteksi dari arsip. Pilih Plist untuk menentukan file plist yang berisi opsi ekspor. Pilih Specify untuk menyediakan metode Ekspor dan ID Tim tertentu.

exportMethod - Metode ekspor
string. Diperlukan saat exportOptions == specify. Nilai default: development.

Menentukan metode yang digunakan Xcode untuk mengekspor arsip. Misalnya: app-store, package, ad-hoc, enterprise, atau development.

exportTeamId - ID Tim
string. Opsional. Gunakan saat exportOptions == specify.

Menentukan ID tim 10 karakter Portal Pengembang Apple untuk digunakan selama ekspor.

exportOptionsPlist - Plist opsi ekspor
string. Diperlukan saat exportOptions == plist.

Menentukan jalur ke file plist yang berisi opsi untuk digunakan selama ekspor.

exportArgs - Mengekspor argumen
string. Pilihan. Gunakan saat packageApp == true.

Menentukan argumen baris perintah tambahan yang digunakan selama ekspor.

signingOption - Gaya penandatanganan
string. Nilai yang diizinkan: nosign (Tanda jangan kode), default (Default proyek), manual (Penandatanganan manual), auto (Penandatanganan otomatis). Nilai default: nosign.

Menentukan metode penandatanganan build. Pilih Do not code sign untuk menonaktifkan penandatanganan. Pilih Project defaults untuk hanya menggunakan konfigurasi penandatanganan proyek. Pilih Manual signing untuk memaksa penandatanganan manual dan secara opsional menentukan identitas penandatanganan dan profil provisi. Pilih Automatic signing untuk memaksa penandatanganan otomatis dan secara opsional menentukan ID tim pengembangan. Jika proyek Anda memerlukan penandatanganan, gunakan tugas Instal Apple... untuk menginstal sertifikat dan profil provisi sebelum build Xcode.

signingIdentity - Identitas penandatanganan
string. Pilihan. Gunakan saat signingOption = manual.

Menentukan penandatanganan pengesampingan identitas untuk menandatangani build. Membuka kunci rantai kunci default pada mesin agen mungkin diperlukan. Jika tidak ada nilai yang dimasukkan, pengaturan proyek Xcode akan digunakan.

provisioningProfileUuid - UUID profil provisi
string. Pilihan. Gunakan saat signingOption = manual.

Menentukan UUID profil provisi terinstal yang digunakan untuk build. Gunakan tugas build terpisah dengan skema atau target yang berbeda untuk menentukan profil provisi berdasarkan target dalam satu ruang kerja (iOS, tvOS, watchOS).

provisioningProfileName - Nama profil provisi
string. Pilihan. Gunakan saat signingOption = manual.

Menentukan nama profil provisi terinstal yang digunakan untuk build. Jika ditentukan, ini lebih diutamakan daripada UUID profil provisi. Gunakan tugas build terpisah dengan skema atau target yang berbeda untuk menentukan profil provisi berdasarkan target dalam satu ruang kerja (iOS, tvOS, watchOS).

teamId - ID Tim
string. Opsional. Gunakan saat signingOption = auto.

Diperlukan jika Anda adalah anggota dari beberapa tim pengembangan. Menentukan ID tim pengembangan 10 karakter.

destinationPlatformOption - Platform tujuan
string. Nilai yang diizinkan: default, iOS (iOS dan watchOS), tvOS, macOS, custom. Nilai default: default.

Menentukan platform perangkat tujuan yang digunakan untuk pengujian UI saat perangkat build generik tidak valid. Pilih Custom untuk menentukan platform yang tidak disertakan dalam daftar ini. Ketika Default dipilih, tidak ada simulator atau perangkat yang ditargetkan.

destinationPlatform - Platform tujuan kustom
string. Opsional. Gunakan saat destinationPlatformOption == custom.

Menentukan platform perangkat tujuan yang digunakan untuk pengujian UI saat perangkat build generik tidak valid. Pilih Custom untuk menentukan platform yang tidak disertakan dalam daftar. Ketika Default dipilih, tidak ada simulator atau perangkat yang ditargetkan.

destinationTypeOption - Jenis tujuan
string. Pilihan. Gunakan saat destinationPlatformOption != default && destinationPlatformOption != macOS. Nilai yang diizinkan: simulators (Simulator), devices (Perangkat Tersambung). Nilai default: simulators.

Menentukan jenis tujuan yang akan digunakan untuk pengujian UI. Perangkat harus tersambung ke Mac yang melakukan build melalui kabel atau koneksi jaringan. Lihat Perangkat dan Simulator di Xcode untuk informasi selengkapnya.

destinationSimulators - Simulator
string. Opsional. Gunakan saat destinationPlatformOption != default && destinationPlatformOption != macOS && destinationTypeOption == simulators.

Menentukan nama simulator Xcode yang digunakan untuk pengujian UI. Misalnya, iPhone X (iOS dan watchOS) atau Apple TV 4K (tvOS). Versi OS target opsional dapat ditentukan dalam format OS=<versionNumber>, seperti iPhone X,OS=11.1. Lihat daftar simulator ini yang diinstal pada agen macOS yang dihosting untuk informasi selengkapnya.

destinationDevices - Perangkat
string. Pilihan. Gunakan saat destinationPlatformOption != default && destinationPlatformOption != macOS && destinationTypeOption == devices.

Menentukan nama perangkat yang digunakan untuk pengujian UI, seperti Raisa's iPad. Hanya satu perangkat yang saat ini didukung. Perhatikan bahwa Apple tidak mengizinkan apostrof (') dalam nama perangkat. Sebaliknya, tanda' kutip tunggal () yang tepat dapat digunakan.

args - Argumen
string.

Pilihan. Menentukan argumen baris perintah tambahan yang akan dibuat. Input ini berguna untuk menentukan -target atau -project argumen alih-alih ruang kerja/proyek dan skema. Lihat Apple: Membangun dari baris perintah dengan FAQ Xcode.

workingDirectory - Direktori kerja
Alias input: cwd. string.

Pilihan. Menentukan direktori kerja untuk menjalankan build. Jika tidak ada nilai yang dimasukkan, akar repositori akan digunakan.

useXcpretty - Gunakan xcpretty
boolean. Nilai default: true.

Menentukan apakah akan digunakan xcpretty untuk memformat xcodebuild output. xcpretty harus diinstal pada mesin agen (Sudah diinstal sebelumnya pada agen build yang dihosting Azure Pipelines). Jika xcpretty tidak diinstal, output mentah xcodebuild ditampilkan. Lihat xcpretty untuk informasi selengkapnya.

xcprettyArgs - Argumen Xcpretty
string. Pilihan. Gunakan saat useXcpretty == true.

Jika xcpretty diaktifkan, input ini menentukan argumen untuk xcpretty. Lihat daftar argumen xcpretty di GitHub.

publishJUnitResults - Menerbitkan hasil pengujian ke Azure Pipelines
boolean. Nilai default: false.

Menentukan apakah akan menerbitkan hasil pengujian JUnit ke Azure Pipelines. Ini perlu xcpretty diaktifkan untuk menghasilkan hasil pengujian JUnit.

testRunTitle - Judul uji coba
string. Pilihan. Gunakan saat publishJUnitResults == true.

Jika xcpretty dan publishJUnitResults diaktifkan, Anda dapat menentukan judul uji coba.

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 membangun, menguji, atau mengarsipkan ruang kerja Xcode di macOS, dan secara opsional mengemas aplikasi.

Menggunakan beberapa profil provisi

Saat ini tidak ada dukungan beberapa profil provisi untuk tugas Xcode (misalnya untuk Ekstensi Aplikasi iOS).

Contoh

Membangun aplikasi Xcode Anda

Persyaratan

Persyaratan	Deskripsi
Jenis alur	YAML, Build klasik
Berjalan pada	Agen, DeploymentGroup
Permintaan	Agen yang dihost sendiri harus memiliki kemampuan yang cocok dengan tuntutan berikut untuk menjalankan pekerjaan yang menggunakan tugas ini: xcode
Kemampuan	Tugas ini tidak memenuhi tuntutan 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