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 密钥存储文件。

该文件可以签入源代码管理，也可以由管理员直接放置在生成计算机上。 建议加密源代码管理中的密钥存储文件，并使用 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。

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

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。

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

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

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

任务控制选项

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

输出变量

没有。

注解

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

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

要求

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