Share via


AndroidSigning@2 – Tarefa de Assinatura do Android v2

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

Sintaxe

# Android Signing v2
# Sign and align Android APK files.
- task: AndroidSigning@2
  inputs:
    apkFiles: '**/*.apk' # string. Alias: files. Required. APK files. Default: **/*.apk.
  # Signing Options
    #jarsign: true # boolean. Sign the APK. Default: true.
    jarsignerKeystoreFile: # string. Alias: keystoreFile. Required when jarsign = true. Keystore file. 
    #jarsignerKeystorePassword: # string. Alias: keystorePass. Optional. Use when jarsign = true. Keystore password. 
    #jarsignerKeystoreAlias: # string. Alias: keystoreAlias. Optional. Use when jarsign = true. Alias. 
    #jarsignerKeyPassword: # string. Alias: keyPass. Optional. Use when jarsign = true. Key password. 
    #jarsignerArguments: '-verbose -sigalg MD5withRSA -digestalg SHA1' # string. Optional. Use when jarsign = true. Jarsigner arguments. Default: -verbose -sigalg MD5withRSA -digestalg SHA1.
  # 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.

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

Assina o APK com um arquivo de repositório de chaves fornecido. APKs não assinados só podem ser executados em um emulador. As APKs devem ser assinadas para serem executadas em um dispositivo.


jarsignerKeystoreFile - Arquivo de repositório de chaves
Alias de entrada: keystoreFile. string. Obrigatório quando jarsign = 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.


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

A senha do arquivo android keystore fornecido.

Importante

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


jarsignerKeystoreAlias - Alias
Alias de entrada: keystoreAlias. string. Opcional. Use quando jarsign = true.

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


jarsignerKeyPassword - Senha de chave
Alias de entrada: keyPass. string. Opcional. Use quando jarsign = true.

A senha de chave para o alias e o arquivo do Android Keystore.

Importante

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


jarsignerArguments - Argumentos jarsigner
string. Opcional. Use quando jarsign = true. Valor padrão: -verbose -sigalg MD5withRSA -digestalg SHA1.

Fornece opções para passar para a jarsigner linha de comando.


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

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


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

Especifica o local do executável zipalign usado durante a 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.

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