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 nella outputs\apk\ sottocartella.
  • **/bin/*.apk per firmare tutto . File APK in tutte le bin 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