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.

輸入

apkFiles - APK 檔案
輸入別名： files 。 string. 必要。 預設值：**/*.apk。

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

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

apksign - 簽署 APK
boolean. 預設值：true。

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

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

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

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

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

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

重要

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

apksignerKeystoreAlias - 別名
輸入別名： keystoreAlias 。 string. 選擇性。 使用 時 apksign = true 。

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

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

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

重要事項

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

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

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

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。

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

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

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

工作控制項選項

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

輸出變數

無。

備註

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

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

規格需求

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