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 ファイル
入力エイリアス: files. string. 必須です。 既定値: **/*.apk

署名する APK へのリポジトリ ルートからの相対パス。 ワイルドカードを使用して 、複数の ファイルを指定できます。 次に例を示します。

  • outputs\apk*.apk すべて署名します。サブフォルダー内の outputs\apk\ APK ファイル。
  • **/bin/*.apk すべて署名します。すべての bin サブフォルダー内の APK ファイル。

apksign - APK に署名する
boolean. 既定値: true

提供された Android キーストア ファイルを使用して APK に署名します。 署名されていない API はエミュレーターでのみ実行できます。 デバイスで実行するには、API に署名する必要があります。


apksignerKeystoreFile - キーストア ファイル
入力エイリアス: keystoreFile. string. 次の場合に apksign = true必要です。

APK の署名に使用される Android キーストア ファイルのファイル パス。 このファイルは、暗号化を使用して 安全 に保存されるセキュリティで保護されたファイル ライブラリにアップロードする必要があります。 パイプラインが完了すると、Android キーストア ファイルがエージェント コンピューターから削除されます。

ファイルは、ソース管理にチェックインすることも、管理者が直接ビルド マシンに配置することもできます。 ソース管理でキーストア ファイルを暗号化し、タスクを Decrypt File 使用してビルド中にファイルの暗号化を解除することをお勧めします。


apksignerKeystorePassword - キーストアのパスワード
入力エイリアス: keystorePass. string. 省略可能。 次の場合に使用します apksign = true

指定された Android キーストア ファイルのキー パスワード。

重要

[変数] ペインでロックが有効になっている新しい変数を使用して、この値を暗号化します。 シークレット変数を参照してください。


apksignerKeystoreAlias - エイリアス
入力エイリアス: keystoreAlias. string. 省略可能。 次の場合に使用します apksign = true

Android キーストア ファイルで使用する公開キーと秘密キーのペアを識別するエイリアス。


apksignerKeyPassword - キー パスワード
入力エイリアス: keyPass. string. 省略可能。 次の場合に使用します apksign = true

別名ファイルと鍵ストア・ファイルのキー・パスワード。

重要

[変数] ペインでロックが有効になっている新しい変数を使用して、この値を暗号化します。 シークレット変数を参照してください。


apksignerVersion - apksigner バージョン
string. 省略可能。 次の場合に使用します apksign = true。 既定値: latest

実行可能ファイルがタスクに使用する apksigner Android SDK ビルド ツールのバージョン。


apksignerArguments - apksigner 引数
string. 省略可能。 次の場合に使用します apksign = true。 既定値: --verbose

コマンド ラインに渡すオプションを apksigner 提供します。 apksigner のドキュメントを参照してください


apksignerFile - apksigner の場所
入力エイリアス: apksignerLocation. string. 省略可能。 次の場合に使用します apksign = true

署名時に使用される apksigner 実行可能ファイルの場所を指定します。 既定では、アプリケーションがビルドする Android SDK バージョン フォルダーにある apksigner が使用されます。


zipalign - Zipalign
boolean. 既定値: true

パッケージを zipalign する場合に選択します。 これにより、アプリで消費される RAM の量が減ります。


zipalignVersion - Zipalign バージョン
string. 省略可能。 次の場合に使用します zipalign = true。 既定値: latest

実行可能ファイルがタスクに使用する zipalign Android SDK ビルド ツールのバージョン。


zipalignFile - Zipalign の場所
入力エイリアス: zipalignLocation. string. 省略可能。 次の場合に使用します zipalign = true

署名時に使用される実行可能ファイルの場所を zipalign 指定します。 既定では、アプリケーションの zipalign ビルド先の Android SDK バージョン フォルダーに含まれるものになります。


タスクコントロールのオプション

すべてのタスクには、タスク入力に加えて制御オプションがあります。 詳細については、 コントロール オプションと一般的なタスク プロパティに関するページを参照してください。

出力変数

[なし] :

解説

パイプラインでこのタスクを使用して、Android APK ファイルに署名して配置します。

このバージョンのタスクでは、jarsigner ではなく apksigner を使用して API に署名します。

必要条件

要件 説明
パイプラインの種類 YAML、クラシック ビルド
実行 エージェント、DeploymentGroup
確認要求 セルフホステッド エージェントには、このタスクを使用するジョブを実行するための次の要求に一致する機能が必要です。
Capabilities このタスクは、ジョブ内の後続のタスクに対する要求を満たしていません。
コマンドの制限 このタスクは、次の コマンド制限を使用して実行されます。
設定可能な変数 このタスクには、 次の変数を設定する権限があります。変数の設定は無効です
エージェントのバージョン 2.182.1 以降
タスクのカテゴリ ビルド
要件 説明
パイプラインの種類 YAML、クラシック ビルド
実行 エージェント、DeploymentGroup
確認要求 セルフホステッド エージェントには、このタスクを使用するジョブを実行するために、次の要求に一致する機能が必要です。
Capabilities このタスクは、ジョブ内の後続のタスクに対する要求を満たしていません。
コマンドの制限 Any
設定可能な変数 Any
エージェントのバージョン 2.116.0 以降
タスクのカテゴリ ビルド
要件 説明
パイプラインの種類 YAML、クラシック ビルド
実行 エージェント、DeploymentGroup
確認要求 セルフホステッド エージェントには、このタスクを使用するジョブを実行するために、次の要求に一致する機能が必要です: JDK、AndroidSDK
Capabilities このタスクは、ジョブ内の後続のタスクに対する要求を満たしていません。
コマンドの制限 Any
設定可能な変数 Any
エージェントのバージョン 2.116.0 以降
タスクのカテゴリ Build