Incompatible Changes in IntelliJ Platform and Plugins API 2025.*

Edit pageLast modified: 24 March 2025

Please see Verifying Plugin Compatibility on how to use Plugin Verifier and IDE inspections to check such problems.

Early Access Program (EAP) releases of upcoming versions are available here.

note

Non-listed changes

Changes from API marked with @Deprecated(forRemoval=true) or any of ApiStatus @Experimental, @ScheduledForRemoval, or @Internal are not listed here, as incompatible changes are to be expected.

For API annotated with @ApiStatus.Internal/@IntellijInternalApi, see Internal API Migration for more details and replacements.

note

IDE and Java Versions

Java version must be set depending on the target platform version.

2024.2+: Java 21

2022.3+: Java 17

See Platform Versions for details.

warning

Gradle Plugin

The Gradle plugin must be chosen depending on the target platform version.

2024.2+

Requires IntelliJ Platform Gradle Plugin (2.x)

2022.3+

Recommended IntelliJ Platform Gradle Plugin (2.x),
Requires Gradle IntelliJ Plugin (1.x) version 1.10.1+ (current: 1.17.4)

2025.2

IntelliJ Platform 2025.2

2025.1

IntelliJ Platform 2025.1

Code scheduled with SwingUtilities.invokeLater and SwingUtilities.invokeAndWait does not hold the write-intent lock

Consider using an explicit wrapping with ReadAction.compute() or WriteAction.run(ThrowableRunnable<E>). See Threading Model.

Coroutines running under Dispatchers.Main do not hold the write-intent lock

To restore the old behavior, consider using Dispatchers.EDT. See Threading Model.

com.intellij.psi.xml.XmlTokenType class now interface

Use XmlTokenType constants directly.

Class com.intellij.psi.xml.XmlElementType no longer extends com.intellij.psi.xml.XmlTokenType

Update code usages.

filetype.xml.description property removed from resource bundle messages.XmlPsiBundle

Use property from resource bundle messages.XmlParserBundle

xml.parsing.closing.tag.matches.nothing property removed from resource bundle messages.XmlPsiBundle

Use property from resource bundle messages.XmlParserBundle

xml.parsing.unclosed.attribute.value property removed from resource bundle messages.XmlPsiBundle

Use property from resource bundle messages.XmlParserBundle

xml.parsing.unescaped.ampersand.or.nonterminated.character.entity.reference property removed from resource bundle messages.XmlPsiBundle

Use property from resource bundle messages.XmlParserBundle

com.jediterm.terminal.model.TextBufferChangesListener.historyCleared() abstract method added

Must be implemented.

com.intellij.terminal.ui.TerminalWidget.connectToSession(TerminalSession session) abstract method added

Must be implemented.

com.intellij.terminal.ui.TerminalWidget.getSession() abstract method added

Must be implemented.

com.intellij.terminal.ui.TerminalWidget.getTerminalSizeInitializedFuture() abstract method added

Must be implemented.

Database Plugin 2025.1

com.intellij.database.view.models package removed

Old table modification dialog was finally removed. Use com.intellij.database.actions.ddl.ModifyObjectAction.showDialog() for new dialog invocation.

com.intellij.database.schemaEditor.model.DeObject class removed

Old table modification dialog was finally removed. Use com.intellij.database.actions.ddl.ModifyObjectAction.showDialog() for new dialog invocation.

com.intellij.database.view.editors.DatabaseEditorContext class removed

Old table modification dialog was finally removed. Use com.intellij.database.actions.ddl.ModifyObjectAction.showDialog() for new dialog invocation.

com.intellij.database.view.editors.DatabaseTableEditor class removed

Old table modification dialog was finally removed. Use com.intellij.database.actions.ddl.ModifyObjectAction.showDialog() for new dialog invocation.

com.intellij.database.view.ui.DbRefactoringDialogHelper class removed

Old table modification dialog was finally removed. Use com.intellij.database.actions.ddl.ModifyObjectAction.showDialog() for new dialog invocation.

com.intellij.database.view.ui.DbTableDialog class removed

Old table modification dialog was finally removed. Use com.intellij.database.actions.ddl.ModifyObjectAction.showDialog() for new dialog invocation.

External System 2025.1

com.intellij.openapi.externalSystem.service.internal.ExternalSystemProcessingManager class now interface

Recompile code usages.

Kotlin Plugin 2025.1

org.jetbrains.kotlin.KtFakeSourceElement class renamed to org.jetbrains.kotlin.KtFakePsiSourceElement

Update code usages.

org.jetbrains.kotlin.ir.linkage.IrDeserializer.IrLinkerExtension class removed

This class was removed from the Kotlin compiler and is no longer available.

org.jetbrains.kotlin.ir.builders.TranslationPluginContext class removed

This class was removed from the Kotlin compiler and is no longer available.

org.jetbrains.kotlin.analysis.decompiler.stub.file.ClsClassFinder.isKotlinInternalCompiledFile$default(ClsClassFinder, VirtualFile, byte[], int, Object) method removed

Recompile code usages.

Remote Development 2025.1

com.jetbrains.rd.ide.model.AddToGroupRuleModel class removed

Remove all usages.

com.jetbrains.rd.ide.model.ActionConstraintModel class removed

Remove all usages.

JavaScript and TypeScript Plugin 2025.1

com.intellij.lang.javascript.service.JSAsyncLanguageServiceBase.JSLanguageServiceInfoReporter class moved to package com.intellij.lang.javascript.service

Update all usages

com.intellij.lang.javascript.JSElementTypes.toModuleContentType(IElementType type) method removed

Use com.intellij.lang.javascript.JSModuleContentType.toModuleContentType(IElementType type) method instead

com.intellij.lang.javascript.BaseJSTokenTypes class removed

Use com.intellij.lang.javascript.JSTokenTypes class instead

com.intellij.lang.javascript.highlighting.TypeScriptHighlighter(DialectOptionHolder dialectOptionsHolder, boolean skipKeywordHighlights) constructor removed

Use constructor without skipKeywordHighlights parameter

com.intellij.lang.javascript.dialects.ECMA6SyntaxHighlighterFactory.ECMA6SyntaxHighlighter(DialectOptionHolder dialectOptionsHolder, boolean skipKeywordHighlights) constructor removed

Use constructor without skipKeywordHighlights parameter

com.intellij.lang.javascript.highlighting.JSHighlighter(DialectOptionHolder dialectOptionsHolder, boolean skipKeywordHighlights) constructor removed

Use constructor without skipKeywordHighlights parameter