Compartilhar via


InstallAppleCertificate@1 – Instalar a tarefa Apple Certificate v1

Use essa tarefa para instalar o certificado da Apple que é necessário para compilar em um agente macOS. Você pode usar essa tarefa para instalar um certificado da Apple que é armazenado como um arquivo seguro no servidor.

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.

Entradas

certSecureFile - Certificado (P12)
string. Obrigatórios.

Especifica o certificado (.p12) que foi carregado para Secure Files instalar no agente macOS.


certPwd - Senha do certificado (P12)
string.

Especifica a senha para o certificado da Apple (.p12). Use uma nova variável de build com seu bloqueio habilitado na Variables guia para criptografar esse valor.


keychain - Chaveiro
string. Obrigatórios. Valores permitidos: default (conjunto de chaves padrão), temp (conjunto de chaves temporário) custom (conjunto de chaves personalizado). Valor padrão: temp.

Especifica o conjunto de chaves no qual instalar o certificado da Apple. Um conjunto de chaves temporário sempre será excluído após a conclusão do build ou da versão.


keychainPassword - Senha do conjunto de chaves
string.

Especifica a senha para desbloquear o conjunto de chaves. Use uma nova variável de build com seu bloqueio habilitado na Variables guia para criptografar esse valor. Uma senha será gerada para o conjunto de chaves temporário se ainda não estiver especificado.


customKeychainPath - Caminho do conjunto de chaves personalizado
string. Obrigatório quando keychain = custom.

Especifica o caminho completo para um arquivo de conjunto de chaves personalizado. O conjunto de chaves será criado se ainda não existir.


deleteCert - Excluir certificado do conjunto de chaves
boolean. Opcional. Use quando keychain = custom || keychain = default.

Especifica o certificado a ser excluído do conjunto de chaves após a conclusão do build ou da versão.


deleteCustomKeychain - Excluir conjunto de chaves personalizado
boolean. Opcional. Use quando keychain = custom.

Especifica o conjunto de chaves personalizado a ser excluído do agente após a conclusão do build ou da versão.


signingIdentity - Identidade de autenticação de certificado
string.

Especifica o Common Name assunto no certificado de assinatura. Tentará analisar se Common Name isso é deixado vazio.


Opções de controle de tarefa

Todas as tarefas têm opções de controle além de suas entradas de tarefa. Para obter mais informações, consulte opções de controle e propriedades comuns da tarefa.

Variáveis de saída

Essa tarefa define as variáveis de saída a seguir, que você pode consumir em etapas downstream, trabalhos e estágios.

signingIdentity
Especifica o resolvido Common Name do assunto no certificado de assinatura. Fornecido como uma entrada ou analisado do arquivo de certificado P12.

keychainPath
Especifica o caminho para o arquivo de conjunto de chaves com o certificado.

Requisitos

Requisito Descrição
Tipos de pipeline YAML, build clássico, versão clássica
Execuções em Agent, DeploymentGroup
Demandas Os agentes auto-hospedados devem ter recursos que correspondam às seguintes demandas para executar trabalhos que usam esta tarefa: xcode
Funcionalidades Essa tarefa não atende a nenhuma demanda por tarefas subsequentes no trabalho.
Restrições de comando Qualquer
Variáveis configuráveis Qualquer
Versão do agente 2.116.0 ou superior
Categoria da tarefa Utilitário