AndroidSigning@3 — задача подписывания Android версии 3
Используйте эту задачу в конвейере для подписывания и выравнивания ФАЙЛОВ APK Android.
Синтаксис
# 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
подписывать все. APK-файлы в вложенной папкеoutputs\apk\
. -
**/bin/*.apk
подписывать все. APK-файлы во всех вложенных папкахbin
.
apksign
-
подписывание APK
boolean
. Значение по умолчанию: true
.
Подписывает APK с помощью предоставленного файла Хранилища ключей Android. Неподписанные API могут выполняться только в эмуляторе. Для запуска на устройстве должны быть подписаны ПАКЕТЫ AP.
файла хранилища ключей apksignerKeystoreFile
-
Псевдоним ввода: keystoreFile
.
string
. Требуется, если apksign = true
.
Путь к файлу Хранилища ключей Android, который используется для подписи APK. Этот файл должен быть отправлен в защищенные файлы библиотеки, где он безопасно хранится с шифрованием. Файл Хранилища ключей Android удаляется с компьютера агента после завершения конвейера.
Файл можно проверить в системе управления версиями или поместить на компьютер сборки непосредственно администратором. Рекомендуется шифровать файл хранилища ключей в системе управления версиями и использовать задачу Decrypt File
для расшифровки файла во время сборки.
apksignerKeystorePassword
-
паролей keystore
Псевдоним ввода: keystorePass
.
string
. Необязательно. Используется при apksign = true
.
Пароль ключа для предоставленного файла Хранилища ключей Android.
Это важно
Используйте новую переменную с включенным блокировкой на панели переменных, чтобы зашифровать это значение. См. секретных переменных.
apksignerKeystoreAlias
-
Псевдоним
Псевдоним ввода: keystoreAlias
.
string
. Необязательно. Используется при apksign = true
.
Псевдоним, определяющий пару открытого и закрытого ключа, которая будет использоваться в файле Хранилища ключей Android.
паролем ключа apksignerKeyPassword
-
Псевдоним ввода: keyPass
.
string
. Необязательно. Используется при apksign = true
.
Пароль ключа для псевдонима и файла хранилища ключей.
Это важно
Используйте новую переменную с включенным блокировкой на панели переменных, чтобы зашифровать это значение. См. секретных переменных.
apksignerVersion
-
apksigner версии
string
. Необязательно. Используется при apksign = true
. Значение по умолчанию: latest
.
Версия средств сборки пакета SDK для Android, которая использует исполняемый файл apksigner
для задачи.
apksignerArguments
-
аргументы apksigner
string
. Необязательно. Используется при apksign = true
. Значение по умолчанию: --verbose
.
Предоставляет параметры для передачи в командную строку apksigner
. См. документацию apksigner.
apksignerFile
-
расположение apksigner
Псевдоним ввода: apksignerLocation
.
string
. Необязательно. Используется при apksign = true
.
Указывает расположение исполняемого файла apksigner, используемого во время подписи. Это значение по умолчанию используется для apksigner, найденного в папке версии пакета SDK для Android, в которую выполняется сборка приложения.
zipalign
-
Zipalign
boolean
. Значение по умолчанию: true
.
Выберите, нужно ли zipalign ваш пакет. Это уменьшает объем ОЗУ, потребляемого приложением.
zipalignVersion
-
Zipalign версии
string
. Необязательно. Используется при zipalign = true
. Значение по умолчанию: latest
.
Версия средств сборки пакета SDK для Android, которая использует исполняемый файл zipalign
для задачи.
zipalignFile
-
расположение Zipalign
Псевдоним ввода: zipalignLocation
.
string
. Необязательно. Используется при zipalign = true
.
Указывает расположение исполняемого файла zipalign
, используемого во время подписи. По умолчанию используется zipalign
, найденный в папке версии пакета SDK для Android, в которую выполняется сборка приложения.
Параметры управления задачами
Помимо входных данных, все задачи имеют параметры управления. Дополнительные сведения см. в разделе Параметры управления и общие свойства задач.
Выходные переменные
Нет.
Замечания
Используйте эту задачу в конвейере для подписывания и выравнивания ФАЙЛОВ APK Android.
Эта версия задачи использует apksigner вместо jarsigner для подписывания API.
Требования
Требование | Описание |
---|---|
Типы конвейеров | YAML, классическая сборка |
Выполняется в | Агент, DeploymentGroup |
требования | Локальные агенты должны иметь возможности, соответствующие следующим требованиям для выполнения заданий, использующих эту задачу: JDK |
возможностей | Эта задача не удовлетворяет требованиям к последующим задачам в задании. |
ограничения команд | Эта задача выполняется с помощью следующих ограничений команд : ограничено. |
переменные settable | Эта задача имеет разрешение на задать следующие переменные: параметр переменных отключен |
Версия агента | 2.182.1 или более поздней версии |
Категория задач | Строить |
Требование | Описание |
---|---|
Типы конвейеров | YAML, классическая сборка |
Выполняется в | Агент, DeploymentGroup |
требования | Локальные агенты должны иметь возможности, соответствующие следующим требованиям для выполнения заданий, использующих эту задачу: JDK |
возможностей | Эта задача не удовлетворяет требованиям к последующим задачам в задании. |
ограничения команд | Любое |
переменные settable | Любое |
Версия агента | 2.116.0 или более поздней версии |
Категория задач | Строить |