AndroidSigning@1 - Android 签名 v1 任务

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

语法

# Android Signing v1
# Sign and align Android APK files.
- task: AndroidSigning@1
  inputs:
    files: # string. Required. APK Files. 
  # Signing Options
    #jarsign: true # boolean. Sign the APK. Default: true.
    keystoreFile: # string. Required when jarsign = true. Keystore File. 
    #keystorePass: # string. Optional. Use when jarsign = true. Keystore Password. 
    #keystoreAlias: # string. Optional. Use when jarsign = true. Alias. 
    #keyPass: # string. 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.
    #zipalignLocation: # string. Optional. Use when zipalign = true. Zipalign Location.

输入

files - APK 文件
string。 必填。

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

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

默认值:/.apk 参数别名:apkFiles


jarsign - 对 APK 签名
boolean。 默认值:true

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


keystoreFile - 密钥存储文件
stringjarsign = true时是必需的。

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

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

参数别名:apksignerKeystoreFile


keystorePass - 密钥存储密码
string。 可选。 当 jarsign = true时使用。

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

重要

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

参数别名:apksignerKeystorePassword


keystoreAlias - 别名
string。 可选。 当 jarsign = true时使用。

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

参数别名:apksignerKeystoreAlias


keyPass - 密钥密码
string。 可选。 当 jarsign = true时使用。

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

重要

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


jarsignerArguments - Jarsigner 参数
string。 可选。 当 jarsign = true时使用。 默认值:-verbose -sigalg MD5withRSA -digestalg SHA1

提供传递给 jarsigner 命令行的选项。


zipalign - Zipalign 拉链
boolean。 默认值:true

如果要压缩包,请选择此布尔值。 这减少了应用消耗的 RAM 量。


zipalignLocation - Zipalign 位置
string。 可选。 当 zipalign = true时使用。

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

参数别名:zipalignFile


任务控制选项

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

输出变量

没有。

要求

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