AndroidSigning@3 - Attività Firma Android v3
Usare questa attività in una pipeline per firmare e allineare i file APK Android.
Sintassi
# 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.
Input
apkFiles
- File APK
Alias di input: files
. string
. Obbligatorio. Valore predefinito: **/*.apk
.
Percorso relativo dalla radice del repository agli APK che si desidera firmare. È possibile usare caratteri jolly per specificare più file. Ad esempio:
outputs\apk*.apk
per firmare tutto . File APK nellaoutputs\apk\
sottocartella.**/bin/*.apk
per firmare tutto . File APK in tutte lebin
sottocartelle.
apksign
- Firmare l'APK
boolean
. Valore predefinito: true
.
Firma l'APK con un file Android Keystore fornito. Gli SDK senza segno possono essere eseguiti solo in un emulatore. Gli API devono essere firmati per l'esecuzione in un dispositivo.
apksignerKeystoreFile
- File dell'archivio chiavi
Alias di input: keystoreFile
. string
. Obbligatorio quando apksign = true
.
Percorso file del file del file Android Keystore usato per firmare l'APK. Questo file deve essere caricato nella libreria dei file sicuri , in cui viene archiviato in modo sicuro con la crittografia. Il file android Keystore viene rimosso dal computer agente al completamento della pipeline.
Il file può essere controllato nel controllo del codice sorgente o inserito nel computer di compilazione direttamente da un amministratore. È consigliabile crittografare il file keystore nel controllo del codice sorgente e usare l'attività Decrypt File
per decrittografare il file durante la compilazione.
apksignerKeystorePassword
- Password dell'archivio chiavi
Alias di input: keystorePass
. string
. Facoltativa. Usare quando apksign = true
.
Password della chiave per il file Android Keystore specificato.
Importante
Usare una nuova variabile con il relativo blocco abilitato nel riquadro Variabili per crittografare questo valore. Vedere variabili segrete.
apksignerKeystoreAlias
- Alias
Alias di input: keystoreAlias
. string
. Facoltativa. Usare quando apksign = true
.
Alias che identifica la coppia di chiavi pubblica/privata da usare nel file Android Keystore.
apksignerKeyPassword
- Password chiave
Alias di input: keyPass
. string
. Facoltativa. Usare quando apksign = true
.
Password chiave per il file alias e keystore.
Importante
Usare una nuova variabile con il relativo blocco abilitato nel riquadro Variabili per crittografare questo valore. Vedere variabili segrete.
apksignerVersion
- versione apksigner
string
. Facoltativa. Usare quando apksign = true
. Valore predefinito: latest
.
Versione degli strumenti di compilazione di Android SDK usata dall'eseguibile apksigner
per l'attività.
apksignerArguments
- argomenti apksigner
string
. Facoltativa. Usare quando apksign = true
. Valore predefinito: --verbose
.
Fornisce opzioni da passare alla riga apksigner
di comando. Vedere la documentazione di apksigner.
apksignerFile
- posizione apksigner
Alias di input: apksignerLocation
. string
. Facoltativa. Usare quando apksign = true
.
Specifica il percorso dell'eseguibile apksigner usato durante la firma. Questo valore predefinito viene impostato sul file apksigner trovato nella cartella di versione di Android SDK in cui viene compilata l'applicazione.
zipalign
- Zipalign
boolean
. Valore predefinito: true
.
Selezionare se si vuole zipalignare il pacchetto. Ciò riduce la quantità di RAM utilizzata da un'app.
zipalignVersion
- Versione zipalign
string
. Facoltativa. Usare quando zipalign = true
. Valore predefinito: latest
.
Versione degli strumenti di compilazione di Android SDK usata dall'eseguibile zipalign
per l'attività.
zipalignFile
- Posizione zipalign
Alias di input: zipalignLocation
. string
. Facoltativa. Usare quando zipalign = true
.
Specifica il percorso del file eseguibile usato durante la zipalign
firma. Questa impostazione predefinita viene zipalign
visualizzata nella cartella della versione di Android SDK in cui viene compilata l'applicazione.
Opzioni di controllo attività
Tutte le attività dispongono di opzioni di controllo oltre ai relativi input attività. Per altre informazioni, vedere Opzioni di controllo e proprietà comuni delle attività.
Variabili di output
No.
Osservazioni
Usare questa attività in una pipeline per firmare e allineare i file APK Android.
Questa versione dell'attività usa apksigner anziché jarsigner per firmare gli SDK.
Requisiti
Requisito | Descrizione |
---|---|
Tipi di pipeline | YAML, build classica |
Esecuzione in | Agente, DeploymentGroup |
Richieste | Gli agenti self-hosted devono avere funzionalità che corrispondono alle richieste seguenti per eseguire processi che usano questa attività: JDK |
Capabilities | Questa attività non soddisfa le richieste per le attività successive nel processo. |
Restrizioni dei comandi | Questa attività viene eseguita usando le restrizioni di comando seguenti: limitato |
Variabili impostabili | Questa attività dispone dell'autorizzazione per impostare le variabili seguenti: l'impostazione delle variabili è disabilitata |
Versione agente | 2.182.1 o versione successiva |
Categoria attività | Compilare |
Requisito | Descrizione |
---|---|
Tipi di pipeline | YAML, build classica |
Esecuzione in | Agente, DeploymentGroup |
Richieste | Gli agenti self-hosted devono avere funzionalità che corrispondono alle richieste seguenti per eseguire processi che usano questa attività: JDK |
Capabilities | Questa attività non soddisfa le richieste per le attività successive nel processo. |
Restrizioni dei comandi | Qualsiasi |
Variabili impostabili | Qualsiasi |
Versione agente | 2.116.0 o versione successiva |
Categoria attività | Compilare |
Requisito | Descrizione |
---|---|
Tipi di pipeline | YAML, build classica |
Esecuzione in | Agente, DeploymentGroup |
Richieste | Gli agenti self-hosted devono avere funzionalità che corrispondono alle richieste seguenti per eseguire processi che usano questa attività: JDK, AndroidSDK |
Capabilities | Questa attività non soddisfa le richieste per le attività successive nel processo. |
Restrizioni dei comandi | Qualsiasi |
Variabili impostabili | Qualsiasi |
Versione agente | 2.116.0 o versione successiva |
Categoria attività | Compilare |