Расширение VS Code

Расширение Elide превращает любую папку с elide.pkl в проект VS Code: оно синхронизирует зависимости и наборы исходников с языковым сервером Kotlin, а запуск, тестирование и отладку выполняет через CLI elide.

Требования

Расширению нужно доверенное рабочее пространство: синхронизация запускает CLI elide из рабочего пространства.

Установка

curl -LOJ "https://plugins.elide.dev/vscode/files?id=elide.elide"
code --install-extension elide-*.vsix

Help → Get Started → Get started with Elide проводит через установку, проект, синхронизацию, запуск и тесты.

Синхронизация проекта

Папка с elide.pkl синхронизируется при открытии: Elide разрешает манифест, устанавливает зависимости, если lock-файл устарел, и записывает workspace.json для языкового сервера Kotlin. Добавьте workspace.json в .gitignore.

Щелчок по элементу в строке состояния открывает меню Elide: синхронизировать, выполнить команду, запустить все тесты, открыть elide.pkl или вывод. Когда elide.pkl меняется, расширение предлагает перезагрузить проект (elide.sync.onManifestChange).

Боковая панель Elide

Представление Elide на панели действий показывает каждый проект:

Интеллектуальная поддержка кода

Автодополнение, навигацию и диагностику для Kotlin и Java обеспечивает языковой сервер Kotlin, который импортирует синхронизированный workspace.json: по модулю на набор исходников, каждую библиотеку с исходниками, JDK и параметры Kotlin из манифеста.

• Для объявленных пакетов Maven устанавливаются jar-файлы с исходниками, поэтому Go to Definition открывает код библиотеки (elide.install.classifiers).
• JDK берётся из elide.jdk.home, затем из jvm.javaHome, $JAVA_HOME или установленного JDK, подходящего под jvm.target.
• В рабочей копии может оставаться каталог .idea от IntelliJ: расширение задаёт intellij.buildTool значение json в настройках рабочего пространства, и каждый редактор читает свою модель.

Запуск

Code lens запускают то, что объявляет проект:

Запуски — это задачи VS Code типа elide; ошибки компилятора попадают в Problems с указанием файла и строки.

В .vscode/tasks.json:

{ "type": "elide", "command": "test", "args": ["src/api"], "options": { "bail": 3 } }

Тестирование

Тесты JUnit из тестовых наборов исходников появляются в представлении Testing со значками на полях у каждого класса и метода. Запуск вызывает elide test --reporter=tap для выбранных тестов и сообщает о каждом тесте по мере завершения; у упавшего теста показываются сообщение проверки и ссылка на строку с ошибкой.

Профиль Debug запускает те же тесты под отладчиком.

Run with Coverage запускает выбранное с --coverage и показывает результат на полях редактора и в представлении Test Coverage: JavaScript и TypeScript — из LCOV, Java и Kotlin — из XML-отчёта JaCoCo. Включите XML-отчёт в elide.pkl:

import "elide:Coverage.pkl" as Coverage

coverage {
  jvm {
    reports { Coverage.xmlReport() }
  }
}

Отладка

Debug with Elide запускает elide run --debugger и подключается к нему. Точки останова в исходниках Kotlin и Java останавливают программу; завершение сеанса останавливает Elide.

В .vscode/launch.json:

{
  "type": "elide",
  "request": "launch",
  "name": "Elide: Run (debug)",
  "entrypoint": "src/main/kotlin/shop/Main.kt"
}

elide.debug.adapter выбирает отладчик: intellij (по умолчанию, из расширения Kotlin) или java (Debugger for Java). Отладчик слушает порт 5005, поэтому одновременно работает только один сеанс. Об отладке JavaScript, TypeScript и Python через CDP и DAP см. Отладка.

Native Image

Тип запуска elide-native собирает артефакт Native Image и отлаживает бинарный файл в GDB через расширение C/C++ (ms-vscode.cpptools):

{ "type": "elide-native", "request": "launch", "name": "Elide: Debug Native Image", "artifact": "bin" }

Для точек останова на уровне исходного кода добавьте -g в options.flags артефакта в elide.pkl; отладочная информация создаётся только в Linux. program отлаживает существующий бинарный файл, build: false пропускает сборку.

Рабочие пространства

Манифест с workspace.members синхронизируется как одна сборка. Каждый участник — отдельный проект в боковой панели, представлении Testing, задачах и конфигурациях запуска, а интеллектуальная поддержка кода следует зависимостям project("name") между участниками без сборки. При открытии каталога участника расширение предлагает открыть корень рабочего пространства. См. Рабочие пространства.

Настройки