Aracılığıyla paylaş


Xcode@5 - Xcode v5 görevi

MacOS'ta Xcode çalışma alanı oluşturmak, test etmek veya arşivleyip isteğe bağlı olarak bir uygulamayı paketlemek için bu görevi kullanın.

Sözdizimi

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

Girişler

actions - Eylemleri
string. Gerekli. Varsayılan değer: build.

Boşlukla ayrılmış eylemlerin listesini belirtir. Bazı geçerli seçenekler build, clean, test, analyzeve archive'dır. Örneğin,clean build temiz bir derleme gerçekleştirir. Bkz. Apple: Xcode ile komut satırından derleme SSS.


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, Release sekmesinde bir değer (örneğin, ) belirtin.


sdk - Yazılım Geliştirme Kiti
string. Varsayılan değer: $(SDK).

Xcode projesini veya çalışma alanını oluştururken kullanılacak bir SDK belirtir. geçerli SDK listesini görüntülemek için macOS Terminal uygulamasından xcodebuild -showsdks çalıştırın. Değişken kullanırken, iphonesimulator sekmesinde bir değer (örneğin, ) belirtin.


Çalışma alanı veya proje yoluxcWorkspacePath -
string. Varsayılan değer: **/*.xcodeproj/project.xcworkspace.

Opsiyonel. Deponun kökünden Xcode çalışma alanına veya projesine göreli bir yol belirtir. Örneğin, MyApp/MyApp.xcworkspace veya MyApp/MyApp.xcodeproj. Joker karakterler kullanılabilir. dosya eşleştirme desenleri hakkında daha fazla bilgi edinin.


scheme - Düzeni
string.

Opsiyonel. Xcode düzeni adını belirtir. Paylaşılan bir düzen olmalıdır (Xcode'da Yönetilen Düzenleri altında paylaşılan onay kutusu). Bir düzen belirtmezseniz ve belirtilen çalışma alanının tek bir paylaşılan düzeni varsa, çalışma alanı düzeni kullanılır.


Xcode sürümüxcodeVersion -
string. İzin verilen değerler: 8 (Xcode 8), 9 (Xcode 9), 10 (Xcode 10), 11 (Xcode 11), 12 (Xcode 12), 13 (Xcode 13), default, specifyPath (Yolu belirtin). Varsayılan değer: default.

Xcode'un hedef sürümünü belirtir. Aracı makinede varsayılan Xcode sürümünü kullanmak için Default seçin. Bir sürüm numarası (örneğin, Xcode 9) belirtilmesi, aracı makinedeki ortam değişkenleri tarafından ayarlanacak sürümün konumuna bağlıdır (örneğin, XCODE_9_DEVELOPER_DIR=/Applications/Xcode_9.0.0.app/Contents/Developer). Xcode geliştirici dizinine belirli bir yol sağlamak için Specify path'ı seçin.


Xcode geliştirici yolunuxcodeDeveloperDir -
string. Opsiyonel. xcodeVersion == specifyPatholduğunda kullanın.

Belirli bir Xcode geliştirici dizininin yolunu belirtir (örneğin, /Applications/Xcode_9.0.0.app/Contents/Developer). Bu giriş, aracı makinesine Xcode'un birden çok sürümü yüklendiğinde kullanışlıdır.


packageApp - Uygulama paketi oluşturma
boolean. Varsayılan değer: false.

Derlemenin bir parçası olarak bir IPA uygulama paketi dosyasının oluşturulup oluşturulmayacağını belirtir.


arşiv yoluarchivePath -
string. Opsiyonel. packageApp == trueolduğunda kullanın.

Oluşturulan arşivlerin yerleştirildiği dizini belirtir.


yoldışarı aktarma exportPath -
string. Opsiyonel. packageApp == trueolduğunda kullanın. Varsayılan değer: output/$(SDK)/$(Configuration).

Arşivden dışarı aktarılan ürünün hedefini belirtir.


dışarı aktarma seçenekleriniexportOptions -
string. Opsiyonel. packageApp == trueolduğunda kullanın. İzin verilen değerler: auto (Otomatik), plist, specify. Varsayılan değer: auto.

Arşivi dışarı aktarma seçeneklerini belirtir. Automatic varsayılan değeri seçildiğinde, dışarı aktarma yöntemi arşivden otomatik olarak algılanır. Dışarı aktarma seçeneklerini içeren bir plist dosyası belirtmek için Plist seçin. Specify Dışarı Aktarma yöntemi sağlamak ve Ekip Kimliğiiçin seçin.


exportMethod - Dışarı Aktarma yöntemi
string. exportOptions == specifygerekir. 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, enterpriseveya development.


exportTeamId - Ekip Kimliği
string. Opsiyonel. exportOptions == specifyolduğunda kullanın.

Dışarı aktarma sırasında kullanılacak Apple Geliştirici Portalı 10 karakterlik ekip kimliğini belirtir.


exportOptionsPlist - Dışarı aktarma seçenekleri plist
string. exportOptions == plistgerekir.

Dışarı aktarma sırasında kullanılacak seçenekleri içeren plist dosyasının yolunu belirtir.


bağımsız değişkenleri dışarı aktarmaexportArgs -
string. Opsiyonel. packageApp == trueolduğunda kullanın.

Dışarı aktarma sırasında kullanılan ek komut satırı bağımsız değişkenlerini belirtir.


signingOption - İmzalama stili
string. İzin verilen değerler: nosign (Kod imzalama), default (Proje varsayılanları), manual (El ile imzalama), auto (Otomatik imzalama). Varsayılan değer: nosign.

Derlemeyi imzalama yöntemini belirtir. İmzalama özelliğini devre dışı bırakmak için Do not code sign seçin. Yalnızca projenin imzalama yapılandırmasını kullanmak için Project defaults seçin. el ile imzalamayı zorlamak için Manual signing seçin ve isteğe bağlı olarak bir imzalama kimliği ve sağlama profili belirtin. Otomatik imzalamayı zorlamak için Automatic signing seçin ve isteğe bağlı olarak bir geliştirme ekibi kimliği belirtin. Projeniz imzalama gerektiriyorsa, Xcode derlemesi öncesinde sertifikaları ve sağlama profillerini yüklemek için Apple'ı Yükle... görevlerini kullanın.


signingIdentity - İmzalama kimliği
string. Opsiyonel. signingOption = manualolduğunda kullanın.

Derlemenin imzalandığı imzalama kimliğini geçersiz kılmayı belirtir. Aracı makinesinde varsayılan anahtar zincirinin kilidini açmak gerekebilir. Değer girilmemişse, Xcode projesinin ayarı kullanılır.


provisioningProfileUuid - Sağlama profili UUID
string. Opsiyonel. signingOption = manualolduğunda kullanın.

Derleme için kullanılan yüklü bir sağlama profilinin UUID değerini belirtir. Tek bir çalışma alanında (iOS, tvOS, watchOS) hedefe göre sağlama profilleri belirtmek için farklı şemalar veya hedeflerle ayrı derleme görevleri kullanın.


provisioningProfileName - Sağlama profili adı
string. Opsiyonel. signingOption = manualolduğunda kullanın.

Derleme için kullanılan yüklü sağlama profilinin adını belirtir. Belirtilirse, bu, sağlama profili UUID'sine göre önceliklidir. Tek bir çalışma alanında (iOS, tvOS, watchOS) hedefe göre sağlama profilleri belirtmek için farklı şemalar veya hedeflerle ayrı derleme görevleri kullanın.


teamId - Ekip Kimliği
string. Opsiyonel. signingOption = autoolduğunda kullanın.

Birden çok geliştirme ekibine üyeyseniz gereklidir. 10 karakterlik geliştirme ekibi kimliğini belirtir.


hedef platformdestinationPlatformOption -
string. İzin verilen değerler: default, iOS (iOS ve watchOS), tvOS, macOS, custom. Varsayılan değer: default.

Genel derleme cihazı geçerli olmadığında kullanıcı arabirimi testi için kullanılan hedef cihazın platformunu belirtir. Bu listeye dahil olmayan bir platform belirtmek için Custom seçin. Default seçildiğinde hiçbir simülatör veya cihaz hedeflenmez.


destinationPlatform - Özel hedef platform
string. Opsiyonel. destinationPlatformOption == customolduğunda kullanın.

Genel derleme cihazı geçerli olmadığında kullanıcı arabirimi testi için kullanılan hedef cihazın platformunu belirtir. Listeye dahil olmayan bir platform belirtmek için Custom seçin. Default seçildiğinde hiçbir simülatör veya cihaz hedeflenmez.


hedef türüdestinationTypeOption -
string. Opsiyonel. destinationPlatformOption != default && destinationPlatformOption != macOSolduğunda kullanın. İzin verilen değerler: simulators (Simülatör), devices (Bağlı Cihaz). Varsayılan değer: simulators.

Kullanıcı arabirimi testi için kullanılacak hedef türünü belirtir. Derlemeyi bir kablo veya ağ bağlantısı üzerinden gerçekleştiren cihazların Mac'e bağlı olması gerekir. Daha fazla bilgi için bkz. Xcode'da Cihazlar ve Simülatörler.


destinationSimulators - Simülatörü
string. Opsiyonel. destinationPlatformOption != default && destinationPlatformOption != macOS && destinationTypeOption == simulatorsolduğunda kullanın.

Kullanıcı arabirimi testi için kullanılan bir Xcode simülatörü adı belirtir. Örneğin, iPhone X (iOS ve watchOS) veya Apple TV 4K (tvOS). İsteğe bağlı bir hedef işletim sistemi sürümü, OS=<versionNumber>gibi iPhone X,OS=11.1biçiminde belirtilebilir. Daha fazla bilgi için Barındırılan macOS aracısı yüklenen simülatörlerin bu listesine bakın.


cihazdestinationDevices -
string. Opsiyonel. destinationPlatformOption != default && destinationPlatformOption != macOS && destinationTypeOption == devicesolduğunda kullanın.

Raisa's iPadgibi kullanıcı arabirimi testi için kullanılan cihazın adını belirtir. Şu anda yalnızca bir cihaz desteklenmektedir. Apple'ın cihaz adlarında kesme işaretine (') izin vermediğini unutmayın. Bunun yerine, sağ tek tırnak işaretleri (') kullanılabilir.


bağımsız değişkenleri
string.

Opsiyonel. Derlenen ek komut satırı bağımsız değişkenlerini belirtir. Bu giriş, çalışma alanı/proje ve şema yerine -target veya -project bağımsız değişkenleri belirtmek için kullanışlıdır. Bkz. Apple: Xcode ile komut satırından derleme SSS.


workingDirectory - Çalışma dizini
Giriş diğer adı: cwd. string.

Opsiyonel. Derlemenin çalıştırıldığı çalışma dizinini belirtir. Değer girilmemişse, deponun kökü kullanılır.


useXcpretty - xcpretty kullanma
boolean. Varsayılan değer: true.

xcpretty çıkışı biçimlendirmek için xcodebuild kullanılıp kullanılmayacağını belirtir. xcpretty aracı makinesine yüklenmelidir (Azure Pipelines tarafından barındırılan derleme aracılarına önceden yüklenmiştir). xcpretty yüklü değilse ham xcodebuild çıkışı gösterilir. Daha fazla bilgi için bkz. xcpretty.


Xcpretty bağımsız değişkenlerini xcprettyArgs -
string. Opsiyonel. useXcpretty == trueolduğunda kullanın.

xcpretty etkinleştirilirse, bu giriş xcprettyiçin bağımsız değişkenleri belirtir. GitHub 'da xcpretty bağımsız değişkenlerinin listesinibakın.


publishJUnitResults - Test sonuçlarını Azure Pipelines yayımlama
boolean. Varsayılan değer: false.

JUnit test sonuçlarının Azure Pipelines'a yayımlanıp yayımlanmayacağını belirtir. Bunun için JUnit test sonuçları oluşturmak için xcpretty etkinleştirilmesi gerekir.


çalıştırma başlığını test
string. Opsiyonel. publishJUnitResults == trueolduğunda kullanın.

xcpretty ve publishJUnitResults etkinleştirilirse test çalıştırması başlığını belirtebilirsiniz.


Görev denetimi seçenekleri

Tüm görevlerin, 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.

Açıklamalar

MacOS'ta Xcode çalışma alanı oluşturmak, test etmek veya arşivleyip isteğe bağlı olarak bir uygulamayı paketlemek için bu görevi kullanın.

Birden çok sağlama profili kullanma

Şu anda Xcode görevi (örneğin, iOS Uygulama Uzantısı) için birden çok sağlama profili desteklenmemektedir.

Örnekler

Xcode uygulamanızı derleme

Gereksinimler

Gereksinim Açıklama
İşlem hattı türleri YAML, Klasik derleme
Üzerinde çalışır Aracı, DeploymentGroup
Talepleri Şirket içinde barındırılan aracıların, bu görevi kullanan işleri çalıştırmak için talep aşağıdakilerle eşleşen özellikleri olmalıdır: xcode
Özellikleri Bu görev, işteki sonraki görevler için herhangi bir talebi karşılamaz.
Komut kısıtlamaları Herhangi bir
Ayarlanabilir değişkenleri Herhangi bir
Aracı sürümü Desteklenen tüm aracı sürümleri.
Görev kategorisi İnşa et