Compartilhar via


tarefa AndroidSigning@3 – 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

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

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

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

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 - de arquivo do Repositório de Chaves
Alias de entrada: keystoreFile. string. Necessário quando apksign = true.

O caminho do arquivo para o arquivo Do Repositório de Chaves do Android usado para assinar o APK. Esse arquivo deve ser carregado no arquivos seguros biblioteca, em que ele é armazenado com segurança com criptografia. O arquivo do Android Keystore é 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 tarefa Decrypt File para descriptografar o arquivo durante o build.


apksignerKeystorePassword - de senha do Repositório de Chaves
Alias de entrada: keystorePass. string. Opcional. Use quando apksign = true.

A senha da chave para o arquivo de Repositório de Chaves do Android 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 Repositório de Chaves do Android.


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

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

Importante

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


apksignerVersion - de 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 linha de comando apksigner. Consulte a documentação 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 - de versão do 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 zipalign executável usado durante a assinatura. Isso usa como 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 das suas entradas de tarefas. Para obter mais informações, consulte as opções de Controle de e as propriedades comuns da tarefa.

Variáveis de saída

Nenhum.

Observações

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

Esta versão da tarefa usa apksigner APKs em vez de jarsigner assinar. AdnroidSigning@2 usa jarsigner para assinar APKs e AABs.

Requisitos

Requisito Descrição
Tipos de pipeline YAML, build clássico
Execuções em Agent, DeploymentGroup
de demandas Os agentes auto-hospedados devem ter recursos que correspondam às seguintes demandas de para executar trabalhos que usam esta tarefa: JDK
recursos Essa tarefa não atende a nenhuma demanda para tarefas subsequentes no trabalho.
restrições de comando Esta tarefa é executada usando as seguintes restrições de comando : restrito
variáveis settable 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 de tarefa Construir
Requisito Descrição
Tipos de pipeline YAML, build clássico
Execuções em Agent, DeploymentGroup
de demandas Os agentes auto-hospedados devem ter recursos que correspondam às seguintes demandas de para executar trabalhos que usam esta tarefa: JDK
recursos Essa tarefa não atende a nenhuma demanda para tarefas subsequentes no trabalho.
restrições de comando Qualquer
variáveis settable Qualquer
Versão do agente 2.116.0 ou superior
Categoria de tarefa Construir