tarefa AndroidSigning@1 – Assinatura do Android v1

Artigo
07/02/2024

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

Syntax

# Android Signing v1
# Sign and align Android APK files.
- task: AndroidSigning@1
  inputs:
    files: # string. Required. APK Files. 
  # Signing Options
    #jarsign: true # boolean. Sign the APK. Default: true.
    keystoreFile: # string. Required when jarsign = true. Keystore File. 
    #keystorePass: # string. Optional. Use when jarsign = true. Keystore Password. 
    #keystoreAlias: # string. Optional. Use when jarsign = true. Alias. 
    #keyPass: # string. 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.
    #zipalignLocation: # string. Optional. Use when zipalign = true. Zipalign Location.

Entradas

files - Arquivos APK
string. Obrigatórios.

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 para assinar tudo . Arquivos APK na outputs\apk\ subpasta.
**/bin/*.apk para assinar tudo . Arquivos APK em todas as bin subpastas.

O valor padrão: /aliases de argumento .apk: apkFiles

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

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

keystoreFile - Arquivo de repositório de chaves
string. Obrigatório quando jarsign = 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 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 de repositório de chaves no controle do código-fonte e usar a Decrypt File tarefa para descriptografar o arquivo durante o build.

Aliases de argumento: apksignerKeystoreFile

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

A senha de chave para o arquivo do 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. Confira variáveis secretas.

Aliases de argumento: apksignerKeystorePassword

keystoreAlias - Alias
string. Opcional. Use quando jarsign = true.

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

Aliases de argumento: apksignerKeystoreAlias

keyPass - Senha da chave
string. Opcional. Use quando jarsign = true.

A senha de chave para o alias e o arquivo do Repositório de Chaves do Android.

Importante

Use uma nova variável com seu bloqueio habilitado no painel Variáveis para criptografar esse valor. Confira 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 quiser fazer zipalign do pacote. Isso reduz a quantidade de RAM consumida por um aplicativo.

zipalignLocation - Local do Zipalign
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 com a qual o aplicativo é compilado.

Aliases de argumento: zipalignFile

Opções de controle da 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
É executado 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	1.98.1 ou superior
Categoria da tarefa	Build

Compartilhar via