KasperskyOS Community Edition 1.3

add_kpa_component()

Команда объявлена в файле /opt/KasperskyOS-Community-Edition-<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 – список переменных окружения для запуска программы.
    • 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")