Compartir a través de


AndroidSigning@3: tarea Firma de Android v3

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

Syntax

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

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

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


apksignerKeystoreFile - Archivo de almacén de claves
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 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.


apksignerKeystorePassword - Contraseña del almacén de claves
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.


apksignerKeystoreAlias - Alias
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.


apksignerKeyPassword - Contraseña de clave
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 apksigner ejecutable para la tarea.


apksignerArguments - argumentos de apksigner
string. Opcional. Use cuando apksign = true. Valor predeterminado: --verbose.

Proporciona opciones para pasar a la línea de apksigner comandos. 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 de apksigner usado durante la firma. Este valor predeterminado es el apksigner que se encuentra en la carpeta de 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.


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

Variables de salida

Ninguno.

Comentarios

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
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 usen 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 usen 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