5.2 KiB
DAP layer
Description
Experimental integrated visual debugger using Debug Adapter Protocol.
Debug Adapter Protocol is a wire protocol for communication between client and Debug Server. It similar to the LSP but providers integration with debug server.
Features:
Fully featured IDE-like debugger providing:
- Launch/Attach
- Breakpoints
- Exceptions
- Pause & Continue
- Step In/Out/Over
- Callstacks
- Threads
- Multiple simultaneous debug sessions
- Evaluating statements
- Debug/Run configurations
- Debug REPL
Layer installation
To use this configuration layer, add it to your ~/.spacemacs. You will need to
add dap to the existing dotspacemacs-configuration-layers list in this
file.
Configuration
DAP configuration in supported layers
By default dap layer registers global key binding defined under SPC m. If you
want to have debug bindings under major mode leader you may do the following:
For instance the java layer:
(defun java/pre-init-dap-mode ()
(add-to-list 'spacemacs--dap-supported-modes 'java-mode))
See the java layer for further example on how to setup correctly dap-mode.
Variables
| Variable name | Default | Description |
|---|---|---|
dap-enable-mouse-support |
t | Enable/disable mouse support |
Key bindings
Declared prefixes
The following prefixes have been declared:
| prefix | name |
|---|---|
SPC d |
debug |
SPC d b |
breakpoints |
SPC d d |
launching |
SPC d e |
eval |
SPC d I |
inspect |
SPC d l |
debug windows |
SPC d S |
context switching |
SPC d T |
toggles |
Transient state
Most of the DAP functions can be easily repeated using the built-in DAP
transient state which can be initiate with SPC m d ..
| Key binding | Description |
|---|---|
SPC m d . |
debug transient state |
Start/Stop
| Key binding | Description |
|---|---|
SPC d A |
abandon all process |
SPC d a |
abandon current session |
SPC d d d |
start debugging |
SPC d d e |
edit debug template |
SPC d d l |
debug last configuration |
SPC d d r |
debug recent configuration |
Breakpoints
| Key binding | Description |
|---|---|
SPC d b b |
toggle a breakpoint |
SPC d b c |
change breakpoint condition |
SPC d b l |
change breakpoint log condition |
SPC d b h |
change breakpoint hit count |
SPC d b a |
add a breakpoint |
SPC d b d |
delete a breakpoint |
SPC d b D |
clear all breakpoints |
SPC d w b |
list breakpoints |
Navigation
| Key binding | Description |
|---|---|
SPC d c |
continue |
SPC d i |
step in |
SPC d o |
step out |
SPC d s |
next step |
SPC d r |
restart frame |
SPC d S f |
switch frame |
SPC d S s |
switch session |
SPC d S t |
switch thread |
SPC d w o |
goto output buffer if present |
SPC d w s |
list sessions |
Evaluation and REPL
| Key binding | Description |
|---|---|
SPC d '_ |
Run debug REPL |
SPC d e e |
eval |
SPC d e r |
eval region |
SPC d e t |
eval value at point |
Inspection
| Key binding | Description |
|---|---|
SPC d I i |
inspect |
SPC d I r |
inspect region |
SPC d I t |
inspect value at point |
SPC d v |
inspect value at point |
SPC d w l |
list local variables |
SPC d T m |
toggle mouse support for value inspection |