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.

Ingressi dati

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. Per esempio:

• outputs\apk*.apk firmare tutto . File APK nella sottocartella outputs\apk\.
• **/bin/*.apk firmare tutto . File APK in tutte le sottocartelle bin.

apksign - Firmare il APK
boolean. Valore predefinito: true

Firma l'APK con un file di archivio chiavi Android fornito. Gli SDK non firmati possono essere eseguiti solo in un emulatore. Le API devono essere firmate per l'esecuzione in un dispositivo.

apksignerKeystoreFile - file dell'archivio chiavi
Alias di input: keystoreFile. string. Obbligatorio quando apksign = true.

Percorso del file dell'archivio chiavi Android usato per firmare l'APK. Questo file deve essere caricato nella file protetti libreria, in cui è archiviato in modo sicuro con la crittografia. Il file dell'archivio chiavi Android viene rimosso dal computer agente al termine della pipeline.

Il file può essere archiviato nel controllo del codice sorgente o inserito nel computer di compilazione direttamente da un amministratore. È consigliabile crittografare il file dell'archivio chiavi 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. Opzionale. Usare quando apksign = true.

Password della chiave per il file dell'archivio chiavi Android specificato.

Importante

Usare una nuova variabile con il relativo blocco abilitato nel riquadro Variabili per crittografare questo valore. Vedere variabili segrete.

alias apksignerKeystoreAlias -
Alias di input: keystoreAlias. string. Opzionale. Usare quando apksign = true.

Alias che identifica la coppia di chiavi pubblica/privata da usare nel file dell'archivio chiavi Android.

apksignerKeyPassword - password della chiave
Alias di input: keyPass. string. Opzionale. Usare quando apksign = true.

Password della chiave per l'alias e il file dell'archivio chiavi.

Importante

Usare una nuova variabile con il relativo blocco abilitato nel riquadro Variabili per crittografare questo valore. Vedere variabili segrete.

apksignerVersion - apksigner versione
string. Opzionale. Usare quando apksign = true. Valore predefinito: latest

Versione degli strumenti di compilazione di Android SDK usata dal apksigner eseguibile per l'attività.

apksignerArguments - argomenti apksigner
string. Opzionale. Usare quando apksign = true. Valore predefinito: --verbose

Fornisce opzioni da passare alla riga di comando apksigner. Vedere la documentazione di apksigner.

apksignerFile - percorso apksigner
Alias di input: apksignerLocation. string. Opzionale. Usare quando apksign = true.

Specifica il percorso dell'eseguibile apksigner usato durante la firma. Questa impostazione predefinita è apksigner presente nella cartella della versione di Android SDK rispetto alla quale viene compilata l'applicazione.

zipalign - Allineamento lampo
boolean. Valore predefinito: true

Selezionare se si vuole comprimere il pacchetto. In questo modo si riduce la quantità di RAM utilizzata da un'app.

zipalignVersion - versione Zipalign
string. Opzionale. Usare quando zipalign = true. Valore predefinito: latest

Versione degli strumenti di compilazione di Android SDK usata dal zipalign eseguibile per l'attività.

zipalignFile - percorso Zipalign
Alias di input: zipalignLocation. string. Opzionale. Usare quando zipalign = true.

Specifica il percorso del file eseguibile zipalign utilizzato durante la firma. Per impostazione predefinita, il zipalign presente nella cartella della versione di Android SDK rispetto alla quale viene compilata l'applicazione.

Opzioni di controllo delle 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

Nessuno.

Osservazioni:

Usare questa attività in una pipeline per firmare e allineare i file APK android.

Questa versione dell'attività utilizza apksigner invece di jarsigner firmare gli APK. AdnroidSigning@2 utilizza jarsigner per firmare APK e AAB.

Requisiti

Requisito	Descrizione
Tipi di pipeline	YAML, build classica
Viene eseguito in	Agente, DeploymentGroup
richieste	Gli agenti self-hosted devono avere funzionalità che corrispondono alle seguenti richiedono di eseguire processi che usano questa attività: JDK
funzionalità di	Questa attività non soddisfa alcuna richiesta di attività successive nel processo.
restrizioni dei comandi	Questa attività viene eseguita usando le restrizioni del comando seguenti: con restrizioni
variabili impostabili	Questa attività dispone dell'autorizzazione per impostare le variabili seguenti: L'impostazione delle variabili è disabilitata
Versione dell'agente	2.182.1 o versione successiva
Categoria attività	Costruire