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.

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 caractères génériques pour spécifier plusieurs fichiers. Par exemple:

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

apksign - signer le 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 de magasin de clés
Alias d’entrée : keystoreFile. string. Obligatoire lorsque apksign = true.

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

Le fichier peut être archivé dans le contrôle de code source ou placé sur l’ordinateur de build directement 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 tâche Decrypt File pour déchiffrer le fichier pendant la génération.

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

Mot de passe de clé pour le fichier Android Keystore fourni.

Important

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

d’alias apksignerKeystoreAlias -
Alias d’entrée : keystoreAlias. string. Optionnel. 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 de clé
Alias d’entrée : keyPass. string. Optionnel. Utilisez quand apksign = true.

Mot de passe de clé pour le fichier d’alias et de magasin de clés.

Important

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

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

Version des outils de build android que l’exécutable apksigner utilise pour la tâche.

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

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

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

Spécifie l’emplacement de l’exécutable apksigner utilisé lors de la signature. Cette valeur par défaut est l’apksigner trouvé 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 compresser votre package. Cela réduit la quantité de RAM consommée par une application.

zipalignVersion - version Zipalign
string. Optionnel. Utilisez quand zipalign = true. Valeur par défaut : latest.

Version des outils de build android que l’exécutable zipalign utilise pour la tâche.

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

Spécifie l’emplacement de l’exécutable zipalign utilisé lors de la signature. Cette valeur par défaut est la 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 la tâche

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

Variables de sortie

Aucun.

Remarques

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 signer des APK. AdnroidSigning@2 utilise jarsigner pour signer les APK et les AAB.

Spécifications

Besoin	Descriptif
Types de pipelines	YAML, build classique
Exécutions sur	Agent, DeploymentGroup
demandes	Les agents auto-hébergés doivent disposer de fonctionnalités qui correspondent aux exigences de suivantes pour exécuter des travaux qui utilisent cette tâche : JDK
fonctionnalités de	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 est autorisée à 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 tâche	Construire