Aqua Help

Start the debugger session

Starting a debugger session is very similar to running the program in normal mode. The debugger is attached behind the scenes, so you don't have to configure anything specific to start a debugger session. If you are able to run your program from Aqua, you will also be able to debug it using the same configuration.

Each time you debug a program, the debugger session is based on a run/debug configuration. Thus, you can configure Aqua to use any parameters and perform any actions before the program is launched. For example, the configuration can build the application every time you start a debugger session or use the previously compiled code. You can also use any VM options, custom classpath values and so on (as long as the selected run/debug configuration supports this).

  • If you don't have a run/debug configuration, and your program doesn't require you to have one, click the Run Run icon icon in the gutter near the class with the main() method and select Debug. This will create a temporary run/debug configuration for you. After that, you can customize and save this temporary configuration if needed. This is the quickest way to debug your program from an entry point that has not been defined yet.

    A menu appears on clicking the run button in the gutter
  • If you already have a run/debug configuration, and it is currently selected in the run/debug configurations list, press Shift+F9.

    The list of run/debug configurations on the toolbar
  • If you already have a run/debug configuration, and it is not selected, or you want to adjust some configuration before debugging, press Alt+Shift+F9. After that, select the desired configuration or proceed with Edit Configurations.

    Debug menu lets you select a configuration to debug or edit configurations

Pause/Resume a debugger session

When the debugger session is running, you can pause/resume it as required using the buttons on the toolbar of the Debug tool window:

  • To pause a debugger session, click the Pause button.

  • To resume a debugger session, click the Resume button F9.

Restart a debugger session

  • Click the The Rerun button Rerun button in the Debug tool window or press Ctrl+F5.

    The Rerun button

Terminate a debugger session

  • Click the The Stop button Stop button in the Debug tool window.

    Alternatively, press Ctrl+F2 and select the process to terminate (if there are two or more of them).

    the Rerun button
Last modified: 07 March 2024