Partager via


AndroidSigning@3 - Tâche de signature Android v3

Utilisez cette tâche dans un pipeline pour signer et aligner les fichiers APK Android.

Syntaxe

# 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.

Entrées

apkFiles - Fichiers APK
Alias d’entrée : files. string. Obligatoire. Valeur par défaut : **/*.apk.

Chemin relatif de la racine du dépôt vers le ou les APK que vous souhaitez signer. Vous pouvez utiliser des caractères génériques pour spécifier plusieurs fichiers. Par exemple :

  • outputs\apk*.apk pour signer tout . Fichiers APK dans le outputs\apk\ sous-dossier.
  • **/bin/*.apk pour signer tout . Fichiers APK dans tous les bin sous-dossiers.

apksign - Signer l’APK
boolean. Valeur par défaut : true.

Signe l’APK avec un fichier Android Keystore fourni. Les API non signées peuvent uniquement s’exécuter dans un émulateur. Les API doivent être signées pour s’exécuter sur un appareil.


apksignerKeystoreFile - Fichier keystore
Alias d’entrée : keystoreFile. string. Obligatoire quand apksign = true.

Chemin d’accès au fichier Android Keystore utilisé pour signer l’APK. Ce fichier doit être chargé dans la bibliothèque de fichiers sécurisés , où il est stocké en toute sécurité avec le chiffrement. Le fichier Android Keystore est supprimé de l’ordinateur de l’agent lorsque le pipeline se termine.

Le fichier peut être vérifié dans le contrôle de code source ou placé directement sur l’ordinateur de build par un administrateur. Il est recommandé de chiffrer le fichier de magasin de clés dans le contrôle de code source et d’utiliser la Decrypt File tâche pour déchiffrer le fichier pendant la build.


apksignerKeystorePassword - Mot de passe du magasin de clés
Alias d’entrée : keystorePass. string. facultatif. Utilisez quand apksign = true.

Mot de passe de clé du fichier Android Keystore fourni.

Important

Utilisez une nouvelle variable avec son verrou activé dans le volet Variables pour chiffrer cette valeur. Consultez les variables secrètes.


apksignerKeystoreAlias - Alias
Alias d’entrée : keystoreAlias. string. facultatif. Utilisez quand apksign = true.

Alias qui identifie la paire de clés publique/privée à utiliser dans le fichier Android Keystore.


apksignerKeyPassword - Mot de passe clé
Alias d’entrée : keyPass. string. facultatif. Utilisez quand apksign = true.

Mot de passe de clé du fichier alias et du magasin de clés.

Important

Utilisez une nouvelle variable avec son verrou activé dans le volet Variables pour chiffrer cette valeur. Consultez les variables secrètes.


apksignerVersion - version d’apksigner
string. facultatif. Utilisez quand apksign = true. Valeur par défaut : latest.

Version des outils de build du Kit de développement logiciel (SDK) Android que l’exécutable apksigner utilise pour la tâche.


apksignerArguments - arguments apksigner
string. facultatif. Utilisez quand apksign = true. Valeur par défaut : --verbose.

Fournit des options pour passer à la apksigner ligne de commande. Consultez la documentation apksigner.


apksignerFile - emplacement apksigner
Alias d’entrée : apksignerLocation. string. facultatif. Utilisez quand apksign = true.

Spécifie l’emplacement de l’exécutable apksigner utilisé lors de la signature. Cette valeur par défaut est trouvée dans le dossier de version du Kit de développement logiciel (SDK) Android sur lequel votre application est générée.


zipalign - Zipalign
boolean. Valeur par défaut : true.

Sélectionnez si vous souhaitez zipalign votre package. Cela réduit la quantité de RAM consommée par une application.


zipalignVersion - Version zipalign
string. facultatif. Utilisez quand zipalign = true. Valeur par défaut : latest.

Version des outils de build du Kit de développement logiciel (SDK) Android que l’exécutable zipalign utilise pour la tâche.


zipalignFile - Emplacement Zipalign
Alias d’entrée : zipalignLocation. string. facultatif. Utilisez quand zipalign = true.

Spécifie l’emplacement de l’exécutable utilisé lors de la zipalign signature. Cette valeur par défaut est zipalign trouvée dans le dossier de version du Kit de développement logiciel (SDK) Android sur lequel votre application est générée.


Options de contrôle de tâche

Toutes les tâches ont des options de contrôle en plus de leurs entrées de tâche. Pour plus d’informations, consultez Options de contrôle et propriétés de tâche courantes.

Variables de sortie

Aucun.

Notes

Utilisez cette tâche dans un pipeline pour signer et aligner les fichiers APK Android.

Cette version de la tâche utilise apksigner au lieu de jarsigner pour signer des API.

Spécifications

Condition requise Description
Types de pipelines YAML, build classique
S’exécute sur Agent, DeploymentGroup
Demandes Les agents auto-hébergés doivent disposer de fonctionnalités qui correspondent aux demandes suivantes pour exécuter des travaux qui utilisent cette tâche : JDK
Capabilities Cette tâche ne répond à aucune demande de tâches ultérieures dans le travail.
Restrictions de commande Cette tâche s’exécute à l’aide des restrictions de commande suivantes : restreint
Variables settables Cette tâche a l’autorisation de définir les variables suivantes : la définition des variables est désactivée
Version de l’agent 2.182.1 ou version ultérieure
Catégorie de la tâche Build
Condition requise Description
Types de pipelines YAML, build classique
S’exécute sur Agent, DeploymentGroup
Demandes Les agents auto-hébergés doivent disposer de fonctionnalités qui correspondent aux demandes suivantes pour exécuter des travaux qui utilisent cette tâche : JDK
Capabilities Cette tâche ne répond à aucune demande de tâches ultérieures dans le travail.
Restrictions de commande Quelconque
Variables settables Quelconque
Version de l’agent 2.116.0 ou version ultérieure
Catégorie de la tâche Build
Condition requise Description
Types de pipelines YAML, build classique
S’exécute sur Agent, DeploymentGroup
Demandes Les agents auto-hébergés doivent disposer de fonctionnalités qui correspondent aux demandes suivantes pour exécuter des travaux qui utilisent cette tâche : JDK, AndroidSDK
Capabilities Cette tâche ne répond à aucune demande de tâches ultérieures dans le travail.
Restrictions de commande Quelconque
Variables settables Quelconque
Version de l’agent 2.116.0 ou version ultérieure
Catégorie de la tâche Build