Xcode@2 - Xcode Derleme v2 görevi
macOS üzerinde bir Xcode çalışma alanı oluşturmak için bu görevi kullanın.
Syntax
# Xcode Build v2
# Build an Xcode workspace on Mac OS.
- task: Xcode@2
inputs:
actions: 'build' # string. Required. Actions. Default: build.
#configuration: '$(Configuration)' # string. Configuration. Default: $(Configuration).
#sdk: '$(SDK)' # string. SDK. Default: $(SDK).
#xcWorkspacePath: '**/*.xcodeproj/*.xcworkspace' # string. Workspace/Project Path. Default: **/*.xcodeproj/*.xcworkspace.
#scheme: # string. Scheme.
#packageApp: true # boolean. Create App Package. Default: true.
# Package Options
packageTool: 'xcodebuild' # 'xcrun' | 'xcodebuild'. Required. Create Package (IPA) using. Default: xcodebuild.
#archivePath: # string. Optional. Use when packageTool == xcodebuild. Archive Path.
#exportPath: 'output/$(SDK)/$(Configuration)' # string. Optional. Use when packageTool == xcodebuild. Export Path. Default: output/$(SDK)/$(Configuration).
#exportOptions: 'auto' # 'auto' | 'plist' | 'specify'. Optional. Use when packageTool == xcodebuild. 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.
# Signing & Provisioning
#xcode8AutomaticSigning: false # boolean. Automatic Signing. Default: false.
#teamId: # string. Optional. Use when xcode8AutomaticSigning = true. Team ID.
#signMethod: 'file' # 'file' | 'id'. Override Using. Default: file.
#iosSigningIdentity: # string. Optional. Use when signMethod = id. Signing Identity.
#unlockDefaultKeychain: false # boolean. Optional. Use when signMethod = id. Unlock Default Keychain. Default: false.
#defaultKeychainPassword: # string. Optional. Use when signMethod = id. Default Keychain Password.
#provProfileUuid: # string. Optional. Use when signMethod = id. Provisioning Profile UUID.
#p12: # string. Optional. Use when signMethod = file. P12 Certificate File.
#p12pwd: # string. Optional. Use when signMethod = file. P12 Password.
#provProfile: # string. Optional. Use when signMethod = file. Provisioning Profile File.
#removeProfile: false # boolean. Optional. Use when signMethod = file. Remove Profile After Build. Default: false.
# Advanced
#args: # string. Arguments.
#cwd: # string. Working Directory.
outputPattern: 'output/$(SDK)/$(Configuration)' # string. Required. Output Directory. Default: output/$(SDK)/$(Configuration).
#xcodeDeveloperDir: # string. Xcode Developer Path.
#useXcpretty: false # boolean. Use xcpretty. Default: false.
#publishJUnitResults: false # boolean. Publish to VSTS/TFS. Default: false.
# xctool (deprecated)
#useXctool: # boolean. Use xctool.
#xctoolReporter: # string. xctool Test Reporter Format.
Girişler
actions
- Eylem
string
. Gereklidir. Varsayılan değer: build
.
Boşlukla ayrılmış eylem listesini belirtir. Geçerli seçenekler : build
, clean
, test
, analyze
ve archive
. Örneğin, build clean
temiz bir derleme gerçekleştirir. Bkz. Apple: Xcode SSS ile komut satırından oluşturma.
configuration
- Yapılandırma
string
. Varsayılan değer: $(Configuration)
.
Derlemek için Xcode projesini veya çalışma alanı yapılandırmasını belirtir. Değişken kullanırken, Değişkenler sekmesinde bir değer (örneğin, Release
) belirtin.
sdk
- SDK
string
. Varsayılan değer: $(SDK)
.
Belirtilen SDK'ya göre bir Xcode projesi veya çalışma alanı oluşturur. Geçerli BIR SDK listesi görmek için komutunu çalıştırın xcodebuild -showsdks
.
xcWorkspacePath
- Çalışma Alanı/Proje Yolu
string
. Varsayılan değer: **/*.xcodeproj/*.xcworkspace
.
İsteğe bağlı. Depo kökünden Xcode çalışma alanına veya projesine göreli yolu belirtir. Örneğin: MyApp/MyApp.xcworkspace
veya MyApp/MyApp.xcworkspace/MyApp.xcodeproj
.
Gelişmiş Bağımsız Değişkenler altında kullanmak -target flag
istiyorsanız boş bırakın.
scheme
- Düzeni
string
.
İsteğe bağlı. Xcode düzeni adını belirtir. Paylaşılan bir düzen olmalıdır (Xcode'da Yönetilen Düzenler altında paylaşılan onay kutusu). Çalışma Alanı belirtilirse gereklidir.
packageApp
- Uygulama Paketi Oluştur
boolean
. Varsayılan değer: true
.
Derlemenin bir parçası olarak bir IPA oluşturulup oluşturulmayacağını belirtir. Xcode 7 ve Xcode 8 ile arşivleri dışarı aktarmak için Paket Seçenekleri bölümündeki ek girişleri gözden geçirin.
packageTool
- kullanarak Paket Oluşturma (IPA)
string
. Gereklidir. İzin verilen değerler: xcrun
(xcrun (Apple tarafından kullanım dışı)), xcodebuild
(xcodebuild arşiv ve dışarı aktarma). Varsayılan değer: xcodebuild
.
IPA oluşturmak için kullanılacak aracı belirtir.
archivePath
- Arşiv Yolu
string
. İsteğe bağlı. olduğunda packageTool == xcodebuild
kullanın.
Oluşturulan arşivlerin yerleştirildiği dizini belirtir.
exportPath
- Dışarı Aktarma Yolu
string
. İsteğe bağlı. olduğunda packageTool == xcodebuild
kullanın. Varsayılan değer: output/$(SDK)/$(Configuration)
.
Arşivden dışarı aktarılan ürünün hedefini belirtir.
exportOptions
- Dışarı Aktarma Seçenekleri
string
. İsteğe bağlı. olduğunda packageTool == xcodebuild
kullanın. İzin verilen değerler: auto
, plist
, specify
. Varsayılan değer: auto
.
Arşivi dışarı aktarırken Dışarı Aktarma Seçenekleri'ni geçirmenin bir yolunu belirtir.
exportMethod
- Dışarı Aktarma Yöntemi
string
. olduğunda exportOptions == specify
gereklidir. Varsayılan değer: development
.
Xcode'un arşivi dışarı aktarmak için kullandığı yöntemi belirtir. Örneğin, app-store
, package
, ad-hoc
, enterprise
veya development
.
exportTeamId
- Ekip Kimliği
string
. İsteğe bağlı. olduğunda exportOptions == specify
kullanın.
Dışarı aktarma için kullanılacak Apple Geliştirici Portalı 10 basamaklı ekip kimliğini belirtir.
exportOptionsPlist
- Dışarı Aktarma Seçenekleri Plist
string
. olduğunda exportOptions == plist
gereklidir.
Arşiv dışarı aktarmayı yapılandıran bir plist dosyasının yolunu belirtir.
xcode8AutomaticSigning
- Otomatik İmzalama
boolean
. Varsayılan değer: false
.
Otomatik İmzalama için yapılandırılmış bir Xcode 8 veya Xcode 9 projeniz varsa bu girişi kullanın.
teamId
- Ekip Kimliği
string
. İsteğe bağlı. olduğunda xcode8AutomaticSigning = true
kullanın.
10 basamaklı geliştirici ekip kimliğini belirtir. Birden çok geliştirme ekibine üyeyseniz bu gereklidir.
signMethod
- Kullanarak Geçersiz Kıl
string
. İzin verilen değerler: file
(Dosya İçeriği), id
(Tanımlayıcılar). Varsayılan değer: file
.
Derleme varsayılandan farklı bir imzalama veya sağlama yöntemi kullanıyorsa bu girişi kullanın. P12 sertifikası ve sağlama profili kullanmayı seçin File Contents
. varsayılan anahtar zincirinden ve önceden yüklenmiş profillerden imzalama ayarlarını almayı seçin Identifiers
. Varsayılan derleme ayarlarını geçersiz kılmak istemiyorsanız ilgili alanları boş bırakın.
iosSigningIdentity
- İmzalama Kimliği
string
. İsteğe bağlı. olduğunda signMethod = id
kullanın.
Derlemeyi imzalamak için kullanılan imzalama kimliğini geçersiz kılmayı belirtir. Varsayılan olarak Xcode proje ayarını kullanır. Varsayılan Anahtar zincirinin kilidinin açılması gerekebilir.
unlockDefaultKeychain
- Varsayılan Anahtar zincirinin kilidini açma
boolean
. İsteğe bağlı. olduğunda signMethod = id
kullanın. Varsayılan değer: false
.
Varsayılan anahtar zincirinin kilidini açarak Kullanıcı etkileşime izin verilmiyor hatalarını giderir.
defaultKeychainPassword
- Varsayılan AnahtarLık Parolası
string
. İsteğe bağlı. olduğunda signMethod = id
kullanın.
Varsayılan anahtar zincirinin kilidini açmak için parolayı belirtir.
provProfileUuid
- Sağlama Profili UUID
string
. İsteğe bağlı. olduğunda signMethod = id
kullanın.
Derleme için kullanılacak yüklü sağlama profilinin UUID değerini belirtir. Tek bir çalışma alanında (iOS, WatchKit, tvOS) hedefe göre sağlama profilleri belirtmek için farklı şemalara veya hedeflere sahip ayrı derleme görevleri kullanın.
p12
- P12 Sertifika Dosyası
string
. İsteğe bağlı. olduğunda signMethod = file
kullanın.
Derleme için kullanılacak bir imzalama sertifikası içeren PKCS12 biçimlendirilmiş P12 sertifika dosyasının göreli yolunu belirtir.
p12pwd
- P12 Parolası
string
. İsteğe bağlı. olduğunda signMethod = file
kullanın.
Belirtildiyse P12 sertifika dosyasının parolasını belirtir. Şifrelemek için bir derleme değişkeni kullanın.
provProfile
- Profil Dosyası Sağlama
string
. İsteğe bağlı. olduğunda signMethod = file
kullanın.
Derleme için kullanılacak sağlama profili geçersiz kılmasını içeren dosyanın göreli yolunu belirtir. Tek bir çalışma alanında (iOS, WatchKit, tvOS) hedefe göre sağlama profilleri belirtmek için farklı şemalara veya hedeflere sahip ayrı derleme görevleri kullanın.
removeProfile
- Derlemeden Sonra Profili Kaldır
boolean
. İsteğe bağlı. olduğunda signMethod = file
kullanın. Varsayılan değer: false
.
Derleme tamamlandıktan sonra sağlama profili dosyasının içeriğini derleme aracısından kaldırır. Yalnızca kullanıcı başına bir aracı çalıştırılıp çalıştırılamadığını denetleyin.
args
- Bağımsız değişken
string
.
Derlemek için kullanılan ek komut satırı bağımsız değişkenlerini belirtir. Bu giriş, bir çalışma alanı ve düzen belirtmek yerine kullanmak -target
-project
istediğinizde yararlıdır.
cwd
- Çalışma Dizini
string
.
Derleme çalıştırmaları için çalışma dizinini belirtir. Varsayılan olarak deponun köküne ayarlanır.
outputPattern
- Çıkış Dizini
string
. Gereklidir. Varsayılan değer: output/$(SDK)/$(Configuration)
.
Derleme çıkışının (ikili) yerleştirildiği göreli yolu belirtir.
xcodeDeveloperDir
- Xcode Geliştirici Yolu
string
.
İsteğe bağlı. Sistem varsayılanı değilse Xcode Geliştirici klasörünün yolunu belirtir. Bir sisteme Xcode'un birden çok sürümü yüklendiğinde kullanım için. Örneğin: /Applications/Xcode 7.app/Contents/Developer
.
useXcpretty
- xcpretty kullanma
boolean
. Varsayılan değer: false
.
Çıkışı biçimlendirip xcodebuild
bir JUnit test sonuçları raporu oluşturur. Aracı konaklarına yüklenmelidir. xcpretty hakkında daha fazla bilgi edinin.
publishJUnitResults
- VSTS/TFS'de yayımlama
boolean
. Varsayılan değer: false
.
kullanılarak xctool
üretilen JUnit test sonuçları VSTS/TFS'de yayımlanır.
useXctool
- xctool kullanma
boolean
.
yerine xcodebuild
kullanırxctool
. Aracı konaklarına yüklenmelidir. xctool hakkında daha fazla bilgi edinin.
Not:xctool
kullanım dışıdır ve Xcode 8 ile çalışmaz.
xctoolReporter
- xctool Test Muhabiri Biçimi
string
.
Test eylemi belirtildiğinde ve Xctool kullan işaretlendiğinde kullanılacak muhabir biçimini test eder. Test Sonuçlarını Yayımla göreviyle uyumlu bir dosya biçimi oluşturmak için belirtin junit:output-file-path-here.xml
. Belirtildiğinde, düz otomatik olarak eklenir. xctool
aracı konaklarına yüklenmelidir. xctool hakkında daha fazla bilgi edinin.
Not:xctool
kullanım dışıdır ve Xcode 8 ile çalışmaz.
Görev denetim seçenekleri
Tüm görevlerde görev girişlerine ek olarak denetim seçenekleri vardır. Daha fazla bilgi için bkz . Denetim seçenekleri ve ortak görev özellikleri.
Çıkış değişkenleri
Yok.
Gereksinimler
Gereksinim | Açıklama |
---|---|
İşlem hattı türleri | YAML, Klasik derleme |
Üzerinde çalıştırılır | Agent, DeploymentGroup |
Talep | Şirket içinde barındırılan aracılar, bu görevi kullanan işleri çalıştırmak için aşağıdaki taleplerle eşleşen özelliklere sahip olmalıdır: xcode |
Özellikler | Bu görev, işteki sonraki görevler için herhangi bir talebi karşılamaz. |
Komut kısıtlamaları | Herhangi biri |
Ayarlanabilir değişkenler | Herhangi biri |
Aracı sürümü | Desteklenen tüm aracı sürümleri. |
Görev kategorisi | Oluşturma |