4D-Debugger-VSCode
This extension developed by 4D provides a debugger for the 4D language.
Quick start
- Install the 4D Debugger extension in VS Code.
- Declare your default 4D Server path in the Settings.
- Open a 4D project folder and run a 4D method (.4dm) file.
- Start debugging.
All 4D blog posts about this extension are available here.
Requirements
- The 4D Debugger extension can only be used with 4D Server 20 R8 or higher.
- The VS Code with 4D Debugger extension and 4D Server must be on the same machine.
- No other debugger must be attached to 4D Server.
Configuration
The following properties can be set in the launch.json file for each project.
"attach" and "attach and run" properties
To execute some code on the currently launched 4D Server.
Required properties
| Property |
Type |
Description |
Default |
| type |
text |
always "4d" |
"4d" |
| request |
text |
always "attach" |
"attach" |
| name |
text |
can be "Attach" or "Attach and Run" |
|
| port |
number |
Port to connect to the 4D server |
19815 |
Optional properties
| Property |
Type |
Description |
Default |
| program |
text |
The 4D Method To launch |
"${file}" |
"launch" and "launch and run" properties
To launch the referenced 4D Server application before executing some code.
Required properties
| Property |
Type |
Description |
Default |
| type |
text |
always "4d" |
"4d" |
| request |
text |
always "launch" |
"launch" |
| name |
text |
can be "Launch" or "Launch and Run" |
|
| project |
text |
Absolute path to a 4D Project |
"${workspaceFolder}/Project/${workspaceFolderBasename}.4DProject" |
Note: {workspaceFolder} and {workspaceFolderBasename} are automatically filled when a project is already opened.
Optional properties
| Property |
Type |
Description |
Default |
| program |
text |
The 4D Method To launch |
"${file}" |
| execArgs |
array |
Collection of arguments to the 4D Debugger |
[] |
| exec |
text |
Absolute path to a 4D Server. Overrides the default path set in the Settings |
"" |
| port |
number |
Port to connect to the 4D server |
19815 |
About Port number
The port number of the remote debugger cannot be modified directly; it is however the Application Server port+2. See 4D Server and port numbers.
Links
See the VS Code debugger documentation
| |
