IntelliJ IDEA 2016.2 Help

Libraries and Global LibrariesFacets

Project Library and Global Library Pages

File | Project Structure | Libraries or Global Libraries | <library>

The Project Library or the Global Library page opens in the right-hand part of the Project Structure dialog when you select a project or global library in the element selector pane.

Use this page to edit the library name and to manage the library contents.

The set of the available controls depends on whether you are working with a Java or ActionScript/Flex library, or a JavaScript library.

Controls for a Java or ActionScript/Flex library

ItemDescription
Change Version This button may be available for a library that implements a certain framework or technology (e.g. JSF, Spring) in cases when IntelliJ IDEA can make version-specific file replacements in the library.

In such cases, when you click this button, the Downloading Options Dialog opens in which you can select the necessary library version, and also the files to be downloaded.

As a result, the files in the library will be replaced with the downloaded files.

add (Alt+Insert) Use this icon or shortcut to add items (classes, sources, documentation, etc.) to the library.

In the dialog that opens, select the necessary files and folders. For a Java library, these may be individual .class and .java files, directories and archives (.jar and .zip) containing such files as well as directories with Java native libraries (.dll, .so or .jnilib). For an ActionScript/Flex library, these may be raw ActionScript 3 libraries, .swc, .jar and .zip files, the directories containing such files, and so on.

IntelliJ IDEA will analyze the selected files and folders, and automatically assign their contents to the appropriate library categories (Classes, Sources, Documentation, Native Library Locations, etc.).

When IntelliJ IDEA cannot guess the category (e.g. when you select an empty folder), a dialog will be shown, in which you will be able to specify the category yourself.

icon_doc_url To be able to use external documentation available online, click this icon and specify the URL of the external documentation in the dialog that opens.
iconLibExclude Click this icon to make certain library items "excluded" (see Excluded library items). In the dialog that opens, select the items that you want IntelliJ IDEA to ignore (folders, archives and folders within the archives), and click OK.
delete (Delete) When you click this icon or press Delete:
  • The selected "ordinary" library items are removed from the library.
  • The selected excluded items (see Excluded library items) become "ordinary" items, i.e. their excluded status is cancelled. The items themselves will stay in the library.

Controls for a JavaScript library

ItemDescription
add (Alt+Insert)Use this icon or shortcut to add items to the library. Select one of the following options:
  • Attach Files or Directories. Select this option to add JavaScript files.

    In the dialog that opens, select the necessary files and folders. These may be individual JavaScript files and the directories containing such files.

    IntelliJ IDEA will analyze the selected files and folders, and automatically assign the JavaScript files to the appropriate categories. Minified files will be assigned to the Release category; ordinary (uncompressed) files will be assigned to the Debug category.

    When IntelliJ IDEA cannot guess the category (e.g. when you select an empty folder), a dialog will be shown, in which you will be able to specify the category (Release or Debug) yourself.

  • Attach Debug Version(s). Select this option to add a single uncompressed JavaScript file or a directory containing such files.

    Note that IntelliJ IDEA won't analyze the contents of the selected files. If you select a minified JavaScript file or a directory containing minified JavaScript files, the corresponding file or files will still be added to the library.

  • Attach Release Version(s). Select this option to add a single minified JavaScript file or a directory containing such files.

    Note that IntelliJ IDEA won't analyze the contents of the selected files. If you select an ordinary (uncompressed) JavaScript file or a directory with such files, the corresponding file or files will still be added to the library.

  • Specify Documentation URL. Select this option to make external online documentation available in IntelliJ IDEA. Specify the documentation URL in the dialog that opens.
  • Download Documentation. For jQuery: select this option to download and include jQuery documentation in the library.
iconLibExclude Click this icon to make certain library items "excluded" (see Excluded library items). In the dialog that opens, select the folders that you want IntelliJ IDEA to ignore, and click OK.
delete (Delete) When you click this icon or press Delete:
  • The selected "ordinary" library items are removed from the library.
  • The selected excluded items (see Excluded library items) become "ordinary" items, i.e. their excluded status is cancelled. The items themselves will stay in the library.
Libraries and Global LibrariesFacets

See Also

Procedures:

Reference:

Concepts:

Last modified: 23 November 2016