Introduce new IntelliJ IDEA unified type and deprecate IntelliJ IDEA Community (IC) since 2025.3

[hsz]

In order to comply with the introduction of the unified IntelliJ IDEA distribution (see IntelliJ IDEA Moves to the Unified Distribution, we're about to introduce the following changes to the IntelliJ Platform Gradle Plugin:

1. IntelliJPlatformType enum

• Introduce the IntelliJPlatformType.IntellijIdea type that still refers to the IU product code
• Deprecate the IntelliJPlatformType.IntellijIdeaUltimate and suggest replacing it with IntelliJPlatformType.IntellijIdea
• Deprecate the IntelliJPlatformType.IntellijIdeaCommunity and suggest replacing it with IntelliJPlatformType.IntellijIdea

2. Dependencies helpers (the dependencies.intellijPlatform {} extension)

• Introduce the intellijIdea(version) helper
• Deprecate the intellijIdeaUltimate(version) helper suggest replacing it with intellijIdea(version)
• Deprecate the intellijIdeaCommunity(version) helper suggest replacing it with intellijIdea(version)
• create(version)

3. String.parseIdeNotation() should not return IC when no type is specified but throw IllegalArgumentException instead

[jonathanlermitage]

Just to be sure, once the deprecated methods have been fully removed from the platform plugin (in a far, far future 😊), we will still be able to build plugins against IC, per example IC 2024 or IC 2025.1?

[hsz]

Those particular methods are required to stay, no worries!

[psyjewnaut]

why using any versions does not work with intellijIdea(version)?
org.gradle.api.GradleException: No IntelliJ Platform dependency found with 'IU-version (installer)'...

[hsz]

Because this helper is available since 2025.3

[psyjewnaut]

intellijIdea("2025.2")
org.gradle.api.GradleException: No IntelliJ Platform dependency found with 'IU-2025.2 (installer)'.

intellijIdea("2025.3")
org.gradle.api.GradleException: No IntelliJ Platform dependency found with 'IU-2025.3 (installer)'.

    intellijIdea("2025.4")

org.gradle.api.GradleException: No IntelliJ Platform dependency found with 'IU-2025.4 (installer)'.

any versions not found

[jeffxjh]

org.gradle.api.GradleException: No IntelliJ Platform dependency found with 'IC-2025.1.4.1 (installer)'.

[jonathanlermitage]

@psyjewnaut @jeffxjh If my understanding is correct, intellijIdea works with IntelliJ 2025.3+. AFAIK, 2025.3 is still in EAP, so you can't use intellijIdea("2025.3") because it doesn't exist yet. Same comment for 2025.4 😁

For IC-2025.1.4.1 (and any pre-2025.3 versions), use the old method (again, if I understand it correctly). If you don't want to handle intellijIdea, intellijIdeaUltimate and intellijIdeaCommunity (per example if you want to test your plugin in multiple sandboxed IDE versions), you may want to use createinstead. I did not test, but I hope this method still works.

[hsz]

I'm going to remove that deprecation notice as it raises too many confusions and I used it improperly — my bad here.
Instead, I'll introduce relevant messages through the Problems API, within the upcoming 2.10.0 version.