InstallAppleCertificate@1 – Installera uppgiften Apple Certificate v1

Artikel
03/24/2025

Använd den här uppgiften för att installera det Apple-certifikat som krävs för att bygga på en macOS-agent. Du kan använda den här uppgiften för att installera ett Apple-certifikat som lagras som en säker fil på servern.

Syntax

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

Ingångar

certSecureFile - certifikat (P12)
string. Obligatoriskt.

Anger det certifikat (.p12) som laddades upp till Secure Files som ska installeras på macOS-agenten.

certPwd - certifikat (P12) lösenord
string.

Anger lösenordet till Apple-certifikatet (.p12). Använd en ny byggvariabel med låset aktiverat på fliken Variables för att kryptera det här värdet.

keychain - nyckelring
string. Obligatoriskt. Tillåtna värden: default (standardnyckelring), temp (tillfällig nyckelring), custom (anpassad nyckelring). Standardvärde: temp.

Anger den nyckelring där Apple-certifikatet ska installeras. En tillfällig nyckelring tas alltid bort när bygget eller versionen har slutförts.

keychainPassword - nyckelringslösenord
string.

Anger lösenordet för att låsa upp nyckelringen. Använd en ny byggvariabel med låset aktiverat på fliken Variables för att kryptera det här värdet. Ett lösenord genereras för den tillfälliga nyckelringen om ett inte redan har angetts.

customKeychainPath - Anpassad nyckelringssökväg
string. Krävs när keychain = custom.

Anger den fullständiga sökvägen till en anpassad nyckelringsfil. Nyckelringen skapas om den inte redan finns.

deleteCert - Ta bort certifikat från nyckelringen
boolean. Valfritt. Använd när keychain = custom || keychain = default.

Anger certifikatet som ska tas bort från nyckelringen när bygget eller versionen har slutförts.

deleteCustomKeychain - Ta bort anpassad nyckelring
boolean. Valfritt. Använd när keychain = custom.

Anger den anpassade nyckelring som ska tas bort från agenten när bygget eller versionen är klar.

signingIdentity - certifikatsigneringsidentitet
string.

Anger Common Name för ämnet i signeringscertifikatet. Försöker parsa Common Name om detta lämnas tomt.

Kontrollalternativ för aktivitet

Alla aktiviteter har kontrollalternativ utöver sina aktivitetsindata. Mer information finns i Kontrollalternativ och vanliga uppgiftsegenskaper.

Utdatavariabler

Den här uppgiften definierar följande utdatavariabler, som du kan använda i underordnade steg, jobb och steg.

signingIdentity
Anger den lösta Common Name för ämnet i signeringscertifikatet. Tillhandahålls antingen som indata eller parsas från P12-certifikatfilen.

keychainPath
Anger sökvägen för nyckelringsfilen med certifikatet.

Krav

Krav	Beskrivning
Pipelinetyper	YAML, klassisk version, klassisk version
Körs på	Agent, DeploymentGroup
kräver	Lokalt installerade agenter måste ha funktioner som matchar följande kräver att köra jobb som använder den här uppgiften: xcode
funktioner	Den här aktiviteten uppfyller inte några krav på efterföljande uppgifter i jobbet.
Kommandobegränsningar	Vilken som helst
variabler som kan	Vilken som helst
Agentversion	2.116.0 eller senare
Aktivitetskategori	Nytta

Dela via