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


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. Неподписанные APK могут выполняться только в эмуляторе. Пакеты APK должны быть подписаны для запуска на устройстве.


apksignerKeystoreFile - Файл хранилища ключей
Псевдоним ввода: keystoreFile. string. Обязательный, если apksign = true.

Путь к файлу хранилища ключей Android, который используется для подписи APK. Этот файл должен быть передан в библиотеку защищенных файлов , где он безопасно хранится с шифрованием. После завершения конвейера файл хранилища ключей Android удаляется с компьютера агента.

Файл можно проверить в системе управления версиями или поместить на компьютер сборки непосредственно администратором. Рекомендуется шифровать файл хранилища ключей в системе управления версиями и использовать Decrypt File задачу для расшифровки файла во время сборки.


apksignerKeystorePassword - Пароль хранилища ключей
Псевдоним ввода: 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, для которую выполняется сборка приложения.


Параметры управления задачами

Все задачи имеют параметры управления в дополнение к входным данным задачи. Дополнительные сведения см. в разделе "Параметры управления" и общие свойства задачи.

Выходные переменные

Нет.

Remarks

Эта задача используется в конвейере для подписывания и выравнивания ФАЙЛОВ APK Android.

Эта версия задачи использует apksigner вместо jarsigner для подписывания APK.

Требования

Требование Описание
Типы конвейеров YAML, классическая сборка
Выполняется в Agent, DeploymentGroup
Требования Локальные агенты должны иметь возможности , соответствующие следующим требованиям для выполнения заданий, использующих эту задачу: JDK
Capabilities Эта задача не удовлетворяет требованиям к последующим задачам в задании.
Ограничения команд Эта задача выполняется с использованием следующих ограничений команд: restricted
Переменные settable Эта задача имеет разрешение на задание следующих переменных: установка переменных отключена.
Версия агента 2.182.1 или более поздней версии
Категория задач Сборка
Требование Описание
Типы конвейеров YAML, классическая сборка
Выполняется в Agent, DeploymentGroup
Требования Локальные агенты должны иметь возможности , соответствующие следующим требованиям для выполнения заданий, использующих эту задачу: JDK
Capabilities Эта задача не удовлетворяет требованиям к последующим задачам в задании.
Ограничения команд Любой
Переменные settable Любой
Версия агента 2.116.0 или более поздней версии
Категория задач Сборка
Требование Описание
Типы конвейеров YAML, классическая сборка
Выполняется в Agent, DeploymentGroup
Требования Локальные агенты должны иметь возможности , соответствующие следующим требованиям для выполнения заданий, использующих эту задачу: JDK, AndroidSDK.
Capabilities Эта задача не удовлетворяет требованиям к последующим задачам в задании.
Ограничения команд Любой
Переменные settable Любой
Версия агента 2.116.0 или более поздней версии
Категория задач Сборка