Partilhar via


AndroidSigning@3 - Android Signing v3 tarefa

Use esta 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.

Insumos

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

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

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

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

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


apksignerKeystoreFile - arquivo Keystore
Alias de entrada: keystoreFile. string. Necessário quando apksign = true.

O caminho do arquivo para o arquivo Keystore do Android que é usado para assinar o APK. Este ficheiro deve ser carregado para a biblioteca ficheiros seguros, onde é armazenado de forma segura com encriptação. O arquivo Android Keystore é removido da máquina do agente quando o pipeline é concluído.

O arquivo pode ser verificado no controle do código-fonte ou colocado na máquina de compilação diretamente por um administrador. É recomendável criptografar o arquivo keystore no controle do código-fonte e usar a tarefa Decrypt File para descriptografar o arquivo durante a compilação.


apksignerKeystorePassword - de senha do Keystore
Alias de entrada: keystorePass. string. Opcional. Use quando apksign = true.

A senha da chave para o arquivo 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 Keystore do Android.


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

A senha da chave para o arquivo de alias e keystore.

Importante

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


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

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


apksignerArguments - argumentos do 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 do apksigner.


apksignerFile - localização do apksigner
Alias de entrada: apksignerLocation. string. Opcional. Use quando apksign = true.

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


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

Selecione se deseja zipalinhar 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 das ferramentas de compilação do SDK do Android que o executável zipalign usa para a tarefa.


zipalignFile - Localização do Zipalign
Alias de entrada: zipalignLocation. string. Opcional. Use quando zipalign = true.

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


Opções de controlo de tarefas

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

Variáveis de saída

Nenhum.

Observações

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

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

Requerimentos

Requisito Descrição
Tipos de pipeline YAML, construção clássica
Funciona em Agente, DeploymentGroup
Exigências Os agentes auto-hospedados devem ter recursos que correspondam às seguintes demandas executar trabalhos que usam essa tarefa: JDK
Capacidades Esta tarefa não satisfaz quaisquer exigências para tarefas subsequentes no trabalho.
Restrições de comando Esta tarefa é executada usando as seguintes restrições de comando : restrito
Variáveis configuráveis Esta tarefa tem permissão para definir as seguintes variáveis: A configuração de variáveis está desativada
Versão do agente 2.182.1 ou superior
Categoria de tarefa Construir
Requisito Descrição
Tipos de pipeline YAML, construção clássica
Funciona em Agente, DeploymentGroup
Exigências Os agentes auto-hospedados devem ter recursos que correspondam às seguintes demandas executar trabalhos que usam essa tarefa: JDK
Capacidades Esta tarefa não satisfaz quaisquer exigências para tarefas subsequentes no trabalho.
Restrições de comando Qualquer
Variáveis configuráveis Qualquer
Versão do agente 2.116.0 ou superior
Categoria de tarefa Construir