IntelliJ IDEA 2024.3 Help

SDKs

A Software Development Kit, or an SDK, is a collection of tools that you need to develop an application for a specific software framework. For example, to develop applications in Java, you need a Java SDK (JDK). SDKs contain binaries, source code for the binaries, and documentation for the source code. JDK builds also contain annotations.

Generally, SDKs are global. It means that one SDK can be used in multiple projects and modules. After you create a new project and define an SDK for it, you can configure modules in this project to inherit its SDK. You can also specify an SDK for each module individually. For more information, refer to Change module SDK.

Supported SDKs

Configure SDKs

To define an SDK means to let IntelliJ IDEA know in which folder on your computer the necessary SDK version is installed. This folder is called an SDK home directory.

Add a global SDK

  1. In the main menu, go to File | Project Structure | Platform Settings | SDKs.

  2. Click the Add button and select the necessary option from the list of SDKs detected on your computer.

  3. Only for JDKs: if the IDE cannot find the necessary JDK on your computer automatically, click Add JDK from disk and specify its home directory in the dialog that opens.

    If you don't have the necessary JDK on your computer, select Download JDK. In the next dialog, specify the JDK vendor, version, change the installation path if required, and click Download.

Show available SDKs in the Project Structure dialog

Remove an SDK

You can remove unnecessary SDKs from your IDE.

  1. In the main menu, go to File | Project Structure | Platform Settings | SDKs.

  2. Select the SDK you want to remove and click the Add button.

  3. Apply the changes and close the dialog.

    Removing SDK from IDE

Add a project SDK

  1. In the main menu, go to File | Project Structure | Project Settings | Project.

  2. If the necessary SDK is already defined in IntelliJ IDEA, select it from the Detected SDKs list.

  3. Only for JDKs: if the IDE cannot find the necessary JDK on your computer automatically, click Add JDK from disk and specify its home directory in the dialog that opens.

    If you don't have the necessary JDK on your computer, select Download JDK. In the next dialog, specify the JDK vendor, version, change the installation path if required, and click Download.

Change the project SDK

Add a module SDK

  1. In the main menu, go to File | Project Structure | Project Settings | Modules.

  2. Select the module for which you want to set an SDK and click Dependencies.

  3. If the necessary SDK is already defined in IntelliJ IDEA, select it from the Detected SDKs list.

  4. Only for JDKs: if the IDE cannot find the necessary JDK on your computer automatically, click Add JDK from disk and specify its home directory in the dialog that opens.

    If you don't have the necessary JDK on your computer, select Download JDK. In the next dialog, specify the JDK vendor, version, change the installation path if required, and click Download.

Setting up another module-level SDK

Java Development Kit (JDK)

To develop applications in IntelliJ IDEA, you need a Java SDK (JDK). A JDK is a software package that contains libraries, tools for developing and testing Java applications (development tools), and tools for running applications on the Java platform (Java Runtime Environment – JRE).

The JRE can be obtained separately from the JDK, but it is not suitable for application development, as it doesn't have essential components such as compilers and debuggers.

In IntelliJ IDEA, you can download a JDK package right from the IDE, or you can manually download the necessary JDK distribution and define it in the IDE.

For a manual download, use any available distribution that you like, for example:

Set up the project JDK

  1. In the main menu, go to File | Project Structure | Project Settings | Project.

  2. If the necessary JDK is already defined in IntelliJ IDEA, select it from the SDK list.

    If the JDK is installed on your computer but not defined in the IDE, select Add SDK from disk and specify the path to the JDK home directory (for example, /Library/Java/JavaVirtualMachines/jdk-12.0.1.jdk).

    Change a project SDK
  3. If you don't have the necessary JDK on your computer, select Download JDK. In the next dialog, specify the JDK vendor, version, change the installation path if required, and click Download.

    Downloading a JDK when creating a project
  4. Apply the changes and close the dialog.

Kotlin SDK

Kotlin SDK is distributed differently from JDKs. It is added to your project as a regular library dependency and resides in the .m2 folder. The IDE downloads it for you when you create a new Kotlin project or sync an existing project. You can also add Kotlin to an existing JVM project.

Kotlin SDK in Project tool window

Learn more about Kotlin from the Kotlin documentation.

Configure SDK documentation

You can add documentation to IntelliJ IDEA so that you can get information about symbols and method signatures right from the editor in the Quick Documentation popup.

You can also configure external documentation by specifying the path to the reference information online. External documentation opens the necessary information in a browser so that you can navigate to related symbols and keep the information for further reference at the same time.

In SDKs, documentation is normally bundled. However, you can configure it manually in case you need additional or specific documentation or if you work offline.

Specify SDK documentation paths

To view external SDK documentation, configure the documentation URL first.

  1. In the Project Structure dialog Ctrl+Alt+Shift+S, select SDKs.

  2. Select the necessary SDK version if you have several SDKs configured and open the Documentation Path tab on the right.

  3. Click the Specify URL icon, enter the external documentation URL, and click OK.

    For example, for Java 20, type https://docs.oracle.com/en/java/javase/20/docs/api/.

    Specifying SDK documentation paths
  4. Apply the changes and close the dialog.

Access SDK documentation offline

If you work offline, you can view external documentation locally.

  1. Download the documentation package of the necessary version.

    The documentation package is normally distributed in a ZIP archive that you need to unpack once it is downloaded.

    For example, you can download the official Java SE Development Kit 20 Documentation and unzip it.

  2. In the Project Structure dialog Ctrl+Alt+Shift+S, select SDKs.

  3. Select the necessary JDK version if you have several JDKs configured and open the Documentation Path tab on the right.

  4. Click the Add icon and specify the directory with the downloaded documentation package (for example, C:\Users\jetbrains\Desktop\docs\api).

  5. Apply the changes and close the dialog.

When the documentation is configured, you can open it in the editor.

Last modified: 11 October 2024