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.

入力

APKファイルを apkFiles - する
入力エイリアス: files。 string。 必須。 既定値: **/*.apk.

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

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

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

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

キーストア ファイルを 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するときに使用します。

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

重要

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

apksigner バージョンのを apksignerVersion - する
string。 任意 apksign = trueするときに使用します。 既定値: latest.

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

apksigner 引数を apksignerArguments - する
string。 任意 apksign = trueするときに使用します。 既定値: --verbose.

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

apksigner の場所を apksignerFile - する
入力エイリアス: apksignerLocation。 string。 任意 apksign = trueするときに使用します。

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

zipalign - ジップアライン
boolean。 既定値: true.

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

zipalignVersion - Zipalign バージョンの
string。 任意 zipalign = trueするときに使用します。 既定値: latest.

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

zipalignFile - Zipalign の場所
入力エイリアス: zipalignLocation。 string。 任意 zipalign = trueするときに使用します。

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

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

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

出力変数

なし。

注釈

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

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

必要条件

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