Partilhar via


AndroidSigning@3 - Tarefa de assinatura do Android v3

Utilize esta tarefa num oleoduto para assinar e alinhar ficheiros APK android.

Syntax

# 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 - Ficheiros APK
Pseudónimo de entrada: files. string. Obrigatório. Valor predefinido: **/*.apk.

O caminho relativo desde a raiz do repo até à APK(s) que pretende assinar. Pode utilizar wildcards para especificar vários ficheiros. Por exemplo:

  • outputs\apk*.apk para assinar tudo. Ficheiros APK na outputs\apk\ sub-dobra.
  • **/bin/*.apk para assinar tudo. Ficheiros APK em todas as bin sub-dobradeiras.

apksign - Assine o APK
boolean. Valor predefinido: true.

Assina o APK com um ficheiro Android Keystore fornecido. ApKs não assinados só podem funcionar num emulador. Os APKs devem ser assinados para funcionar num dispositivo.


apksignerKeystoreFile - Ficheiro Keystore
Pseudónimo de entrada: keystoreFile. string. Obrigatório quando apksign = true. .

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

O ficheiro pode ser verificado no controlo de origem ou colocado na máquina de construção diretamente por um administrador. Recomenda-se encriptar o ficheiro keystore no controlo de origem e utilizar a Decrypt File tarefa para desencriptar o ficheiro durante a construção.


apksignerKeystorePassword - Senha de Keystore
Pseudónimo de entrada: keystorePass. string. Opcional. Utilizar quando apksign = true.

A palavra-passe-chave para o ficheiro Android Keystore fornecido.

Importante

Utilize uma nova variável com o seu bloqueio ativado no painel de Variáveis para encriptar este valor. Ver variáveis secretas.


apksignerKeystoreAlias - Pseudónimo
Pseudónimo de entrada: keystoreAlias. string. Opcional. Utilizar quando apksign = true.

O pseudónimo que identifica o par de chaves público/privado a ser usado no ficheiro Android Keystore.


apksignerKeyPassword - Senha-chave
Pseudónimo de entrada: keyPass. string. Opcional. Utilizar quando apksign = true.

A palavra-passe chave para o pseudónimo e o ficheiro keystore.

Importante

Utilize uma nova variável com o seu bloqueio ativado no painel de Variáveis para encriptar este valor. Ver variáveis secretas.


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

A versão de ferramentas de construção Android SDK que o apksigner executável utiliza para a tarefa.


apksignerArguments - apksigner argumentos
string. Opcional. Utilizar quando apksign = true. Valor predefinido: --verbose.

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


apksignerFile - localização apksigner
Pseudónimo de entrada: apksignerLocation. string. Opcional. Utilizar quando apksign = true.

Especifica a localização do apksigner executável utilizado durante a assinatura. Isto é padrão para o apksigner encontrado na pasta de versão SDK do Android que a sua aplicação se constrói contra.


zipalign - Zipalign
boolean. Valor predefinido: true.

Selecione se quiser fechar o seu pacote. Isto reduz a quantidade de RAM consumida por uma aplicação.


zipalignVersion - Versão zipalign
string. Opcional. Utilizar quando zipalign = true. Valor predefinido: latest.

A versão de ferramentas de construção Android SDK que o zipalign executável utiliza para a tarefa.


zipalignFile - Localização zipalign
Pseudónimo de entrada: zipalignLocation. string. Opcional. Utilizar quando zipalign = true.

Especifica a localização do executável utilizado durante a zipalign assinatura. Isto desrescumbe ao zipalign encontrado na pasta de versão SDK do Android que a sua aplicação se constrói contra.


Opções de controlo de tarefas

Todas as tarefas têm opções de controlo para além das entradas de tarefa. Para obter mais informações, consulte opções de Controlo e propriedades de tarefas comuns.

Variáveis de saída

Nenhum.

Observações

Utilize esta tarefa num oleoduto para assinar e alinhar ficheiros APK android.

Esta versão da tarefa utiliza apksigner em vez de jarsigner para assinar APKs.

Requisitos

Requisito Description
Tipos de gasodutos YAML, construção clássica
Continua Agente, Grupo de Implementação
Exigências Os agentes auto-alojados devem ter capacidades que correspondam às seguintes exigências para executar empregos que utilizem esta tarefa: JDK
Capacidades Esta tarefa não satisfaz quaisquer pedidos para tarefas subsequentes no trabalho.
Restrições de comando Esta tarefa executa usando as seguintes restrições de comando: restritas
Variáveis de configuração Esta tarefa tem permissão para definir as seguintes variáveis: Definir variáveis é desativado
Versão do agente 2.182.1 ou maior
Categoria da tarefa Compilar
Requisito Description
Tipos de gasodutos YAML, construção clássica
Continua Agente, Grupo de Implementação
Exigências Os agentes auto-alojados devem ter capacidades que correspondam às seguintes exigências para executar empregos que utilizem esta tarefa: JDK
Capacidades Esta tarefa não satisfaz quaisquer pedidos para tarefas subsequentes no trabalho.
Restrições de comando Qualquer
Variáveis de configuração Qualquer
Versão do agente 2.116.0 ou maior
Categoria da tarefa Compilar
Requisito Description
Tipos de gasodutos YAML, construção clássica
Continua Agente, Grupo de Implementação
Exigências Os agentes auto-hospedados devem ter capacidades que correspondam às seguintes exigências para executar empregos que utilizem esta tarefa: JDK, AndroidSDK
Capacidades Esta tarefa não satisfaz quaisquer pedidos para tarefas subsequentes no trabalho.
Restrições de comando Qualquer
Variáveis de configuração Qualquer
Versão do agente 2.116.0 ou maior
Categoria da tarefa Compilar