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

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

macOS aracısını derlemek için gereken apple sertifikasını yükleyin.

Syntax

# 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.
# 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.
# Install Apple Certificate v2
# Install an Apple certificate required to build on a macOS agent.
- 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.

Girişler

certSecureFile - Sertifika (P12)
string. Gereklidir.

macOS aracısına yüklemek için Secure Files karşıya yüklenen sertifikayı (.p12) belirtir.


certPwd - Sertifika (P12) parolası
string.

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


keychain - Anahtarlık
string. Gereklidir. İzin verilen değerler: default (Varsayılan Anahtar Zinciri), temp (Geçici AnahtarLık), custom (Özel Anahtar Zinciri). Varsayılan değer: temp.

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


keychainPassword - Anahtarlık parolası
string. olduğunda keychain = custom || keychain = defaultgereklidir.

Anahtarlık kilidini açmak için parolayı belirtir. Bu değeri şifrelemek için sekmede Variables 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. olduğunda keychain = customgereklidir.

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


deleteCert - Sertifikayı anahtarlıktan silme
boolean. İsteğe bağlı. when keychain = custom || keychain = defaultkullanın.

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


deleteCustomKeychain - Özel anahtar zincirini silme
boolean. İsteğe bağlı. when keychain = customkullanın.

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


signingIdentity - Sertifika imzalama kimliği
string.

Common Name İmzalama sertifikasındaki konunun öğesini belirtir. Boş bırakılırsa öğesini Common Name ayrıştırmaya çalışır.


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

isetrue, içeri aktarılan özel anahtarın codesign ACL'sini, imzalama için anahtarın kullanılmasını istemeyecek şekilde ayarlarpartition_id. MacOS High Sierra'da geçici anahtarlıklar için bu gerekli değildir. Açık Radar hakkında daha fazla bilgi edinin.


opensslPkcsArgs - PKCS12 için OpenSSL bağımsız değişkenleri
string.

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


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

Bu görev aşağı akış adımlarında, işlerde ve aşamalarda kullanabileceğiniz aşağıdaki çıkış değişkenlerini tanımlar.

signingIdentity
İmzalama sertifikasındaki konunun çözümlenenini 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ı üzerinde derlemek için gereken bir Apple sertifikasını yüklemek için bu görevi kullanın. Bu görevi, sunucuda güvenli bir 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 Agent, DeploymentGroup
Talep Şirket içi 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 hiçbir talebi karşılamaz.
Komut kısıtlamaları Bu görev aşağıdaki komut kısıtlamaları kullanılarak çalıştırılır: kısıtlı
Ayarlanabilir değişkenler 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 Yardımcı Program
Gereksinim Açıklama
İşlem hattı türleri YAML, Klasik derleme, Klasik sürüm
Üzerinde çalışır Agent, DeploymentGroup
Talep Şirket içi 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 hiçbir talebi karşılamaz.
Komut kısıtlamaları Herhangi biri
Ayarlanabilir değişkenler Herhangi biri
Aracı sürümü 2.116.0 veya üzeri
Görev kategorisi Yardımcı Program