Partager via


AndroidSigning@2 - Tâche de signature Android v2

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

Syntaxe

# Android Signing v2
# Sign and align Android APK files.
- task: AndroidSigning@2
  inputs:
    apkFiles: '**/*.apk' # string. Alias: files. Required. APK files. Default: **/*.apk.
  # Signing Options
    #jarsign: true # boolean. Sign the APK. Default: true.
    jarsignerKeystoreFile: # string. Alias: keystoreFile. Required when jarsign = true. Keystore file. 
    #jarsignerKeystorePassword: # string. Alias: keystorePass. Optional. Use when jarsign = true. Keystore password. 
    #jarsignerKeystoreAlias: # string. Alias: keystoreAlias. Optional. Use when jarsign = true. Alias. 
    #jarsignerKeyPassword: # string. Alias: keyPass. Optional. Use when jarsign = true. Key password. 
    #jarsignerArguments: '-verbose -sigalg MD5withRSA -digestalg SHA1' # string. Optional. Use when jarsign = true. Jarsigner arguments. Default: -verbose -sigalg MD5withRSA -digestalg SHA1.
  # 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.

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

Signe l’APK avec un fichier de magasin de clés fourni. Les API non signées ne peuvent s’exécuter que dans un émulateur. Les API doivent être signées pour s’exécuter sur un appareil.


jarsignerKeystoreFile - Fichier de magasin de clés
Alias d’entrée : keystoreFile. string. Obligatoire lorsque jarsign = true.

Chemin du fichier du magasin de clés Android 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 chiffrement. Le fichier Du 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é 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 génération.


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

Mot de passe du fichier Android Keystore fourni.

Important

Utilisez une nouvelle variable avec son verrou activé sous l’onglet Variables pour chiffrer cette valeur. Consultez les variables secrètes.


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

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


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

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

Important

Utilisez une nouvelle variable avec son verrou activé sous l’onglet Variables pour chiffrer cette valeur. Consultez les variables secrètes.


jarsignerArguments - Arguments Jarsigner
string. facultatif. Utilisez quand jarsign = true. Valeur par défaut : -verbose -sigalg MD5withRSA -digestalg SHA1.

Fournit des options pour passer à la jarsigner ligne de commande.


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

Sélectionnez cette valeur booléenne si vous souhaitez compresser votre package. Cela réduit la quantité de RAM consommée par une application.


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

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

Spécifications

Condition requise Description
Types de pipelines YAML, build classique
Exécutions sur Agent, DeploymentGroup
Demandes Les agents auto-hébergés doivent avoir des fonctionnalités qui correspondent aux exigences 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 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 la tâche Build
Condition requise Description
Types de pipelines YAML, build classique
Exécutions sur Agent, DeploymentGroup
Demandes Les agents auto-hébergés doivent avoir des fonctionnalités qui correspondent aux exigences 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
Exécutions sur Agent, DeploymentGroup
Demandes Les agents auto-hébergés doivent avoir des fonctionnalités qui correspondent aux exigences 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