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 leoutputs\apk\
sous-dossier.**/bin/*.apk
pour signer tout . Fichiers APK dans tous lesbin
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 |