共用方式為


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 instead to jarsigner 對 APK 進行簽名。 AdnroidSigning@2 使用 jarsigner 對 APK 和 AAB 進行簽名。

需求

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