Nota
O acesso a esta página requer autorização. Podes tentar iniciar sessão ou mudar de diretório.
O acesso a esta página requer autorização. Podes tentar mudar de diretório.
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*.apkassinar tudo. APK na subpastaoutputs\apk\. -
**/bin/*.apkassinar tudo. APK em todas asbinsubpastas.
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 |