IntelliJ Platform Gradle Plugin's `intellijIdeaCommunity` deprecation

IntelliJ Platform
1

I have updated my plugin to depend on the platform Gradle plugin v2.9.0 (latest at the time of writing this comment).

That worked just fine but this part of my build script started issuing a deprecation warning:

intellijPlatform {
   // We target 2024.2.1 as it is the earliest version supporting K2 mode / the Analysis API
   intellijIdeaCommunity("2024.2.1")
// ~~~~~~~~~~~~~~~~~~~~~
}

Warning:

Starting with version 2025.3, IntelliJ IDEA Community (IC) is not available as a target IntelliJ Platform.

When I use the IDE “replace” action, the code changes to:

 intellijPlatform {
+   intellijIdea("2024.2.1")
 }

which stops the warning but causes the Gradle run task to fail:

Could not determine the dependencies of task ':plugin:runIde'.
> Failed to query the value of task ':plugin:runIde' property 'runtimeDirectory'.
   > Could not resolve all files for configuration ':plugin:intellijPlatformDependency'.
      > Could not find idea:idea:2024.2.1.
        Searched in the following locations:
          - https://repo.maven.apache.org/maven2/idea/idea/2024.2.1/idea-2024.2.1.pom
          - https://download.jetbrains.com/idea/idea-2024.2.1-aarch64.dmg
          - https://download.jetbrains.com/idea/idea-2024.2.1.aarch64.dmg
          - https://download.jetbrains.com/idea/2024.2.1/idea-2024.2.1-aarch64.dmg
          - https://download.jetbrains.com/idea/2024.2.1/idea-2024.2.1.aarch64.dmg
          - https://download.jetbrains.com/idea/idea-2024.2.1-aarch64.tar.gz
          - https://cache-redirector.jetbrains.com/www.jetbrains.com/intellij-repository/releases/idea/idea/2024.2.1/idea-2024.2.1.pom
          - https://cache-redirector.jetbrains.com/www.jetbrains.com/intellij-repository/snapshots/idea/idea/2024.2.1/idea-2024.2.1.pom
          - https://cache-redirector.jetbrains.com/intellij-dependencies/idea/idea/2024.2.1/idea-2024.2.1.pom
          - https://cache-redirector.jetbrains.com/plugins.jetbrains.com/maven/idea/idea/2024.2.1/idea-2024.2.1.pom
        Required by:
            project :plugin

I did a quick scan of the latest docs but didn’t see anything obvious about how to fix this. In fact, IntelliJ Platform Gradle Plugin (2.x) | IntelliJ Platform Plugin SDK still pushes you to use the deprecated method.

So… what am I expected to do here moving forward?

3

As said:

Starting with version 2025.3, IntelliJ IDEA Community (IC) is not available as a target IntelliJ Platform.

If you target IC in earlier version, use the old helper.
Starting with the 2025.3, we’re moving to an unified IJ distribution, which is widely announced here and there. Therefore, IC will not be available anymore for development.

4

Should the method not be deprecated then? Or could it parse the version and emit a runtime warning / error instead if too new? Or maybe intellijIdea can be made to handle older versions? Or maybe the deprecation warning that shows up should clarify that it can be ignored if targeting versions older than 2025.3?

Or do you expect most plugins to abandon older versions of the IDE eventually? (I was assuming I should try to support older versions as long as possible, is that wrong?)

5

We eventually expect developers to stop targeting older IC. There’s a golden rule advising to support the “current - 3” versions to cover majority of IDEs used.
However, many plugin developers, with their updates, target new IDEs already.

As for warnings emitted in the console output — from my experience, those are too often ignored (like from the verifyPluginProjectConfiguration task).

6

Hi @jakub.chrzanowski

Is there a place where we can see a full list of features that weren’t available in the IC but will be after the unification is released? (like LSP, etc)

Thanks

7

Hello Jonathan,

The full detailed list will be published later, closer to the release. Please stay tuned

On a high level, the following features will be available, compared to Community

  1. Wizards - like new project wizard for Spring and other frameworks,
  2. No false unused highlighting for framework-specific code
  3. Database support - ability to connect and see the schema.
  4. Basic highlighting for other languages - without PSI access
  5. LSP client, as announced
8

I’m getting a similar error, except that I’m targeting 2025.2.1; specifically:

I’m using:

  • org.jetbrains.intellij.platform:intellij-platform-gradle-plugin:2.9.0
  • create(type = IntelliJPlatformType.fromCode(platformType), version = platformVersion) (with platformType=IU and platformVersion=2025.2.1)

:broken_chain: Error: The error I’m getting is:

* What went wrong:
Could not resolve all files for configuration ':intellijPlatformDependency_959ec019-28cf-4015-be67-0fedf4214ba5'.
Could not find idea:idea:2025.2.1.
Required by:
    root project '<project_name>'

:check_mark: Fix: If I simply switch to using platformType = IC (and keep platformVersion=2025.2.1), everything works fine.

:question: Is this expected? It seems like the opposite of what I’d expect given the comments in this thread.