InstallAppleCertificate@1 - Installare l'attività Certificato Apple v1

Articolo
03/24/2025

Usare questa attività per installare il certificato Apple necessario per la compilazione in un agente macOS. È possibile usare questa attività per installare un certificato Apple archiviato come file sicuro nel server.

Sintassi

# Install Apple Certificate v1
# Install an Apple certificate required to build on a macOS agent.
- task: InstallAppleCertificate@1
  inputs:
    certSecureFile: # string. Required. Certificate (P12). 
    #certPwd: # string. Certificate (P12) password. 
  # Advanced
    keychain: 'temp' # 'default' | 'temp' | 'custom'. Required. Keychain. Default: temp.
    #keychainPassword: # string. 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.

Ingressi dati

certificato certSecureFile - (P12)
string. Obbligatorio.

Specifica il certificato (.p12) caricato in Secure Files da installare nell'agente macOS.

password certPwd - certificato (P12)
string.

Specifica la password per il certificato Apple (.p12). Usare una nuova variabile di compilazione con il relativo blocco abilitato nella scheda Variables per crittografare questo valore.

keychain - keychain
string. Obbligatorio. Valori consentiti: default (Portachiavi predefinita), temp (Portachiavi temporanea), custom (Portachiavi personalizzata). Valore predefinito: temp

Specifica il keychain in cui installare il certificato Apple. Un keychain temporaneo verrà sempre eliminato al termine della compilazione o del rilascio.

keychainPassword - password Keychain
string.

Specifica la password per sbloccare il portachiavi. Usare una nuova variabile di compilazione con il relativo blocco abilitato nella scheda Variables per crittografare questo valore. Viene generata una password per il keychain temporaneo, se non ne è già stata specificata una.

customKeychainPath - percorso portachiavi personalizzato
string. Obbligatorio quando keychain = custom.

Specifica il percorso completo di un file keychain personalizzato. Il portachiavi verrà creato se non esiste già.

deleteCert - Eliminare il certificato dal keychain
boolean. Opzionale. Usare quando keychain = custom || keychain = default.

Specifica il certificato da eliminare dal keychain dopo il completamento della compilazione o del rilascio.

deleteCustomKeychain - Eliminare portachiavi personalizzati
boolean. Opzionale. Usare quando keychain = custom.

Specifica il keychain personalizzato da eliminare dall'agente al termine della compilazione o del rilascio.

signingIdentity - 'identità di firma del certificato
string.

Specifica il Common Name dell'oggetto nel certificato di firma. Tenterà di analizzare il Common Name se questo viene lasciato vuoto.

Opzioni di controllo attività

Tutte le attività hanno opzioni di controllo oltre ai relativi input di attività. Per altre informazioni, vedere Opzioni di controllo e proprietà comuni delle attività.

Variabili di output

Questa attività definisce le variabili di output seguenti , che è possibile utilizzare nei passaggi downstream, nei processi e nelle fasi.

signingIdentity
Specifica il Common Name risolto dell'oggetto nel certificato di firma. Fornito come input o analizzato dal file di certificato P12.

keychainPath
Specifica il percorso del file keychain con il certificato.

Requisiti

Requisito	Descrizione
Tipi di pipeline	YAML, build classica, versione classica
Viene eseguito in	Agente, DeploymentGroup
richieste	Gli agenti self-hosted devono avere funzionalità che corrispondono alle seguenti richiedono di eseguire processi che usano questa attività: xcode
funzionalità di	Questa attività non soddisfa alcuna richiesta di attività successive nel processo.
restrizioni dei comandi	Qualunque
variabili impostabili	Qualunque
Versione dell'agente	2.116.0 o versione successiva
Categoria attività	Utilità

Condividi tramite