Поделиться через


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 или более поздней версии
Категория задач Строить