Функции расширения

Расширение автоматически обнаруживает в открытом рабочем пространстве проект KasperskyOS и запускается. Параметр обнаружения – наличие в рабочем пространстве файла .vscode/kos_project.json или директории einit. Если расширение автоматически не активировалось в директории, но вы уверены, что это проект KasperskyOS, то выполните команду KOS: Activate extension in this directory. Команда активирует расширение и создает в директории проекта пустой файл .vscode/kos_project.json. Чтобы отменить ручную активацию, удалите этот файл.

После запуска расширение добавляет на нижнюю панель редактора кода Visual Studio Code кнопки, перечисленные в статье "Кнопки в нижней панели".

Функции, которые предоставляют кнопки, также можно вызвать из командной строки редактора кода, открываемой по нажатию на клавишу F1. Все команды имеют префикс KOS:.

Работа с базовым образом KasperskyOS

Расширение позволяет не выполнять полную сборку решения на базе KasperskyOS после внесения изменений в код прикладной программы, а вместо этого использовать следующий сценарий:

1. Запуск в эмуляторе QEMU базового образа решения на базе KasperskyOS, входящего в состав SDK. В базовом образе содержатся все системные программы, необходимые для запуска и отладки программ, упакованных в KPA-пакеты.
2. Сборка прикладной программы и ее упаковка в KPA-пакет. Для того чтобы упаковать прикладную программу в KPA-пакет, необходимо использовать CMake-команды библиотеки kpa.
3. Установка программы из KPA-пакета в запущенный на шаге 1 образ решения и ее запуск под управлением KasperskyOS.
4. Внесение изменений в код прикладной программы.
5. Повторение шагов 2-4.
6. Расширение также позволяет отлаживать программу, запущенную в базовом образе KasperskyOS. Подробнее см. "Отладка программ в составе KPA-пакета".

Работа с описанием политики безопасности решения

Расширение позволяет:

• использовать подсветку синтаксиса языка PSL;
• диагностировать ошибки при написании политики безопасности решения;
• использовать автодополнение имен и навигацию по коду ("Go to Definition") при создании PSL-файлов.

Функциональность для работы с языком PSL не поддерживается если в PSL-файле используется шаблонизация Ginger.

Запуск тестов политик безопасности решения

Расширение позволяет запускать тесты политики безопасности решения для проекта, созданные на основе описания политики безопасности решения.

Чтобы собрать и выполнить тесты политики безопасности решения:

1. Убедитесь, что описание политики безопасности решения содержит тесты политики безопасности решения.
2. Убедитесь, что CMake-команды сборки тестов политики безопасности решения добавлены в один из файлов CMakeLists.txt проекта.
3. Убедитесь, что расширение KasperskyOS SDK Extension установлено и активно.
4. Выполните сборку всех целей, нажав на кнопку на нижней панели.
5. Нажмите на кнопку выбора цели сборки и выберите цель с именем kos-qemu-image-PalTest<N>-sim, где N – индекс PSL-файла в списке PSL-файлов, содержащих тесты политики безопасности решения.
6. Нажмите на кнопку запуска выбранной цели на нижней панели .

Тесты политик безопасности решения рекомендуется либо писать в отдельном проекте, либо убрать из решения CMake-команды для создания образа так как в коде создания тестов уже есть код отвечающий за создание образа. Подробнее см. пример pal_tests в составе SDK.