DEV_IDE_SETUP.md

IntelliJ Development Instance Setup

DevKit Plugin

For IntelliJ 2023.3 and newer, make sure you have DevKit plugin installed in your host IntelliJ.

https://plugins.jetbrains.com/plugin/22851-plugin-devkit

Import the plugin project.

Clone and import this repository as you would any other Bazel project. When asked, use the bundled project view file (ijwb/ijwb.bazelproject). This will:

• Set the plugin to build with the latest development version by default.
• Automatically import the relevant target, and exclude the irrelevant ones.

Depending on which JetBrains product you're targeting, you may want to adjust the --define flag in the build_flags section. For more information on which values you can pass, please refer to Building the Plugin

Download and Install the JetBrains Runtime SDK

Most of the time, the IntelliJ Platform Plugin SDK bundled with your IntelliJ installation should be enough to compile and run the plugin.

To install it, please head to the SDK menu (Cmd+; or Ctrl+;), and then to Platform Settings -> SDKs.

In the list of SDKs, press the + icon, then Add IntelliJ Platform Plugin SDK.

A file explorer window should open in the Contents directory of your IntelliJ installation. Select that directory.

Make sure that the Internal Java Platform is set to the JDK you want to use to develop your plugin. It is recommended to use JBR 17.

Set the project-wide SDK

Inside IntelliJ, go to the SDK menu (Cmd+; or Ctrl+;).

Go to Project, and look under SDK to find the JetBrains Runtime SDK installed in the previous step.

Create a run configuration and add appropriate flags

Once the project is imported, create a new Run configuration: Run -> Edit Configurations....

Click the + sign, and create a new Bazel IntelliJ Plugin run configuration (the Bazel IntelliJ plugin needs to be installed):

Configure the Plugin SDK field to use the SDK you've just installed.