IntelliJ IDEA 2024.3 Help

Gradle tool window

The Gradle tool window is enabled automatically when you create or open your Gradle project. Click Gradle on the right sidebar to open the tool window. The tool window displays the Gradle linked projects, their tasks, dependencies, and all changes made to the underlying build.gradle file.

the Gradle tool window

Gradle

Item

Shortcut

Description

Show option menu

Click this button to open the menu for configuring the current view and changing the tool window viewing modes. The menu items are options that you can turn on or off. An active item contains a check mark on the left side of its name.

The available options in the menu are as follows:

  • Group Modules: select this option if you want to group modules in the project.

  • Group Tasks: select this option if you want to group your tasks. For example, build tasks will be included in the build directory.

  • Show Ignored: select this option to display the ignored projects.

  • Show Toolbar: select this option to show the toolbar for your Gradle projects.

  • View Mode: Dock Pinned, Dock Unpinned, Undock, Float, Window – these options let you control the general appearance and behavior of the tool window.

  • Group Tabs: deselect this option to see the views on separate tabs if more than one view is available in a tool window.

  • Move to: select this option to move the Gradle tool window to either top, left or right.

  • Resize: select this option to resize the Gradle tool window.

Hide tool window

Shift+Escape

Hide the tool window Shift+Escape.

To hide all the tool windows, press Ctrl+Shift+F12.

Gradle Tasks

Item

Description

Run Configurations

This area contains a list of the last executed tasks and command types under which these tasks were executed.

Tasks

This area contains a list of all available tasks.

Dependencies

This area contains a list of project dependencies.

Toolbar

Item

Description

Re-import All Gradle Projects

Click this button to re-import all registered Gradle projects after changes have been made to a Gradle script.

Link Gradle Project

Click this button to link a Gradle project.

Unlink Gradle Projet

Click this button to detach an external Gradle project.

Download Sources

Click this button to manually download sources for the project dependencies that were not downloaded on the initial project sync. If you want to always download these sources for the project, use the Download sources option in Build Tools. Gradle.

Run Gradle Task

Use this button to execute a Gradle task. When you click this icon, the Run Anything window opens. Enter a name of the task that you want to execute. To execute several tasks, enter task names using space to separate each new task.

Expand All Collapse All

Use these buttons to expand or collapse all the nodes.

Select Project Data to Import

Click this button to import a module or data to your Gradle project via Project Data to Import dialog. It might be useful for the multi-module projects.

Toggle Offline Mode

Click this button to work with Gradle projects in the offline mode. In this case, Gradle will use dependencies from the cache. Gradle will not attempt to access the network to perform dependency resolution. If the required dependencies are not present in the cache, build execution will fail. Also, if the offline mode is enabled, the opening and syncing of your project might fail.

Analyze Dependencies

Click this icon to open the Dependency analyzer window.

Show Diagram

Click this icon to generate the Gradle dependencies.

Build Tools Settings

Use this icon to access the following settings:

  • Auto-Reload Setting: select this option to configure the reloading process of your Gradle project in the Build Tools settings dialog.

  • Gradle Settings: select this option to configure the settings of the current Gradle project in the Gradle settings dialog.

Gradle Project Data To Import dialog

This dialog appears when you click Select Project Data to Import on the toolbar in the Gradle tool window. Use this dialog to add an external module to a project. It might be helpful for multi-module projects.

Item

Description

Please select the modules/data to include in the project

Use this area to view the list of available external modules or data for your current project.

Select All

Select all the modules from the list.

Unselect All

Clear the list of selected modules.

Show Selected Only

See only the selected modules.

Select Required Select Required

If you click this icon, IntelliJ IDEA selects the appropriate modules in case you are unsure about dependencies between the modules.

Context Menu

Item

Description

Open Gradle Config

Select this option or use a shortcut to open build.gradle file.

Re-import Gradle Project

Select this option to re-import the project.

Unlink Gradle Project

Select this option to detach an external project.

Ignore Gradle project

Select this option to ignore/unignore the selected project.

Refresh Gradle dependencies

Select this option to refresh dependencies for the project.

Show Dependencies / Show Dependencies popup

Use these options to generate the Gradle dependencies diagram.

Tasks Activation

Select this option to add, edit or remove an activation phase for your task. It might be useful for working with the Gradle multi-module projects.

Context Menu Commands for Gradle Tasks

Command

Description

Run <task>

Choose this command to run the selected task with the task-specific run/debug configuration.

Debug <task>

Choose this command to debug the selected task with the task-specific run/debug configuration.

Create <task>

Choose this command to create run/debug configuration for the selected Gradle task.

Select <task>

Choose this command to activate the configuration for the selected Gradle task. If there is no existing configuration for the selected task, this option is disabled and replaced with the Create option.

Execute before Sync, Execute after Sync

Choose these commands to set the respective flags for the selected task. In this case, Before Sync and After Sync comments appear next to the name of the node.

Execute before Build, Execute after Build

Choose these commands to set the respective flags for the selected task. In this case, Before Build and After Build comments appear next to the name of the node.

Execute before Rebuild, Execute after Rebuild

Choose these commands to set the respective flags for the selected task. In this case, Before Rebuild and After Rebuild comments appear next to the name of the node.

Assign Shortcut

Choose this command to associate the selected phase with a keyboard shortcut. In this case, the comment with the shortcut appears next to the name of the node.

Last modified: 28 June 2024