Отладка

Для отладки применяется стандартный отладчик OneScript для Visual Studio Code.

Подготовка

Если у вас уже установлены VS Code, плагин языка 1С и отладчик OneScript, пропустите раздел "Подготовка".

Установка Visual Studio Code и плагинов

Скачайте среду разработки с сайта производителя и установите. Затем, запустите и нажмите в ней Ctrl+Shift+X чтобы перейти к окну установки расширений.

Вам потребуется установить 2 расширения: поддержку языка 1С и отладчик OneScript. В окне поиска наберите bsl и установите расширения, показанные на картинке.

Создание папки с решением

Для начала нам понадобится место, где мы будем писать наш проект. Ознакомьтесь с разделом Новый проект, чтобы его подготовить.

Конфигурация запуска

Для отладки нам потребуется конфигурация запуска. Конфигураций запуска может быть несколько, вы сами создаете варианты запуска с разными параметрами командной строки, с разными переменными окружения и т.п.

Запустите отладку и выберите пункт Отладка 1Script. IDE создаст файл .vscode/launch.json и откроет его в редакторе. Если что-то не сработает (а такое бывает), создайте в корне вашего проекта каталог .vscode (обратите внимание на точку в имени) и в нем файл launch.json, откройте его.

В файле launch.json можно задать несколько так называемых "профилей" отладки - наборов комбинаций параметров, под которым будет запускаться отлаживаемое приложение.

Каждый профиль отладки представляет собой настройку запуска отлаживаемого приложения, его аргументы командной строки и версию интерпретатора 1script, которая будет выполнять приложение.

Подробное описание каждого параметра выводится при наведении мышки на опцию в файле launch.json.

{
    "name": "Отладка 1Script",
    "type": "oscript",
    "request": "launch",
    "cwd": "${workspaceRoot}/src",
    "program": "my-program.os",
    "args": ["arg1", "arg2"],
    "env": {
        "OSCRIPT_CONFIG": "lib.system=D:/myOsLibraries",
        "JAVA_HOME": "D:/MyJava/JDK_29_Full"
    },
    "debugPort": 2801
}

ВНИМАНИЕ

Если по какой-либо причине на вашей машине занят порт 2801 - укажите в свойстве debugPort любой другой свободный порт.

Старт отладки

После того, как конфигурация запуска выбрана в окне VS Code можно нажать кнопку F5 и среда разработки запустит отладку, согласно настроенной конфигурации.

Если взять пример конфига, приведенный выше, то будет запущен для отладки файл my-program-os, рабочим каталогом запущенного процесса будет каталог ${workspaceRoot}/src, где ${workspaceRoot} это корень папки с проектом.

Далее, в запущенный процесс будут переданы 2 аргумента командной строки: "arg1" и "arg2", при этом процесс получит две переменные окружения OSCRIPT_CONFIG и JAVA_HOME.

Создавая таким образом разные варианты запуска, вы можете отлаживать различные сценарии вашей программы.