共用方式為


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.
# 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 - 金鑰存放區檔案
輸入別名:keystoreFilestringapksign = 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

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


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

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


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

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


工作控制選項

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

輸出變數

沒有。

備註

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

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

需求

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