Extensión de VS Code

La extensión de Elide convierte cualquier carpeta con un elide.pkl en un proyecto de VS Code: sincroniza las dependencias y los conjuntos de fuentes con el servidor de lenguaje de Kotlin, y ejecuta, prueba y depura mediante la CLI elide.

Requisitos

La extensión requiere un espacio de trabajo de confianza: una sincronización ejecuta la CLI elide del espacio de trabajo.

Instalar

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

Help → Get Started → Get started with Elide recorre la instalación, el proyecto, la sincronización, la ejecución y las pruebas.

Sincronizar un proyecto

Al abrir una carpeta con elide.pkl, esta se sincroniza: Elide resuelve el manifiesto, instala las dependencias cuando el archivo de bloqueo está desactualizado y escribe workspace.json para el servidor de lenguaje de Kotlin. Añada workspace.json a .gitignore.

Haga clic en el elemento de la barra de estado para abrir el menú de Elide: sincronizar, ejecutar un comando, ejecutar todas las pruebas, abrir elide.pkl o la salida. Cuando elide.pkl cambia, la extensión pide recargar (elide.sync.onManifestChange).

La barra lateral de Elide

La vista Elide de la barra de actividad muestra cada proyecto:

Inteligencia de código

El autocompletado, la navegación y los diagnósticos de Kotlin y Java vienen del servidor de lenguaje de Kotlin, que importa el workspace.json sincronizado: un módulo por conjunto de fuentes, cada biblioteca con sus fuentes, el JDK y las opciones de Kotlin del manifiesto.

• Se instalan los JAR de fuentes de los paquetes Maven declarados, así que Go to Definition abre el código de la biblioteca (elide.install.classifiers).
• El JDK se toma de elide.jdk.home, después de jvm.javaHome, $JAVA_HOME o un JDK instalado que coincida con jvm.target.
• Un repositorio puede conservar un directorio .idea de IntelliJ: la extensión define intellij.buildTool como json en los ajustes del espacio de trabajo, de modo que cada editor lee su propio modelo.

Ejecutar

Los code lens ejecutan lo que declara el proyecto:

Las ejecuciones son tareas de VS Code de tipo elide; los errores del compilador aparecen en Problems en el archivo y la línea indicados.

En .vscode/tasks.json:

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

Probar

Las pruebas JUnit de los conjuntos de fuentes de prueba aparecen en la vista Testing, con iconos en el margen de cada clase y método. Una ejecución llama a elide test --reporter=tap para la selección e informa de cada prueba al terminar; un fallo muestra su mensaje de aserción y enlaza a la línea que falla.

El perfil Debug ejecuta las mismas pruebas con el depurador.

Run with Coverage ejecuta la selección con --coverage y muestra el resultado en el margen del editor y en la vista Test Coverage: JavaScript y TypeScript a partir de LCOV, Java y Kotlin a partir de un informe XML de JaCoCo. Solicite el informe XML en elide.pkl:

import "elide:Coverage.pkl" as Coverage

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

Depurar

Debug with Elide inicia elide run --debugger y se conecta a él. Los puntos de interrupción en fuentes Kotlin y Java detienen el programa; al terminar la sesión se detiene Elide.

En .vscode/launch.json:

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

elide.debug.adapter elige el depurador: intellij (predeterminado, de la extensión de Kotlin) o java (Debugger for Java). El depurador escucha en el puerto 5005, así que solo se ejecuta una sesión a la vez. Para depurar JavaScript, TypeScript y Python con CDP y DAP, consulte Depuración.

Native Image

El tipo de inicio elide-native compila un artefacto de Native Image y depura el binario con GDB, mediante la extensión C/C++ (ms-vscode.cpptools):

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

Añada -g a options.flags del artefacto en elide.pkl para usar puntos de interrupción a nivel de código fuente; la información de depuración solo se genera en Linux. program depura un binario existente y build: false omite la compilación.

Espacios de trabajo

Un manifiesto con workspace.members se sincroniza como una sola compilación. Cada miembro es un proyecto en la barra lateral, la vista Testing, las tareas y las configuraciones de inicio, y la inteligencia de código sigue las dependencias project("name") entre miembros sin compilar. Al abrir el directorio de un miembro, la extensión ofrece abrir la raíz del espacio de trabajo. Consulte Espacios de trabajo.

Ajustes