AndroidSigning@1 - Android 簽署 v1 工作

發行項
06/11/2024

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

Syntax

# Android Signing v1
# Sign and align Android APK files.
- task: AndroidSigning@1
  inputs:
    files: # string. Required. APK Files. 
  # Signing Options
    #jarsign: true # boolean. Sign the APK. Default: true.
    keystoreFile: # string. Required when jarsign = true. Keystore File. 
    #keystorePass: # string. Optional. Use when jarsign = true. Keystore Password. 
    #keystoreAlias: # string. Optional. Use when jarsign = true. Alias. 
    #keyPass: # string. 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.
    #zipalignLocation: # string. Optional. Use when zipalign = true. Zipalign Location.

輸入

files - APK 檔案
string. 必要。

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

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

預設值： /.apk Argument 別名： apkFiles

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

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

keystoreFile - 金鑰存放區檔案
string. 當 jarsign = true 時為必要。

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

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

自變數別名： apksignerKeystoreFile

keystorePass - 金鑰儲存區密碼
string. 選擇性。使用時機 jarsign = true。

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

重要

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

自變數別名： apksignerKeystorePassword

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

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

自變數別名： apksignerKeystoreAlias

keyPass - 金鑰密碼
string. 選擇性。使用時機 jarsign = true。

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

重要

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

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

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

zipalign - Zipalign
boolean. 預設值：true。

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

zipalignLocation - Zipalign 位置
string. 選擇性。使用時機 zipalign = true。

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

自變數別名： zipalignFile

工作控制選項

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

輸出變數

無。

規格需求

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

共用方式為