mirror of
https://github.com/enso-org/enso.git
synced 2024-12-24 05:12:31 +03:00
268e595ec1
Adds chrome-inspector tool and Debug Adapter protocol tool for debugging Enso. # Important Notes The chrome devtools seems to be broken (tracked in https://github.com/oracle/graal/issues/7636). Even `graalpy --inspect ...` fails (Chrome devtools freezes after connecting to the server). This PR adds Debug adapter protocol tool for debugging as a workaround for chrome inspector. There is docs in [dap.md](https://github.com/enso-org/enso/pull/8344/files#diff-421574b50574cfe546e86d4b3d32d79b8b2087f2fe204f68e5cf2693af43bbe1)
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.
|