パイプラインでこのタスクを使用して、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.
入力
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 に署名します。