add_kpa_component()

Команда объявлена в файле /opt/KasperskyOS-Community-Edition-<platform>-<version>/toolchain/share/cmake/Modules/platform/kpa.cmake.

add_kpa_component(PACKAGE_NAME MODE ...)

Команда добавляет компонент в указанную CMake-цель сборки KPA-пакета. Эту команду можно вызывать несколько раз для одной цели сборки KPA-пакета. Цель сборки KPA-пакета создается командой add_kpa_package().

Параметры:

• PACKAGE_NAME – имя CMake-цели сборки KPA-пакета. Обязательный параметр.
• MODE – тип компонента. Обязательный параметр. Возможны следующие значения:
  • LIBRARY – компонент является динамической библиотекой. Необходимо указать полный путь к файлу или имя CMake-цели. При установке KPA-пакета помещается в директорию /<имя_пакета>/lib.
  • FILES – компонент является файлом. Необходимо указать полный путь к файлу. При установке KPA-пакета помещается в директорию /<имя_пакета>/res.
  • DIRECTORY – компонент является директорией с файлами. Необходимо указать полный путь к директории. При установке KPA-пакета помещается в директорию /<имя_пакета>/res.
  • RUN_CONFIGURATION – компонент является конфигурацией запуска программы. Необходимо указать следующие параметры:
    • ID – уникальный в рамках KPA-пакета идентификатор конфигурации запуска программы. Обязательный параметр.
    • NAME – имя конфигурации запуска. Обязательный параметр.
    • TYPE – тип конфигурации запуска: "gui" – процесс с графическим пользовательским интерфейсом или "service" – процесс-служба. Обязательный параметр.
    • PATH – полный путь к исполняемому файлу компонента после установки KPA-пакета относительно директории /<имя_пакета>.
    • EIID – класс безопасности программы. Обязательный параметр.
    • PRIMARY – указывает, является эта конфигурация запуска первичной при старте программы.
    • AUTORUN – указывает, является ли эта конфигурация запускаемой автоматически.
    • ARGS – список аргументов командной строки для запуска программы в виде массива строк.
    • ENV – список переменных окружения для запуска программы.

      Если запускаемая программа использует файловые системы (через компонент VFS), то необходимо указать значение "VFS_FILESYSTEM_BACKEND=client:kl.VfsSdCardFs" в поле ENV.

  • RESOURCE – используется для добавления произвольных данных в KPA-пакет. Необходимо указать следующие параметры:
    • полный путь к файлу или директории, содержащей данные. Обязательный параметр
    • В параметре TYPE указать тип данных: "res", "bin", "lib" или "manifestLocale". Обязательный параметр. Подробнее см. "Список объектов components".
    • Опционально, в параметре DIRECTORY_PATH указать путь к директории, в которую данные будут помещены после установки KPA-пакета, относительно директории /<имя_пакета>/res.

Примеры вызова:

include (platform/kpa)

# Добавление исполняемого файла программы

add_kpa_component(Hello.kpa RESOURCE ".build/aarch64-kos-debug/hello/Hello" TYPE "bin" DIRECTORY_PATH "bin/")

# Добавление конфигурации запуска программы

add_kpa_component(Hello.kpa RUN_CONFIGURATION "app" NAME "Hello app" TYPE "service" EIID "hello.Hello" PATH "bin/Hello")