Compartilhar via


AndroidSigning@3 – Tarefa de Assinatura do Android v3

Use essa tarefa em um pipeline para assinar e alinhar arquivos APK do Android.

Sintaxe

# Android Signing v3
# Sign and align Android APK files.
- task: AndroidSigning@3
  inputs:
    apkFiles: '**/*.apk' # string. Alias: files. Required. APK files. Default: **/*.apk.
  # Signing Options
    #apksign: true # boolean. Sign the APK. Default: true.
    apksignerKeystoreFile: # string. Alias: keystoreFile. Required when apksign = true. Keystore file. 
    #apksignerKeystorePassword: # string. Alias: keystorePass. Optional. Use when apksign = true. Keystore password. 
    #apksignerKeystoreAlias: # string. Alias: keystoreAlias. Optional. Use when apksign = true. Alias. 
    #apksignerKeyPassword: # string. Alias: keyPass. Optional. Use when apksign = true. Key password. 
    #apksignerVersion: 'latest' # string. Optional. Use when apksign = true. apksigner version. Default: latest.
    #apksignerArguments: '--verbose' # string. Optional. Use when apksign = true. apksigner arguments. Default: --verbose.
    #apksignerFile: # string. Alias: apksignerLocation. Optional. Use when apksign = true. apksigner location. 
  # Zipalign Options
    #zipalign: true # boolean. Zipalign. Default: true.
    #zipalignVersion: 'latest' # string. Optional. Use when zipalign = true. Zipalign version. Default: latest.
    #zipalignFile: # string. Alias: zipalignLocation. Optional. Use when zipalign = true. Zipalign location.
# Android Signing v3
# Sign and align Android APK files.
- task: AndroidSigning@3
  inputs:
    apkFiles: '**/*.apk' # string. Alias: files. Required. APK files. Default: **/*.apk.
  # Signing Options
    #apksign: true # boolean. Sign the APK. Default: true.
    apksignerKeystoreFile: # string. Alias: keystoreFile. Required when apksign = true. Keystore file. 
    #apksignerKeystorePassword: # string. Alias: keystorePass. Optional. Use when apksign = true. Keystore password. 
    #apksignerKeystoreAlias: # string. Alias: keystoreAlias. Optional. Use when apksign = true. Alias. 
    #apksignerKeyPassword: # string. Alias: keyPass. Optional. Use when apksign = true. Key password. 
    #apksignerArguments: '--verbose' # string. Optional. Use when apksign = true. apksigner arguments. Default: --verbose.
    #apksignerFile: # string. Alias: apksignerLocation. Optional. Use when apksign = true. apksigner location. 
  # Zipalign Options
    #zipalign: true # boolean. Zipalign. Default: true.
    #zipalignFile: # string. Alias: zipalignLocation. Optional. Use when zipalign = true. Zipalign location.

Entradas

apkFiles - Arquivos APK
Alias de entrada: files. string. Obrigatórios. Valor padrão: **/*.apk.

O caminho relativo da raiz do repositório para as APKs que você deseja assinar. Você pode usar caracteres curinga para especificar vários arquivos. Por exemplo:

  • outputs\apk*.apk para assinar tudo. Arquivos APK na outputs\apk\ subpasta.
  • **/bin/*.apk para assinar tudo. Arquivos APK em todas as bin subpastas.

apksign - Assinar o APK
boolean. Valor padrão: true.

Assina o APK com um arquivo do Android Keystore fornecido. APKs não assinados só podem ser executados em um emulador. As APKs devem ser assinadas para serem executadas em um dispositivo.


apksignerKeystoreFile - Arquivo de repositório de chaves
Alias de entrada: keystoreFile. string. Obrigatório quando apksign = true.

O caminho do arquivo para o arquivo do Android Keystore usado para assinar o APK. Esse arquivo deve ser carregado na biblioteca de arquivos seguros , onde é armazenado com segurança com criptografia. O arquivo Do Repositório de Chaves do Android é removido do computador do agente quando o pipeline é concluído.

O arquivo pode ser verificado no controle do código-fonte ou colocado no computador de build diretamente por um administrador. É recomendável criptografar o arquivo do repositório de chaves no controle do código-fonte e usar a Decrypt File tarefa para descriptografar o arquivo durante o build.


apksignerKeystorePassword - Senha do repositório de chaves
Alias de entrada: keystorePass. string. Opcional. Use quando apksign = true.

A senha de chave para o arquivo do Android Keystore fornecido.

Importante

Use uma nova variável com seu bloqueio habilitado no painel Variáveis para criptografar esse valor. Consulte variáveis secretas.


apksignerKeystoreAlias - Alias
Alias de entrada: keystoreAlias. string. Opcional. Use quando apksign = true.

O alias que identifica o par de chaves pública/privada a ser usado no arquivo do Android Keystore.


apksignerKeyPassword - Senha de chave
Alias de entrada: keyPass. string. Opcional. Use quando apksign = true.

A senha de chave para o arquivo de repositório de chaves e alias.

Importante

Use uma nova variável com seu bloqueio habilitado no painel Variáveis para criptografar esse valor. Consulte variáveis secretas.


apksignerVersion - versão do apksigner
string. Opcional. Use quando apksign = true. Valor padrão: latest.

A versão de ferramentas de build do SDK do Android que o apksigner executável usa para a tarefa.


apksignerArguments - Argumentos apksigner
string. Opcional. Use quando apksign = true. Valor padrão: --verbose.

Fornece opções para passar para a apksigner linha de comando. Consulte a documentação do apksigner.


apksignerFile - Local do apksigner
Alias de entrada: apksignerLocation. string. Opcional. Use quando apksign = true.

Especifica o local do executável apksigner usado durante a assinatura. Esse padrão é o apksigner encontrado na pasta de versão do SDK do Android na qual seu aplicativo é criado.


zipalign - Zipalign
boolean. Valor padrão: true.

Selecione se você deseja zipalign seu pacote. Isso reduz a quantidade de RAM consumida por um aplicativo.


zipalignVersion - Versão zipalign
string. Opcional. Use quando zipalign = true. Valor padrão: latest.

A versão de ferramentas de build do SDK do Android que o zipalign executável usa para a tarefa.


zipalignFile - Local do Zipalign
Alias de entrada: zipalignLocation. string. Opcional. Use quando zipalign = true.

Especifica o local do executável usado durante a zipalign assinatura. Esse padrão é o zipalign encontrado na pasta de versão do SDK do Android na qual seu aplicativo é criado.


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

Nenhum.

Comentários

Use essa tarefa em um pipeline para assinar e alinhar arquivos APK do Android.

Essa versão da tarefa usa apksigner em vez de jarsigner para assinar APKs.

Requisitos

Requisito Descrição
Tipos de pipeline YAML, build clássico
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: JDK
Funcionalidades Essa tarefa não atende a nenhuma demanda por tarefas subsequentes no trabalho.
Restrições de comando Essa tarefa é executada usando as seguintes restrições de comando: restrito
Variáveis configuráveis Essa tarefa tem permissão para definir as seguintes variáveis: A configuração de variáveis está desabilitada
Versão do agente 2.182.1 ou superior
Categoria da tarefa Build
Requisito Descrição
Tipos de pipeline YAML, build clássico
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: JDK
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 Build
Requisito Descrição
Tipos de pipeline YAML, build clássico
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: JDK, AndroidSDK
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 Build