Параметры и функции расширения

Параметры расширения

Расширение имеет параметры, располагающиеся в хранилище Visual Studio Code, вызываемом через меню: File → Preferences → Settings, далее Extensions → KasperskyOS. Параметры расширения:

• Add Paths

  Включение/выключение автоматического добавления путей для инструмента kosctl в значения переменных окружения.

• Auto_update

  Включение/выключение переустановки расширения при обнаружении новой установленной версии Kaspersky IoT Secure Gateway 1000 SDK.

• Build Threads Num

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

• Cmake Build Flags

  Дополнительные флаги CMake для сборки.

• Cmake Config Flags

  Дополнительные конфигурационные флаги для запуска CMake.

• Auto Open Log Tab

  Включение/выключение автоматического открытия вкладки с журналом выполнения команды.

• Features: Project

  Включение/выключение функций расширения для проектов Kaspersky IoT Secure Gateway 1000 SDK.

• Force Clean

  Кнопка очистки удаляет директорию сборки.

• Gdbinit File

  Путь к файлу gdbinit, который содержит GDB-команды, выполняемые при запуске отладчика.

• Kosctl Path

  Путь до директории с инструментом kosctl.

• Run No Graphic

  Включение/выключение принудительного запуска эмулятора в режиме без графического пользовательского интерфейса.

• SDK Path

  Путь до установленного Kaspersky IoT Secure Gateway 1000 SDK.

  Если расширение при запуске не обнаружит корректного SDK в SDK Path, будет выдан запрос с предложением выбрать SDK из списка обнаруженных. Чтобы не делать это для каждого рабочего пространства, рекомендуется установить SDK Path для пространства настроек User.

• Set Build Dir

  Директория сборки проекта. По умолчанию используется директория ./build.

• Shell Export Variables

  Дополнительные переменные, устанавливаемые перед запуском CMake.

• Test Files Pattern

  Маска для поиска файлов с исходным кодом тестов проекта.

• Test Threads Num

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

• Test Timeout

  Ограничение по времени на выполнение каждого теста (в секундах). При установке значения 0 используются ограничения из тестовых конфигураций.

• Trace: Server

  Выбор уровня детализации вывода журналов.

• User SDKs

  Дополнительные пути до SDK для отображения в меню выбора SDK.

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

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

После запуска расширение добавляет на нижнюю панель редактора кода Visual Studio Code следующие кнопки:

• – выбор цели сборки.
• – запуск проекта в QEMU. В текущей реализации расширения эта функция не поддерживается.
• – запуск выбранной цели с отладкой. В текущей реализации расширения эта функция не поддерживается. Вы можете настроить параметры отладки и запустить ее вручную с помощью текстовых команд расширения.
• – сборка всех целей.
• – сборка выбранной цели.
• – очистка директории сборки.
• – переключение типа сборки.
• – включение/отключение сборки проекта с тестами.
• – выбор целевой платформы для сборки.

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

Запуск тестов

После активации расширения на боковой панели Visual Studio Code появляется вкладка Testing – . При выборе вкладки Testing в окне редактора кода отобразится дерево тестов, обнаруженных в файлах директории test/.

Для запуска тестов нажмите на кнопку . По умолчанию запускаются все обнаруженные тесты, но вы можете выбирать определенные тесты на вкладках с исходным кодом тестов или определенные группы тестов, выбирая их из дерева всех тестов.

Результаты работы тестов, а также файлы журналов находятся в директории <директория_сборки>/bin/tests/output.

Тесты используют Visual Studio Code Testing API, поэтому возможно появление графических и текстовых артефактов в интерфейсе Visual Studio Code.