Output Layout Tab

IntelliJ IDEA 12.1.0 Web Help

10.0+

Some features described here are available in Ultimate edition only.

Use this tab to configure layouts of the artifacts. The tab consists of the following areas:

Artifact Layout pane, where you can complete the layout of an artifact by adding or removing elements, and changing their order. Use the toolbar buttons, the context menu, or drag elements from the Available Elements pane.
Available Elements pane, which shows modules, libraries, facet resources, and artifact layouts that are currently available in the project and are not included in the current artifact.
Add these items by dragging and dropping them to the desired location in the Artifact Layout Pane or by using the commands of the context menu.
Manifest File Properties Area, which is available for JAR, WAR, or EAR archives, and shows the manifest file settings for the currently selected archive.

For the details on common options, click here.

Artifact layout pane: toolbar

Item	Tooltip and Shortcut	Description
	Create Directory	Click this button to have a folder added to the currently selected element in the output layout tree.
	Create Archive	Click this button to have an archive added to the currently selected element in the output layout tree.
	Add Copy of	Click this button to have a copy of an element added to the currently selected element in the output layout tree. From the context menu, select the desired element type, then specify the source element location. The following options are available: Library Files: if this option is selected, the files from the Classes section of a library will be included in the artifact. So doing, the JAR archives will be copied as is; as for the directories, their contents will be copied rather than the whole directories. Module Output: if this option is selected, the production output of the selected module will be copied; the test output will not be included in the artifact. Module Test Output: if this option is selected, the compiled classes from tests roots of a module will be included into an artifact. Artifact: select this option to have the current artifact contain the output of another artifact (a directory or an archive). Appoint the artifact to include in the Choose Artifacts, that opens. Note The entire output of the selected artifact will be copied to the specified place in the output of the target artifact. If the output directory of the included artifact contains files produced by an external process (e.g. by an Ant task specified as post-processing task for the artifact or the output directory points to an existing folder on disk), all these files will be copied to the target artifact as well as the files explicitly specified in the output layout of the included artifact. File: the specified file will be copied to the specified location. Directory Content: in this case, the content of the directory, and the nested subdirectories will be copied recursively. Extracted Directory: the specified archive or a directory within such archive will be unpacked to the specified location. JavaEE Facet Resource: this option is available, when Web, EJB, or JavaEE Application facets are enabled. If this option is selected, the descriptors will be copied, as well as the web root (in case of the web facet). GWT Compiler Output: this option is available, when GWT facet is enabled. If this option is selected, on building an artifact for the selected facet, a GWT compiler will be launched, and its output will be copied to the specified location.
	Remove	Click this button to remove the selected item from the layout. The removed element immediately appears in Available Elements pane.
	Sort Elements by Names and Types	When this button is pressed, items are sorted first by their types, then alphabetically within types.
	Move Up/ Move Down	Use these buttons to change the order of items in the artifact tree. You may need to do it if you have two items with the same name. In this situation, the artifact will be built with the one that comes first. Note The buttons are available only when the Sort Elements by Names and Types button is released.

Artifact layout pane: context menu

Note

Most of the actions below can be also invoked through the toolbar buttons. This section describes functions that are available only through the context menu.

Item	Description
Extract Artifact	Use this option to have a set of elements in the layout tree grouped and presented as a separate artifact.
Inline Artifact	Use this option to have the selected artifact disassembled and its its components presented as independent elements.
Rename	Select this option to assign the selected folder or archive a new name.
Navigate	Select this option to switch to the settings of the selected item. If you apply this command with an artifact layout selected, the contents of the tab change and the controls show the data of the selected layout. If the command is applied to a module, a facet, or a library, IntelliJ IDEA switches to the settings of the selected item on one of the pages Modules, Facets, or Libraries, depending on the type of the current element.
Find Usages	Select this option to view a list of layouts in which the selected element is included.
Expand All	Select this option to have all the nodes in the pane unfolded.
Collapse All	Select this option to have all the nodes in the pane collapsed.

Available elements pane

Menu Item	Description
Put into	Select this option to have the current element added to the artifact layout "as is". When this command is applied, IntelliJ IDEA adds the selected element to the default location depending on the type of the artifact and the element. For example, module output of a web module by default will be added below WEB-INF/classes, while a library will be added to WEB-INF/lib. Tip Alternatively, double-click an element to add it to default location, or just drag-and-drop to the location of your choice.
Pack into	Select this option to have the current module output packed into a jar archive with the same name.
Navigate	Select this option to switch to the settings of selected item. If you apply this command with an artifact layout selected, the contents of the tab change and the controls show the data of the selected layout. If the command is applied to a module, a facet, or a library, IntelliJ IDEA switches to the settings of the selected item on one of the pages Modules, Facets, or Libraries, depending on the type of the current element.
Find Usages	Select this option to view a list of layouts in which the selected element is included.
Expand All	Select this option to have all the nodes in the pane unfolded.
Collapse All	Select this option to have all the nodes in the pane collapsed.

Manifest file properties area

Menu Item	Description
Manifest File	The read-only field shows the name of the manifest file of the current artifact layout.
Main Class	In this text box, specify the fully qualified name of the class that will be used as the main-class entry of the manifest file. If necessary, click the Browse button and choose the desired main class in the Select Main Class dialog box, that opens. You can search for the main class by name or browse through the project tree.
Class Path	In this text box, specify the class-path attribute of the manifest.mf file. This attribute contains a space separated list of JARs that the current archive depend on. When the current archive is run as an executable JAR or on an application server, the JARs from the list are added to the classpath, thus making their classes available for classes of the currently selected archive.
Create Manifest	Click this button to have a missing manifest file generated, and specify the location for it in the dialog that opens.
Use Existing Manifest	Click this button to have an existing manifest file used and specify its location in the Specify Path dialog box, that opens.

See Also

Concepts:

Procedures:

Reference:

Web Resources:

Knowledge Base