AndroidSigning@3: tarea Firma de Android v3
Use esta tarea en una canalización para firmar y alinear archivos APK de Android.
Sintaxis
# 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.
Entradas
apkFiles
-
archivos APK
Alias de entrada: files
.
string
. Obligatorio. Valor predeterminado: **/*.apk
.
Ruta de acceso relativa de la raíz del repositorio a los APK que desea firmar. Puede usar caracteres comodín para especificar varios archivos. Por ejemplo:
-
outputs\apk*.apk
para firmar todo . Archivos APK en la subcarpetaoutputs\apk\
. -
**/bin/*.apk
para firmar todo . Archivos APK en todas las subcarpetasbin
.
apksign
-
firmar el de APK
boolean
. Valor predeterminado: true
.
Firma el APK con un archivo de almacén de claves de Android proporcionado. Las API sin firmar solo se pueden ejecutar en un emulador. Los APK deben estar firmados para ejecutarse en un dispositivo.
de archivos de almacén de claves de apksignerKeystoreFile
-
Alias de entrada: keystoreFile
.
string
. Obligatorio cuando apksign = true
.
Ruta de acceso del archivo al archivo de almacén de claves de Android que se usa para firmar el APK. Este archivo debe cargarse en el biblioteca de archivos seguros, donde se almacena de forma segura con cifrado. El archivo de almacén de claves de Android se quita de la máquina del agente cuando se completa la canalización.
El archivo se puede comprobar en el control de código fuente o colocarlo directamente en el equipo de compilación por parte de un administrador. Se recomienda cifrar el archivo de almacén de claves en el control de código fuente y usar la tarea Decrypt File
para descifrar el archivo durante la compilación.
de contraseña de almacén de claves de apksignerKeystorePassword
-
Alias de entrada: keystorePass
.
string
. Opcional. Use cuando apksign = true
.
Contraseña de clave del archivo de almacén de claves de Android proporcionado.
Importante
Use una nueva variable con su bloqueo habilitado en el panel Variables para cifrar este valor. Consulte variables secretas.
de alias de apksignerKeystoreAlias
-
Alias de entrada: keystoreAlias
.
string
. Opcional. Use cuando apksign = true
.
Alias que identifica el par de claves pública y privada que se va a usar en el archivo de almacén de claves de Android.
de contraseña de clave de apksignerKeyPassword
-
Alias de entrada: keyPass
.
string
. Opcional. Use cuando apksign = true
.
Contraseña de clave para el alias y el archivo de almacén de claves.
Importante
Use una nueva variable con su bloqueo habilitado en el panel Variables para cifrar este valor. Consulte variables secretas.
apksignerVersion
-
versión de apksigner
string
. Opcional. Use cuando apksign = true
. Valor predeterminado: latest
.
La versión de las herramientas de compilación de Android SDK que usa el ejecutable apksigner
para la tarea.
apksignerArguments
-
argumentos apksigner
string
. Opcional. Use cuando apksign = true
. Valor predeterminado: --verbose
.
Proporciona opciones para pasar a la línea de comandos de apksigner
. Consulte la documentación de apksigner.
apksignerFile
-
ubicación de apksigner
Alias de entrada: apksignerLocation
.
string
. Opcional. Use cuando apksign = true
.
Especifica la ubicación del ejecutable apksigner usado durante la firma. Este valor predeterminado es el apksigner que se encuentra en la carpeta de la versión de Android SDK en la que se compila la aplicación.
zipalign
-
zipalign
boolean
. Valor predeterminado: true
.
Seleccione si desea comprimir el paquete. Esto reduce la cantidad de RAM consumida por una aplicación.
de la versión zipalignVersion
- Zipalign
string
. Opcional. Use cuando zipalign = true
. Valor predeterminado: latest
.
La versión de las herramientas de compilación de Android SDK que usa el ejecutable zipalign
para la tarea.
zipalignFile
-
ubicación de Zipalign
Alias de entrada: zipalignLocation
.
string
. Opcional. Use cuando zipalign = true
.
Especifica la ubicación del archivo ejecutable de zipalign
usado durante la firma. Este valor predeterminado es el zipalign
que se encuentra en la carpeta versión de Android SDK en la que se compila la aplicación.
Opciones de control de tareas
Todas las tareas tienen opciones de control además de sus entradas de tarea. Para obtener más información, consulte Opciones de control y propiedades de tareas comunes.
Variables de salida
Ninguno.
Observaciones
Use esta tarea en una canalización para firmar y alinear archivos APK de Android.
Esta versión de la tarea usa apksigner en lugar de jarsigner para firmar LAS API.
Requisitos
Requisito | Descripción |
---|---|
Tipos de canalización | YAML, compilación clásica |
Se ejecuta en | Agente, DeploymentGroup |
demandas | Los agentes autohospedados deben tener funcionalidades que coincidan con los siguientes exigen ejecutar trabajos que usen esta tarea: JDK |
funcionalidades de |
Esta tarea no satisface ninguna demanda de tareas posteriores en el trabajo. |
restricciones de comandos | Esta tarea se ejecuta con las restricciones de comandos siguientes: restringido |
variables settable | Esta tarea tiene permiso para establecer las siguientes variables: La configuración de variables está deshabilitada. |
Versión del agente | 2.182.1 o superior |
Categoría de tarea | Construir |
Requisito | Descripción |
---|---|
Tipos de canalización | YAML, compilación clásica |
Se ejecuta en | Agente, DeploymentGroup |
demandas | Los agentes autohospedados deben tener funcionalidades que coincidan con los siguientes exigen ejecutar trabajos que usen esta tarea: JDK |
funcionalidades de |
Esta tarea no satisface ninguna demanda de tareas posteriores en el trabajo. |
restricciones de comandos | Cualquiera |
variables settable | Cualquiera |
Versión del agente | 2.116.0 o superior |
Categoría de tarea | Construir |