AndroidSigning@3 - Android 签名 v3 任务

在管道中使用此任务对 Android APK 文件进行签名和对齐。

语法

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

输入

apkFiles - APK 文件
输入别名： files. string. 必需。 默认值：**/*.apk。

从存储库根目录到要签名的 APK () 的相对路径。 可以使用 通配符 指定多个文件。 例如：

• outputs\apk*.apk 表示全部签名。子文件夹中的 outputs\apk\ APK 文件。
• **/bin/*.apk 表示全部签名。所有子文件夹中的 bin APK 文件。

apksign - 对 APK 进行签名
boolean. 默认值：true。

使用提供的 Android 密钥存储文件对 APK 进行签名。 未签名的 APK 只能在模拟器中运行。 必须对 APK 进行签名才能在设备上运行。

apksignerKeystoreFile - 密钥存储文件
输入别名： keystoreFile. string. 在 .apksign = true

用于对 APK 进行签名的 Android 密钥存储文件的文件路径。 此文件必须上传到 安全文件 库，其中使用加密安全地存储该文件。 管道完成后，将从代理计算机中删除 Android Keystore 文件。

该文件可以签入源代码管理，也可以由管理员直接签入生成计算机上。 建议加密源代码管理中的密钥存储文件，并在生成过程中使用该 Decrypt File 任务解密文件。

apksignerKeystorePassword - 密钥存储密码
输入别名： keystorePass. string. 可选。 使用时间 apksign = true。

提供的 Android 密钥存储文件的密钥密码。

重要

在“变量”窗格上启用锁的新变量来加密此值。 请参阅 机密变量。

apksignerKeystoreAlias - 别名
输入别名： keystoreAlias. string. 可选。 使用时间 apksign = true。

标识要用于 Android 密钥存储文件中的公钥/私钥对的别名。

apksignerKeyPassword - 密钥密码
输入别名： keyPass. string. 可选。 使用时间 apksign = true。

别名和密钥存储文件的密钥密码。

重要

在“变量”窗格上启用锁的新变量来加密此值。 请参阅 机密变量。

apksignerVersion - apksigner 版本
string. 可选。 使用时间 apksign = true。 默认值：latest。

可执行文件用于任务的 Android SDK 生成工具版本 apksigner 。

apksignerArguments - apksigner 参数
string. 可选。 使用时间 apksign = true。 默认值：--verbose。

提供传递给 apksigner 命令行的选项。 请参阅 apksigner 文档。

apksignerFile - apksigner 位置
输入别名： apksignerLocation. string. 可选。 使用时间 apksign = true。

指定在签名期间使用的 apksigner 可执行文件的位置。 这默认为应用程序针对的 Android SDK 版本文件夹中找到的 apksigner。

zipalign - Zipalign
boolean. 默认值：true。

选择是否要压缩包。 这减少了应用消耗的 RAM 量。

zipalignVersion - Zipalign 版本
string. 可选。 使用时间 zipalign = true。 默认值：latest。

可执行文件用于任务的 Android SDK 生成工具版本 zipalign 。

zipalignFile - Zipalign 位置
输入别名： zipalignLocation. string. 可选。 使用时间 zipalign = true。

指定在签名期间使用的可执行文件的位置 zipalign 。 这默认为 zipalign 应用程序所基于的 Android SDK 版本文件夹中找到的内容。

任务控制选项

除任务输入外，所有任务都具有控制选项。 有关详细信息，请参阅 “控制”选项和常见任务属性。

输出变量

无。

备注

在管道中使用此任务对 Android APK 文件进行签名和对齐。

此版本的任务使用 apksigner 而不是 jarsigner 对 APK 进行签名。

要求

要求	说明
管道类型	YAML，经典生成
运行平台	代理，DeploymentGroup
需求	自承载代理必须具有与以下要求匹配的功能才能运行使用此任务的作业：JDK
功能	此任务不满足作业中后续任务的任何要求。
命令限制	此任务使用 以下命令限制运行：受限
可设置变量	此任务有权 设置以下变量：禁用设置变量
代理版本	2.182.1 或更高版本
任务类别	生成