InstallAppleCertificate@2 - Apple sertifikası v2 görevini yükleme

MacOS aracısını derlemek için gereken Apple sertifikasını yüklemek için bu görevi kullanın. Bu görevi, sunucuya güvenli dosya olarak depolanan bir Apple sertifikası yüklemek için kullanabilirsiniz.

Sözdizimi

# Install Apple certificate v2
# Install an Apple certificate required to build on a macOS agent machine.
- task: InstallAppleCertificate@2
  inputs:
    certSecureFile: # string. Required. Certificate (P12). 
    #certPwd: # string. Certificate (P12) password. 
  # Advanced
    keychain: 'temp' # 'default' | 'temp' | 'custom'. Required. Keychain. Default: temp.
    #keychainPassword: # string. Required when keychain = custom || keychain = default. Keychain password. 
    #customKeychainPath: # string. Required when keychain = custom. Custom keychain path. 
    #deleteCert: # boolean. Optional. Use when keychain = custom || keychain = default. Delete certificate from keychain. 
    #deleteCustomKeychain: # boolean. Optional. Use when keychain = custom. Delete custom keychain. 
    #signingIdentity: # string. Certificate signing identity. 
    #setUpPartitionIdACLForPrivateKey: # boolean. Set up partition_id ACL for the imported private key. 
    #opensslPkcsArgs: # string. OpenSSL arguments for PKCS12.
# Install Apple certificate v2
# Install an Apple certificate required to build on a macOS agent machine.
- task: InstallAppleCertificate@2
  inputs:
    certSecureFile: # string. Required. Certificate (P12). 
    #certPwd: # string. Certificate (P12) password. 
  # Advanced
    keychain: 'temp' # 'default' | 'temp' | 'custom'. Required. Keychain. Default: temp.
    #keychainPassword: # string. Required when keychain = custom || keychain = default. Keychain password. 
    #customKeychainPath: # string. Required when keychain = custom. Custom keychain path. 
    #deleteCert: # boolean. Optional. Use when keychain = custom || keychain = default. Delete certificate from keychain. 
    #deleteCustomKeychain: # boolean. Optional. Use when keychain = custom. Delete custom keychain. 
    #signingIdentity: # string. Certificate signing identity. 
    #setUpPartitionIdACLForPrivateKey: # boolean. Set up partition_id ACL for the imported private key.

Girişler

certSecureFile - Sertifikası (P12)
string. Gerekli.

macOS aracısına yüklenecek Secure Files yüklenen sertifikayı (.p12) belirtir.


certPwd - Sertifikası (P12) parolası
string.

Apple sertifikasının (.p12) parolasını belirtir. Bu değeri şifrelemek için Variables sekmesinde kilidi etkinleştirilmiş yeni bir derleme değişkeni kullanın.


anahtarlıkkeychain -
string. Gerekli. İzin verilen değerler: default (Varsayılan Anahtarlık), temp (Geçici Anahtarlık), custom (Özel Anahtarlık). Varsayılan değer: temp.

Apple sertifikasının yükleneceği anahtarlığı belirtir. Microsoft tarafından barındırılan derlemeler için Temporary Keychainkullanın. Derleme veya yayın tamamlandıktan sonra geçici bir anahtarlık her zaman silinir.


Anahtarlık parolasıkeychainPassword -
string. keychain = custom || keychain = defaultgerekir.

Anahtarlık kilidini açmak için parolayı belirtir. Bu değeri şifrelemek için Variables sekmesinde kilidi etkinleştirilmiş yeni bir derleme değişkeni kullanın. Belirtilmezse geçici anahtarlık için bir parola oluşturulur.


customKeychainPath - Özel anahtarlık yolu
string. keychain = customgerekir.

Özel anahtarlık dosyasının tam yolunu belirtir. Anahtarlık henüz yoksa oluşturulur.


deleteCert - Anahtarlık sertifikayı silme
boolean. Opsiyonel. keychain = custom || keychain = defaultolduğunda kullanın.

Derleme veya yayın tamamlandıktan sonra anahtarlıktan silinecek sertifikayı belirtir.


deleteCustomKeychain - Özel anahtarlık silme
boolean. Opsiyonel. keychain = customolduğunda kullanın.

Derleme veya yayın tamamlandıktan sonra aracıdan silinecek özel anahtar zincirini belirtir.


signingIdentity - Sertifika imzalama kimliği
string.

İmzalama sertifikasındaki konunun Common Name belirtir. Bu boş bırakılırsa Common Name ayrıştırmaya çalışır.


setUpPartitionIdACLForPrivateKey - İçeri aktarılan özel anahtar için partition_id ACL'yi ayarlama
boolean.

trueise, içeri aktarılan özel anahtar için partition_id ACL'sini ayarlar, böylece codesign anahtarı imzalamak için kullanmak istemez. Bu, MacOS High Sierra'da geçici anahtarlıklar için gerekli değildir. Açık Radar hakkında daha fazla bilgi edinin.


PKCS12için OpenSSL bağımsız değişkenlerini opensslPkcsArgs -
string.

openssl kullanarak sertifika bilgilerini ayıklama bağımsız değişkenleri.


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

Bu görevaşağıdaki çıkış değişkenlerini tanımlar. Bu değişkenleri aşağı akış adımlarında, işlerde ve aşamalarda kullanabilirsiniz.

signingIdentity
İmza sertifikasındaki konunun çözümlenen Common Name belirtir. Giriş olarak sağlanır veya P12 sertifika dosyasından ayrıştırılır.

keychainPath
Sertifikaya sahip anahtarlık dosyasının yolunu belirtir.

Açıklamalar

MacOS aracısını derlemek için gereken bir Apple sertifikası yüklemek için bu görevi kullanın. Bu görevi, sunucuya güvenli dosya olarak depolanan bir Apple sertifikası yüklemek için kullanabilirsiniz.

Gereksinimler

Gereksinim Açıklama
İşlem hattı türleri YAML, Klasik derleme, Klasik sürüm
Ü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ı Bu görev,aşağıdaki komut kısıtlamaları kullanılarak çalışır: restricted
Ayarlanabilir değişkenleri Bu görevin şu değişkenleri ayarlama izni var: signingIdentity, keychainPassword, keychainPath, APPLE_CERTIFICATE_SIGNING_IDENTITY, APPLE_CERTIFICATE_KEYCHAIN
Aracı sürümü 2.182.1 veya üzeri
Görev kategorisi Fayda