Расширение автоматически обнаруживает в открытом рабочем пространстве проект KasperskyOS и запускается. Параметр обнаружения – наличие в рабочем пространстве файла .vscode/kos_project.json
или директории einit
. Если расширение автоматически не активировалось в директории, но вы уверены, что это проект KasperskyOS, то выполните команду KOS: Activate extension in this directory
. Команда активирует расширение и создает в директории проекта пустой файл .vscode/kos_project.json
. Чтобы отменить ручную активацию, удалите этот файл.
После запуска расширение добавляет на нижнюю панель редактора кода Visual Studio Code следующие кнопки:
Функции, которые предоставляют кнопки, также можно вызвать из командной строки редактора кода, открываемой по нажатию на клавишу F1. Все команды имеют префикс KOS:
.
Работа с базовым образом KasperskyOS
Расширение позволяет не выполнять полную сборку решения на базе KasperskyOS после внесения изменений в код прикладной программы, а вместо этого использовать следующий сценарий:
CMake
-команды библиотеки kpa.Создание базового описания политики безопасности решения
Расширение позволяет автоматически создавать простейшие описания политики безопасности решения для проекта.
Чтобы создать базовое описание политики безопасности:
KOS: Generate policy file for current project
.Grant all permissions
- создать простейшее описание политики безопасности решения, которая разрешает любые взаимодействия процессов любых классов между собой и с ядром KasperskyOS, а также разрешает любому процессу инициализировать запуск процессов.Grant necessary permissions
- создать простейшее описание политики безопасности решения, которая разрешает любые взаимодействия процессов любых классов между собой и с ядром KasperskyOS, а также определяет необходимые разрешения для инициализации запуска процессов на основе файла init.yaml.in в составе проекта.Эти политики можно использовать только в качестве заглушек на ранних стадиях разработки решения на базе KasperskyOS, чтобы модуль безопасности Kaspersky Security Module "не мешал" взаимодействиям. В реальном решении на базе KasperskyOS применять такие политики недопустимо.
Запуск тестов
После активации расширения на боковой панели Visual Studio Code появляется вкладка Testing – . При выборе вкладки Testing в окне редактора кода отобразится дерево тестов, созданных с помощью библиотеки Google Test и обнаруженных в файлах директории
test/
.
Для запуска тестов нажмите на кнопку . По умолчанию запускаются все обнаруженные тесты, но вы можете выбирать определенные тесты на вкладках с исходным кодом тестов или определенные группы тестов, выбирая их из дерева всех тестов. Запускать можно только тесты, которые добавлены в файлы
CMakeLists.txt
для сборки программ с помощью CMake
-команд kl_kos_add_small_test()
или generate_kos_test()
из CMake
-библиотеки TestGenerator, поставляемой в составе SDK.
Результаты работы тестов, а также файлы журналов находятся в директории <директория_сборки>/bin/tests/output
.
Запуск тестов политик безопасности решения
Расширение позволяет запускать тесты политики безопасности решения для проекта, созданные на основе описания политики безопасности решения.
Чтобы собрать и выполнить тесты политики безопасности решения:
CMake
-команды сборки тестов политики безопасности решения добавлены в один из файлов CMakeLists.txt
проекта.kos-qemu-image-PalTest<N>-sim
, где N – индекс PSL-файла в списке PSL-файлов, содержащих тесты политики безопасности решения.