AndroidSigning@3 - Tugas Penandatanganan Android v3

Gunakan tugas ini dalam alur untuk menandatangani dan menyelaraskan file ANDROID APK.

Sintaks

# 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.

Input

apkFiles - File APK
Alias input: files. string. Wajib diisi. Nilai default: **/*.apk.

Jalur relatif dari akar repositori ke APK yang ingin Anda tanda tangani. Anda dapat menggunakan kartubebas untuk menentukan beberapa file. Contohnya:

• outputs\apk*.apk untuk menandatangani semua . File APK di outputs\apk\ subfolder.
• **/bin/*.apk untuk menandatangani semua . File APK di semua bin subfolder.

apksign - Menandatangani APK
boolean. Nilai default: true.

Menandatangani APK dengan file Keystore Android yang disediakan. APK yang tidak ditandatangani hanya dapat berjalan di emulator. APK harus ditandatangani untuk berjalan pada perangkat.

apksignerKeystoreFile - File keystore
Alias input: keystoreFile. string. Diperlukan saat apksign = true.

Jalur file ke file Android Keystore yang digunakan untuk menandatangani APK. File ini harus diunggah ke pustaka file aman , di mana file tersebut disimpan dengan aman dengan enkripsi. File Android Keystore dihapus dari mesin agen saat alur selesai.

File dapat diperiksa ke kontrol sumber atau ditempatkan pada komputer build langsung oleh administrator. Disarankan untuk mengenkripsi file keystore dalam kontrol sumber dan menggunakan Decrypt File tugas untuk mendekripsi file selama build.

apksignerKeystorePassword - Kata sandi keystore
Alias input: keystorePass. string. Opsional. Gunakan saat apksign = true.

Kata sandi kunci untuk file Keystore Android yang disediakan.

Penting

Gunakan variabel baru dengan kuncinya diaktifkan pada panel Variabel untuk mengenkripsi nilai ini. Lihat variabel rahasia.

apksignerKeystoreAlias - Alias
Alias input: keystoreAlias. string. Opsional. Gunakan saat apksign = true.

Alias yang mengidentifikasi pasangan kunci publik/privat yang akan digunakan dalam file Keystore Android.

apksignerKeyPassword - Kata sandi kunci
Alias input: keyPass. string. Opsional. Gunakan saat apksign = true.

Kata sandi kunci untuk file alias dan keystore.

Penting

Gunakan variabel baru dengan kuncinya diaktifkan pada panel Variabel untuk mengenkripsi nilai ini. Lihat variabel rahasia.

apksignerVersion - versi apksigner
string. Opsional. Gunakan saat apksign = true. Nilai default: latest.

Versi build-tools Android SDK yang apksigner digunakan executable untuk tugas tersebut.

apksignerArguments - argumen apksigner
string. Opsional. Gunakan saat apksign = true. Nilai default: --verbose.

Menyediakan opsi untuk diteruskan ke apksigner baris perintah. Lihat dokumentasi apksigner.

apksignerFile - lokasi apksigner
Alias input: apksignerLocation. string. Opsional. Gunakan saat apksign = true.

Menentukan lokasi executable apksigner yang digunakan selama penandatanganan. Ini default ke apksigner yang ditemukan di folder versi Android SDK yang dibangun aplikasi Anda.

zipalign - Zipalign
boolean. Nilai default: true.

Pilih jika Anda ingin membuat zipalign paket Anda. Ini mengurangi jumlah RAM yang digunakan oleh aplikasi.

zipalignVersion - Versi Zipalign
string. Opsional. Gunakan saat zipalign = true. Nilai default: latest.

Versi build-tools Android SDK yang zipalign digunakan executable untuk tugas tersebut.

zipalignFile - Lokasi Zipalign
Alias input: zipalignLocation. string. Opsional. Gunakan saat zipalign = true.

Menentukan lokasi executable yang zipalign digunakan selama penandatanganan. Ini default ke yang zipalign ditemukan di folder versi Android SDK yang dibangun aplikasi Anda.

Opsi kontrol tugas

Semua tugas memiliki opsi kontrol selain input tugas mereka. Untuk informasi selengkapnya, lihat Opsi kontrol dan properti tugas umum.

Variabel output

Tidak ada.

Keterangan

Gunakan tugas ini dalam alur untuk menandatangani dan menyelaraskan file ANDROID APK.

Versi tugas ini menggunakan apksigner alih-alih jarsigner untuk menandatangani APK.

Persyaratan

Persyaratan	Deskripsi
Jenis alur	YAML, Build klasik
Berjalan pada	Agen, DeploymentGroup
Permintaan	Agen yang dihost sendiri harus memiliki kemampuan yang sesuai dengan tuntutan berikut untuk menjalankan pekerjaan yang menggunakan tugas ini: JDK
Kemampuan	Tugas ini tidak memenuhi tuntutan untuk tugas berikutnya dalam pekerjaan.
Pembatasan perintah	Tugas ini berjalan menggunakan pembatasan perintah berikut: dibatasi
Variabel yang dapat diatur	Tugas ini memiliki izin untuk mengatur variabel berikut: Variabel pengaturan dinonaktifkan
Versi agen	2.182.1 atau lebih tinggi
Kategori tugas	Build