IntelliJ IDEA 2017.3 Help

Configure Library Dialog

Use this dialog 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.

new or 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.
iconLibExcludeClick this icon to make certain library items "excluded" (see Exclude 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 or Delete When you click this icon or press Delete:
  • The selected "ordinary" library items are removed from the library.
  • The selected excluded items (see Exclude 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
new or Alt+InsertUse 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.
iconLibExcludeClick this icon to make certain library items "excluded" (see Exclude library items). In the dialog that opens, select the folders that you want IntelliJ IDEA to ignore, and click OK.
delete or Delete When you click this icon or press Delete:
  • The selected "ordinary" library items are removed from the library.
  • The selected excluded items (see Exclude library items) become "ordinary" items, i.e. their excluded status is cancelled. The items themselves will stay in the library.
Last modified: 6 March 2018

See Also