IntelliJ IDEA 2016.3 Help

Maven Projects Tool Window

View | Tool Windows | Maven Projects

This tool window is marked with the icon /help/img/idea/2016.3/icon_maven.png.

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.

In this section:

Toolbar Buttons

ItemDescription
img Click this button to synchronize all Maven projects with the IntelliJ IDEA project. See Importing tab of the Maven Integration dialog box.
icon_MavenUpdateFolders.png 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.

img 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.png Click this button to add a Maven project. Select the desired pom.xml file in the dialog that opens.
runBuild.gif 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.
/help/img/idea/2016.3/maven_goal_icon.png Click this button to execute a maven goal using a command line.
/help/img/idea/2016.3/exec_maven_goal.png
img Click this button to toggle offline mode.
iconSkipTest.png Click this button to turn on the Maven option Skip test mode, and omit running unit tests.
/help/img/idea/2016.3/icon_UML.png Click this button to show the dependencies of the current Maven project in a UML pop-up frame.
/help/img/idea/2016.3/collapseAll.png Click this button to collapse all nodes under the selected Maven project.
img Click this button to configure the settings of the current Maven project in the Maven Integration dialog box.
/help/img/idea/2016.3/help.png Click this button to show reference page.
/help/img/idea/2016.3/iconAction.png 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

CommandDescription
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 MakeChoose 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 RebuildChoose 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/DebugChoose 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 ShortcutChoose 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.

CommandDescription
Ignore Project / Unignore ProjectChoose 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 ProjectChoose 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 POMChoose 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 sourceOpen in the editor the pom.xml file for the selected Maven project.

See Also

Last modified: 21 March 2017