mirror of
https://github.com/enso-org/enso.git
synced 2024-12-24 16:21:37 +03:00
32 lines
1.3 KiB
Markdown
32 lines
1.3 KiB
Markdown
|
# Debug Adapter Protocol
|
||
|
|
|
||
|
|
[Debug Adapter Protocol](https://www.graalvm.org/latest/tools/dap/) is yet
|
||
|
|
another instrument available for a Truffle language. The DAP is a native
|
||
|
|
protocol for VSCode and as such, works only via VSCode. To start Enso with DAP
|
||
|
|
server waiting for a client to attach, launch enso via:
|
||
|
|
|
||
|
|
```
|
||
|
|
env JAVA_OPTS='-Dpolyglot.dap' ./built-distribution/enso-engine-*/enso-*/bin/enso --run *.enso
|
||
|
|
```
|
||
|
|
|
||
|
|
Once DAP server is started and ready for a client to be attached, the following
|
||
|
|
output will be printed:
|
||
|
|
|
||
|
|
```
|
||
|
|
[Graal DAP] Starting server and listening on /127.0.0.1:4711
|
||
|
|
```
|
||
|
|
|
||
|
|
There is a
|
||
|
|
[Launch configuration](https://code.visualstudio.com/docs/editor/debugging#_launch-configurations)
|
||
|
|
in the repository in
|
||
|
|
[.vscode/launch.json](https://github.com/enso-org/enso/blob/a123cd0d9f4b04d05aae7a5231efba554062188f/.vscode/launch.json#L13-L16)
|
||
|
|
with name `Debug Adapter Protocol`, you can start debugging via
|
||
|
|
[Run and Debug view](https://code.visualstudio.com/docs/editor/debugging#_run-and-debug-view)
|
||
|
|
by selecting the `Debug adapter protocol` configuration and pressing play:
|
||
|
|
|
||
|
|
|
||
|
|
Another screenshot showing the DAP in action:
|
||
|
|
|
||
|
|
|
||
|
|
Note that the port 4711 is the default port for DAP.
|