AndroidSigning@2: tarea Firma de Android v2

Use esta tarea en una canalización para firmar y alinear archivos APK de Android.

Syntax

# 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.

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 outputs\apk\ subcarpeta.
  • **/bin/*.apk para firmar todo . Archivos APK en todas las bin subcarpetas.

jarsign - Firmar el APK
boolean. Valor predeterminado: true.

Firma el APK con un archivo de almacén de claves proporcionado. Las API sin firmar solo se pueden ejecutar en un emulador. Las API deben estar firmadas para ejecutarse en un dispositivo.


jarsignerKeystoreFile - Archivo de almacén de claves
Alias de entrada: keystoreFile. string. Obligatorio cuando jarsign = 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 la 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.

Un administrador puede comprobar el archivo en el control de código fuente o colocarlo directamente en el equipo de compilación. Se recomienda cifrar el archivo de almacén de claves en el control de código fuente y usar la Decrypt File tarea para descifrar el archivo durante la compilación.


jarsignerKeystorePassword - Contraseña del almacén de claves
Alias de entrada: keystorePass. string. Opcional. Use cuando jarsign = true.

Contraseña del archivo de almacén de claves de Android proporcionado.

Importante

Use una nueva variable con su bloqueo habilitado en la pestaña Variables para cifrar este valor. Consulte variables secretas.


jarsignerKeystoreAlias - Alias
Alias de entrada: keystoreAlias. string. Opcional. Use cuando jarsign = 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.


jarsignerKeyPassword - Contraseña de clave
Alias de entrada: keyPass. string. Opcional. Use cuando jarsign = true.

Contraseña de clave para el alias y el archivo de almacén de claves de Android.

Importante

Use una nueva variable con su bloqueo habilitado en la pestaña Variables para cifrar este valor. Consulte variables secretas.


jarsignerArguments - Argumentos de Jarsigner
string. Opcional. Use cuando jarsign = true. Valor predeterminado: -verbose -sigalg MD5withRSA -digestalg SHA1.

Proporciona opciones para pasar a la línea de jarsigner comandos.


zipalign - Zipalign
boolean. Valor predeterminado: true.

Seleccione este valor booleano si desea comprimir el paquete. Esto reduce la cantidad de RAM consumida por una aplicación.


zipalignFile - Ubicación de Zipalign
Alias de entrada: zipalignLocation. string. Opcional. Use cuando zipalign = true.

Especifica la ubicación del ejecutable zipalign usado durante la firma. Este valor predeterminado es zipalign que se encuentra en la carpeta de versión de Android SDK con 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 tareas. Para obtener más información, vea Opciones de control y propiedades de tareas comunes.

Variables de salida

Ninguno.

Requisitos

Requisito Descripción
Tipos de canalización YAML, compilación clásica
Se ejecuta en Agente, DeploymentGroup
Peticiones Los agentes autohospedados deben tener funcionalidades que coincidan con las siguientes demandas para ejecutar trabajos que usan esta tarea: JDK
Capabilities Esta tarea no satisface ninguna demanda de tareas posteriores en el trabajo.
Restricciones de comandos Esta tarea se ejecuta con las siguientes restricciones de comandos: restringido
Variables que se pueden establecer 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 la tarea: Compilar
Requisito Descripción
Tipos de canalización YAML, compilación clásica
Se ejecuta en Agente, DeploymentGroup
Peticiones Los agentes autohospedados deben tener funcionalidades que coincidan con las siguientes demandas para ejecutar trabajos que usan esta tarea: JDK
Capabilities Esta tarea no satisface ninguna demanda de tareas posteriores en el trabajo.
Restricciones de comandos Any
Variables que se pueden establecer Any
Versión del agente 2.116.0 o superior
Categoría de la tarea: Compilar
Requisito Descripción
Tipos de canalización YAML, compilación clásica
Se ejecuta en Agente, DeploymentGroup
Peticiones Los agentes autohospedados deben tener funcionalidades que coincidan con las siguientes demandas para ejecutar trabajos que usan esta tarea: JDK, AndroidSDK
Capabilities Esta tarea no satisface ninguna demanda de tareas posteriores en el trabajo.
Restricciones de comandos Any
Variables que se pueden establecer Any
Versión del agente 2.116.0 o superior
Categoría de la tarea: Compilar