1Cpt:Enterprise Debug Adapter

Адаптер отладки 1С:Предприятие (DAP) для HTTP‑сервера отладки 1С.

Этот репозиторий — форк проекта akpaevj/onec-debug-adapter с доработками и упрощением под сценарий использования в расширении VS Code yellow-hammer/vscode-1c-platform-tools. Часть функциональности исходного проекта удалена, конфигурация адаптера и процесс релизов адаптированы под это расширение.

Назначение

• Реализация протокола Debug Adapter Protocol (DAP) для HTTP‑сервера отладки 1С.
• Отладка исходников конфигураций (формат конфигуратора) и расширений.
• Основной потребитель — расширение VS Code 1C: Platform tools; как отдельный DAP может использоваться продвинутыми пользователями при желании.

Требования

• Установленный .NET 8 Runtime.

Сборка и запуск локально

dotnet publish onec-debug-adapter.csproj -c Release -o out/onec-debug-adapter

В результате в out/onec-debug-adapter будут лежать:

• OnecDebugAdapter.dll
• сопутствующие библиотеки.

Запуск DAP‑процесса вручную (пример):

dotnet OnecDebugAdapter.dll

Обычно запуск и параметры адаптера (аргументы, рабочий каталог) полностью контролируются клиентом (например, VS Code через расширение vscode-1c-platform-tools).

Параметры конфигурации (DAP launch/attach)

Основные параметры, которые передаёт клиент адаптеру (через DAP‑запросы, а не как аргументы командной строки):

• rootProject — путь к выгруженной конфигурации (каталог с исходниками конфигуратора).
• platformPath — путь к каталогу с установленными версиями платформы 1С.
• platformVersion — версия платформы.
• debugServerHost / debugServerPort — адрес HTTP‑сервера отладки 1С.
• extensions — массив путей к выгрузкам расширений конфигурации.
• autoAttachTypes — список типов подключаемых клиентов (Client, ManagedClient, Server и т.п.).

Конкретные примеры конфигурации и сценарии запуска см. в README расширения vscode-1c-platform-tools.

Релизы

Релизы адаптера публикуются в GitHub Releases этого репозитория.
Тег вида vX.Y.Z:

1. Запускает GitHub Actions workflow сборки (dotnet publish -c Release -o out/onec-debug-adapter).
2. Упаковывает каталoг out/onec-debug-adapter в архив onec-debug-adapter-vX.Y.Z.zip.
3. Прикрепляет архив к релизу с тем же тегом.

Расширение vscode-1c-platform-tools при сборке (npm run build:onec-adapter) загружает соответствующий архив релиза и раскладывает его в bin/onec-debug-adapter/ внутри VSIX.