Розширення 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") між учасниками без збирання. Під час відкриття каталогу учасника розширення пропонує відкрити корінь робочого простору. Див. Робочі простори.

Налаштування