Orion/Documentation/Developer Guide/Debugger

Development Setup

The code is in master!!

Instructions to follow!

• Go to ORION_PATH/modules/orionode and run npm install
• (optional) Configure debug adapters

1. By default, node, python, java and lldb adapters are configured
2. If you don't need more or less adapters, you can skip this part
3. Open ORION_PATH/modules/orionode.debug.server/adapters.json
4. Add new adapters in this json file. You can find available adapters and their git repositories in VSCode marketplace by searching "debugger"

• Enable debug server

1. Go to ORION_PATH/modules/orionode.debug.server
2. Run npm install

• Run Orion node server

1. Edit ORION_PATH/modules/orionode/orion.conf
2. Set orion.debug.enabled to true
3. Set debug.server.module to ../orionode.debug.server (by default it's there already)
4. Edit ORION_PATH/bundles/org.eclipse.orion.client.ui/web/defaults.pref
5. Add "/general/settings":{"generalSettings": {"enableDebuggerVisible": true}}
6. Go to ORION_PATH/modules/orionode
7. Run npm install
8. Run node server.js

• Enable debug frontend

1. Open http://localhost:8081 (or other port you are listening to)
2. Go to settings page by clicking the gear button on the left
3. Go to general settings
4. Enable debugger

• Create a sample program

1. Open http://localhost:8081 (or other port you are listening to)
2. Create a new folder at the root of your workspace
3. Create a new file called server.js in this new folder
4. Type in console.log('Hello World!');
5. Click the run bar at the top, and click "+Native"
6. Change "Debug Adapter Type" to "node"
7. Click "Select a Template" and select "Default"
8. Press "Save"
9. Click the play button in the run bar
10. Now you can see the debug UI and the output from the hello world program

• More tips

1. Double click a line number to add or remove a breakpoint
2. Hold alt and double click a line number to add or remove a conditional breakpoint, although some debug adapters don't support conditional breakpoints
3. Third-party adapters might not work as good as adapters like node