IntelliJ IDEA 2019.1 Help

Maven Projects Tool Window

View | Tool Windows | Maven Projects

This tool window is marked with the icon Maven logo.

Use the Maven Projects tool window to view the available Maven projects, download sources and Javadocs, and execute phases of the build lifecycle. The tool window displays nodes for each Maven project, with the Lifecycle and Plugins subnodes. If at least one of the pom.xml files contains profile definition, the Profiles node is added to the tool window. This node contains all profiles defined in the Maven projects. The Maven Projects tool window also displays the Dependencies node if dependencies are added to your project.

Toolbar Buttons

Item

Description

Reimport All Maven Projects

Click this button to synchronize all Maven projects with the IntelliJ IDEA project. See Importing tab of the Maven Integration dialog box.

Generate Sources and Update Folders for All Projects Click this button to launch Maven goals for generating sources and resources for the source and test directories, and read the resulting directory structure. According to the results of such generation, the IntelliJ IDEA folders are properly marked as the source or test roots.

See import settings.

Download Sources and/or Documentation

Click this button to download missing sources and documentation. Select the desired download option from the submenu.
You can set up automatic downloading of sources and documentation at the Importing page of the Maven Integration dialog.

Add Maven Project

Click this button to add a Maven project. Select the desired pom.xml file in the dialog that opens.

Run Maven Build

Click this button to execute the selected phase of the build lifecycle or a plugin goal. If several goals are selected, they will be executed in the same order as in the tree. Note that by default this button is disabled, to activate it you need to select a build phase or a plugin goal to run.

Execute Maven Goal

Click this button to execute a maven goal using a command line.

exec maven goal

Toggle Offline Mode

Click this button to toggle the offline mode.

Toggle Skip Test Mode

Click this button to turn on the Maven option Skip test mode, and omit running unit tests.

Show Dependencies

Click this button to show the dependencies of the current Maven project in a UML pop-up frame.

Collapse All

Click this button to collapse all nodes under the selected Maven project.

Maven Settings

Click this button to configure the settings of the current Maven project in the Maven Integration dialog box.

Show Options Menu Click this button to show the menu of the show options:
  • Group Modules: select this option to group the nodes by directories.

  • Show Ignored Projects:when this option is selected, the ignored nodes are shown in the tool window with a strikethrough. Otherwise, the ignored nodes are hidden.

  • Show Basic Phases Only: when this option is selected, IntelliJ IDEA shows only the basic build phases; otherwise, the complete list of phases is shown.

  • Always Show ArtifactId: select this option to display the artifactId that is specified in the pom.xml of your Maven project.

  • Show version: when this option is selected, IntelliJ IDEA displays the version of your Maven project that is specified in the pom.xml.

  • Show Toolbar - select this option to show the toolbar for your Maven projects.

  • Pinned, Docked, Floating, Windowed, Split Mode
  • 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 Maven Projects tool window to either top, left or right.

  • Resize - select this option to resize the Maven Projects tool window.

Context Menu Commands of a Lifecycle Phase

Command

Description

Create <project>[phase]

Choose this command to create run/debug configuration for the selected phase of a lifecycle.

Run <project>[phase]

Choose this command to run the selected phase of a lifecycle with the phase-specific run/debug configuration.

Debug <project>[phase]

Choose this command to debug the selected phase of a lifecycle with the phase-specific run/debug configuration.

Execute before Make, Execute after Make

Choose these commands to set the respective flags for the selected phase of a lifecycle. So doing, Before Make and After Make 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 phase of a lifecycle. In this case Before Rebuild and After Rebuild comments appear next to the name of the node.

Execute before Run/Debug

Choose this command to specify a run/debug configuration, prior to which the selected phase of a lifecycle should be executed. So doing,Before Run comment appears next to the name of the node.

Assign Shortcut

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

Context Menu Commands of a Maven Project

This section describes only those context menu commands that are not available from the toolbar.

Command

Description

Ignore Project / Unignore Project

Choose the Ignore Projects command to ignore project in build, or, on the contrary, include in build the previously ignored project.
Ignored projects are not imported into IntelliJ IDEA.

Remove Project

Choose this command to delete the selected Maven modules from the Maven structure. So doing you can opt to delete the corresponding Maven module from the IntelliJ IDEA project as well.

Create / Open 'settings.xml'
Create / Open 'profiles.xml'

Choose this command to create 'settings.xml' or 'profile.xml', or open such file if it has already been created.

Show Effective POM

Choose this command to generate the effective POM as an XML for this build, with the active profiles and super POM factored in. The effective POM displays the following information:
  • the default project source folders structure

  • the output directory

  • plug-ins required

  • repositories

  • a reporting directory which Maven will be using while executing the desired goals

Jump to source

Open in the editor the pom.xml file for the selected Maven project.

Last modified: 20 June 2019

See Also

Reference:

Concepts: