AndroidSigning@1 - Tâche De signature Android v1

Article
07/02/2024

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

Syntax

# Android Signing v1
# Sign and align Android APK files.
- task: AndroidSigning@1
  inputs:
    files: # string. Required. APK Files. 
  # Signing Options
    #jarsign: true # boolean. Sign the APK. Default: true.
    keystoreFile: # string. Required when jarsign = true. Keystore File. 
    #keystorePass: # string. Optional. Use when jarsign = true. Keystore Password. 
    #keystoreAlias: # string. Optional. Use when jarsign = true. Alias. 
    #keyPass: # string. 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.
    #zipalignLocation: # string. Optional. Use when zipalign = true. Zipalign Location.

Entrées

files - Fichiers APK
string. Obligatoire.

Chemin relatif de la racine du référentiel aux 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 tous les . Fichiers APK dans le outputs\apk\ sous-dossier.
**/bin/*.apk pour signer tous les . Fichiers APK dans tous les bin sous-dossiers.

Valeur par défaut : /alias d’argument .apk : apkFiles

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

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

keystoreFile - Fichier keystore
string. Nécessaire 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é de manière sécurisée avec chiffrement. Le fichier Android Keystore est supprimé de l’ordinateur 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 génération par un administrateur. Il est recommandé de chiffrer le fichier keystore 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.

Alias d’argument : apksignerKeystoreFile

keystorePass - Mot de passe keystore
string. facultatif. Utilisez quand jarsign = 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 de secret.

Alias d’argument : apksignerKeystorePassword

keystoreAlias - Alias
string. facultatif. Utilisez quand jarsign = true.

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

Alias d’argument : apksignerKeystoreAlias

keyPass - Mot de passe de clé
string. facultatif. Utilisez quand jarsign = true.

Mot de passe de clé pour l’alias et le fichier De keystore Android.

Important

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

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

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

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

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

zipalignLocation - Emplacement zipalign
string. facultatif. Utilisez quand zipalign = true.

Spécifie l’emplacement de l’exécutable zipalign utilisé lors de la signature. Il s’agit par défaut de zipalign trouvé dans le dossier de version du SDK Android sur lequel votre application est générée.

Alias d’argument : zipalignFile

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.

Configuration requise

Condition requise	Description
Types de pipelines	YAML, build classique
S’exécute 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 pour les tâches suivantes dans le travail.
Restrictions de commandes	Quelconque
Variables settables	Quelconque
Version de l’agent	1.98.1 ou version ultérieure
Catégorie de la tâche	Build

Partager via