共用方式為


AndroidSigning@3 - Android 簽署 v3 工作

在管線中使用這項工作來簽署並對齊 Android APK 檔案。

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.

輸入

apkFiles - APK 檔案
輸入別名: filesstring. 必要。 預設值:**/*.apk

從存放庫根目錄到 APK 的相對路徑, (您想要簽署的) 。 您可以使用 萬用字元 來指定多個檔案。 例如:

  • outputs\apk*.apk 表示簽署所有 。子資料夾中的 outputs\apk\ APK 檔案。
  • **/bin/*.apk 表示簽署所有 。所有子資料夾中的 bin APK 檔案。

apksign - 簽署 APK
boolean. 預設值:true

使用提供的 Android Keystore 檔案簽署 APK。 未簽署的 APK 只能在模擬器中執行。 必須簽署 APK 才能在裝置上執行。


apksignerKeystoreFile - 金鑰存放區檔案
輸入別名: keystoreFilestring. 需要 。 apksign = true

用來簽署 APK 之 Android Keystore 檔案的檔案路徑。 此檔案必須上傳至 安全檔案 庫,該程式庫會使用加密安全地儲存。 當管線完成時,Android Keystore 檔案會從代理程式電腦中移除。

檔案可以簽入原始檔控制,或直接由系統管理員放在建置電腦上。 建議您在原始檔控制中加密金鑰存放區檔案,並使用 Decrypt File 工作在建置期間解密檔案。


apksignerKeystorePassword - 金鑰存放區密碼
輸入別名: keystorePassstring. 選擇性。 使用 時 apksign = true

所提供 Android Keystore 檔案的金鑰密碼。

重要

使用新的變數,並在 [變數] 窗格上啟用其鎖定,以加密此值。 請參閱 秘密變數


apksignerKeystoreAlias - 別名
輸入別名: keystoreAliasstring. 選擇性。 使用 時 apksign = true

識別要用於 Android Keystore 檔案中之公開/私密金鑰組的別名。


apksignerKeyPassword - 金鑰密碼
輸入別名: keyPassstring. 選擇性。 使用 時 apksign = true

別名和金鑰存放區檔案的金鑰密碼。

重要事項

使用新的變數,並在 [變數] 窗格上啟用其鎖定,以加密此值。 請參閱 秘密變數


apksignerVersion - apksigner 版本
string. 選擇性。 使用 時 apksign = true 。 預設值:latest

可執行檔用於工作的 Android SDK 組建工具版本 apksigner


apksignerArguments - apksigner 引數
string. 選擇性。 使用 時 apksign = true 。 預設值:--verbose

提供傳遞至 apksigner 命令列的選項。 請參閱 apksigner 檔


apksignerFile - apksigner 位置
輸入別名: apksignerLocationstring. 選擇性。 使用 時 apksign = true

指定在簽署期間使用的 apksigner 可執行檔位置。 這會預設為在應用程式建置的 Android SDK 版本資料夾中找到的 apksigner。


zipalign - Zipalign
boolean. 預設值:true

如果您想要壓縮套件,請選取 。 這樣可減少應用程式耗用的 RAM 數量。


zipalignVersion - Zipalign 版本
string. 選擇性。 使用 時 zipalign = true 。 預設值:latest

可執行檔用於工作的 Android SDK 組建工具版本 zipalign


zipalignFile - Zipalign 位置
輸入別名: zipalignLocationstring. 選擇性。 使用 時 zipalign = true

指定簽署期間所使用的可執行檔位置 zipalign 。 這會預設為 zipalign 在應用程式建置的 Android SDK 版本資料夾中找到的 。


工作控制項選項

除了工作輸入之外,所有工作都有控制選項。 如需詳細資訊,請參閱 控制選項和一般工作屬性

輸出變數

無。

備註

在管線中使用這項工作來簽署並對齊 Android APK 檔案。

此版本的工作會使用 apksigner,而不是 jarsigner 來簽署 APK。

規格需求

需求 描述
管線類型 YAML、傳統組建
在 上執行 Agent、DeploymentGroup
要求 自我裝載代理程式必須具備符合下列需求的功能,才能執行使用此工作的作業:JDK
Capabilities 此工作不符合作業中後續工作的任何需求。
命令限制 此工作會使用下列 命令限制執行:受限制
可設定變數 此工作有權 設定下列變數:已停用設定變數
代理程式版本 2.182.1 或更新版本
工作類別 建置
需求 描述
管線類型 YAML、傳統組建
在 上執行 Agent、DeploymentGroup
要求 自我裝載代理程式必須具備符合下列需求的功能,才能執行使用此工作的作業:JDK
Capabilities 此工作不符合作業中後續工作的任何需求。
命令限制 任意
可設定變數 任意
代理程式版本 2.116.0 或更新版本
工作類別 建置
需求 描述
管線類型 YAML、傳統組建
在 上執行 Agent、DeploymentGroup
要求 自我裝載代理程式必須具備符合下列需求的功能,才能執行使用此工作的作業:JDK、AndroidSDK
Capabilities 此工作不符合作業中後續工作的任何需求。
命令限制 任意
可設定變數 任意
代理程式版本 2.116.0 或更新版本
工作類別 建置