AndroidSigning@2 - Android 簽署 v2 工作

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

Syntax

# Android Signing v2
# Sign and align Android APK files.
- task: AndroidSigning@2
  inputs:
    apkFiles: '**/*.apk' # string. Alias: files. Required. APK files. Default: **/*.apk.
  # Signing Options
    #jarsign: true # boolean. Sign the APK. Default: true.
    jarsignerKeystoreFile: # string. Alias: keystoreFile. Required when jarsign = true. Keystore file. 
    #jarsignerKeystorePassword: # string. Alias: keystorePass. Optional. Use when jarsign = true. Keystore password. 
    #jarsignerKeystoreAlias: # string. Alias: keystoreAlias. Optional. Use when jarsign = true. Alias. 
    #jarsignerKeyPassword: # string. Alias: keyPass. 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.
    #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 檔案。

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

使用提供的金鑰存放區檔案簽署 APK。 未簽署的 APK 只能在模擬器中執行。 必須簽署 APK，才能在裝置上執行。

jarsignerKeystoreFile - 金鑰存放區檔案
輸入別名： keystoreFile 。 string. 當 時為 必要 jarsign = true 專案。

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

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

jarsignerKeystorePassword - 金鑰儲存區密碼
輸入別名： keystorePass 。 string. 選擇性。 使用 時機 jarsign = true 。

所提供 Android Keystore 檔案的密碼。

重要

使用新的變數，並在 [變數] 索引標籤上啟用鎖定來加密此值。 請參閱 秘密變數。

jarsignerKeystoreAlias - 別名
輸入別名： keystoreAlias 。 string. 選擇性。 使用 時機 jarsign = true 。

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

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

別名和 Android Keystore 檔案的金鑰密碼。

重要事項

使用新的變數，並在 [變數] 索引標籤上啟用鎖定來加密此值。 請參閱 秘密變數。

jarsignerArguments - Jarsigner 引數
string. 選擇性。 使用 時機 jarsign = true 。 預設值：-verbose -sigalg MD5withRSA -digestalg SHA1。

提供傳遞至 jarsigner 命令列的選項。

zipalign - Zipalign
boolean. 預設值：true。

如果您想要壓縮套件，請選取此布林值。 這可減少應用程式所耗用的 RAM 數量。

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

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

工作控制選項

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

輸出變數

無。

規格需求

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