00mjk / intellij-scala

Scala plugin for IntelliJ IDEA

Scala Plugin for IntelliJ IDEA

Plugin that implements Scala, sbt, Play 2, SSP and Hocon support in IntelliJ IDEA.

General information

• To get information about how to install and use this plugin in IDEA, please use IntelliJ IDEA online help.

• If you have any question about the Scala plugin, we'd be glad to answer it in our developer community.

• If you found a bug, please report it on our issue tracker.

• If you want to contribute, please see our intro to the Scala plugin internals.

Setting up the project

Prerequisites

In order to take part in Scala plugin development, you need:

1. IntelliJ IDEA 2020.1 or higher with a compatible version of Scala plugin
2. JDK 8
3. (optional but recommended) Enable "internal mode" in IDEA

Setup

1. Clone this repository to your computer

$ git clone https://github.com/JetBrains/intellij-scala.git

2. Open IntelliJ IDEA, select File -> New -> Project from existing sources, point to the directory where the Scala plugin repository is and then import it as sbt project.

3. In the next step, select JDK 8 as project JDK (create it from an installed JDK if necessary).

4. Select the scalaCommunity run configuration and select the Run or Debug button to build and start a development version of IDEA with the Scala plugin.

Browsing IntelliJ platform sources

When loading the plugin in sbt, the IntelliJ platform is downloaded to <home>/.ScalaPluginIC/sdk/<sdk version>/. IntelliJ platform sources should automatically attach after project has been imported and indices have been built.

However, if this didn't happen, and if you're seeing decompiled code when opening a platform API class you can click the option "attach sources" at the top of the editor, navigate to the sdk directory and select sources.zip, then choose "All".

Tests

To run tests properly, the plugin needs to be packaged. On the sbt shell:

1. packageArtifact
2. runFastTests

The "fast tests" can take over an hour. To get a quick feedback on project health, run only the type inference tests:

> runTypeInferenceTests

GitHub Actions build

The project is configured to build and run the typeInference tests and fast tests with Github Actions. The full test suite isn't run to avoid really long build times.

Running the plugin

Debugging mode

The easiest way to try your changes is typically to launch the scalaCommunity run configuration which is created when you set up the project as described above.

As a standalone plugin

To run and distribute a modified version of the plugin in a regular IntelliJ instance, you need to package it.

1. on the sbt shell, run packageArtifactZip. This will output the generated plugin zip location (typically into <project directory>/target/scala-plugin.zip).
2. In IntelliJ, open Preferences, section Plugins, choose "Install plugin from disk..." and navigate to the scala-plugin.zip
3. Restart IntelliJ