Aqua 2024.2 Help

Build tool window

The Build tool window helps you view the output of your builds that were done by Aqua, delegated to Maven or Gradle, and the results of the project synchronization.

The tool window becomes available after you build your code.

Build Output tab

Aqua displays the result of your build in the Build Output tab. Depending on a project, the build output shows tasks, goals, and commands that were executed and error messages that were produced.

By default, the tab also displays all successful steps and warnings.

Build a project

  1. In the main menu, go to Build | Build Project or press Ctrl+F9.

  2. Check the results in the Build tool window.

    If the tool window does not open automatically, go to View | Tool Windows | Build in the main menu.

    IntelliJ IDEA build output
    Gradle build output
    Maven build output

Sync tab

When you open a Gradle or Maven project, the sync is done automatically.

If you need, you can manually trigger the synchronization of your project.

Reimport a project

  1. Open a Gradle or Maven tool window.

  2. Right-click a project you want to sync, and from the context menu, select Reload project for Maven or Reload Gradle Project for Gradle.

  3. Check the results in the Build tool window.

    the Build tool window: Sync tab
    the Build tool window: Sync tab

For more information, refer to Maven and Gradle section.

Error handling

When an error occurs during the build process, Aqua displays an error message with the line and column number that could be easily located. If Aqua can locate the error place, it displays a link that you can click and navigate to the necessary line in the editor.

Build tool window: error navigation
Build tool window: error navigation
Build tool window: error navigation

When the Build tool window displays multi errors or warnings, it enables you to navigate between the next or the previous problem from the context menu or using the Ctrl+Alt+Down and Ctrl+Alt+Up shortcuts.

If the error occurs during the synchronization process, Aqua displays an error message. Aqua also displays the issue description in the text console and offers a solution if possible.

Build tool window: error message
Build tool window: Error message

Context menu

Several options such as Rerun and Stop are the same as in the side toolbar, the rest of the options are described in the following table:

Item

Shortcut

Description

Jump to Source

F4

Open the corresponding location in the editor.

Show Warnings

Select this option for Aqua to display warnings.

Show Successful Steps

Select this option for Aqua to display all the steps of the build process.

Exclude from Compile

Exclude the relevant file from compilation.

Exclude from Validation

Exclude the relevant file from validation.

Previous Problem

Ctrl+Alt+Up

Navigate to the previous problem.

Next Problem

Ctrl+Alt+Down

Navigate to the next problem.

For the options in the context menu of the messages displayed in the right part of the output, use the following table:

Item

Description

Compare with Clipboard

Compare the output in a built-in Diff Viewer.

Fold Lines Like This

You can fold a line that is too long.

Pause Output

Pause the compilation process.

Clear All

Delete the output messages.

Side Toolbar buttons

Icon

Tooltip

Description

Stop

Stop

Stop the building process.

Terminate compilation. This button is enabled when compilation is in progress.

the Compiler properties

Compiler Properties

Configure the compiler settings.

the Pin icon

Pin Tab

Pin the tab with which you are working. The next time you build your code, the results will be displayed in a new tab.

Filters

Filters

Filter the output displaying or hiding warnings and successful steps.

Soft wraps

Soft-Wrap

Creates soft wraps in the message text.

Scroll to the end

Scroll to End

Scrolls to the end of displayed messages.

Upper Toolbar buttons

Icon

Tooltip

Description

Show Options Menu

Show Options Menu

Click this icon to open a menu with more options for managing the tool window such as displaying or hiding side toolbars, group tabs, selecting viewing mode, resizing, and so on.

Hide

Hide

Hides the tool window. To open it up again, go to View | Tool Windows | Build in the main menu.

Last modified: 08 October 2024