mirror of
https://github.com/JetBrains/intellij-sdk-code-samples.git
synced 2025-07-27 16:57:49 +08:00
remove 2019 content
This commit is contained in:
Yann Cébron
parent
46d875276f
commit
648f05f384
1
ijs.tree
1
ijs.tree
@ -415,7 +415,6 @@
|
||||
<toc-element topic="api_changes_list_2022.md" toc-title="2022.*"/>
|
||||
<toc-element topic="api_changes_list_2021.md" toc-title="2021.*"/>
|
||||
<toc-element topic="api_changes_list_2020.md" toc-title="2020.*"/>
|
||||
<toc-element topic="api_changes_list_2019.md" toc-title="2019.*"/>
|
||||
</toc-element>
|
||||
</toc-element>
|
||||
<toc-element topic="api_notable.md" toc-title="Notable API Changes"
|
||||
|
||||
@ -86,7 +86,6 @@ The following pages list the breaking changes in IDE and plugin releases with re
|
||||
* [Changes in 2022.*](api_changes_list_2022.md)
|
||||
* [Changes in 2021.*](api_changes_list_2021.md)
|
||||
* [Changes in 2020.*](api_changes_list_2020.md)
|
||||
* [Changes in 2019.*](api_changes_list_2019.md)
|
||||
|
||||
## Bundled Library Updates
|
||||
|
||||
|
||||
@ -1,296 +0,0 @@
|
||||
<!-- Copyright 2000-2025 JetBrains s.r.o. and other contributors. Use of this source code is governed by the Apache 2.0 license that can be found in the LICENSE file. -->
|
||||
|
||||
# Incompatible Changes in IntelliJ Platform and Plugins API 2019.*
|
||||
|
||||
<!--
|
||||
Before documenting a breaking API change, please make sure that the change cannot be avoided in an alternative way.
|
||||
|
||||
APIs marked with @Deprecated(forRemoval=true), @ApiStatus.Experimental, @ApiStatus.Internal/IntellijInternalApi, or @ApiStatus.ScheduledForRemoval don't need to be documented.
|
||||
|
||||
To document a new incompatible change, add a new line with the problem pattern followed by a 2nd line with ": "-prefixed human-readable description
|
||||
and recommended fix/action (REQUIRED, please write full sentence ending with '.', see existing entries as reference).
|
||||
Non-platform changes must be grouped under relevant section for plugin.
|
||||
|
||||
The following problem patterns are supported and must be followed EXACTLY (e.g., no '#' instead of '.'):
|
||||
|
||||
<package name> package removed
|
||||
|
||||
<class name> class removed
|
||||
<class name> class renamed to <new class name>
|
||||
<class name> class moved to package <package name>
|
||||
|
||||
<class name>.<method name>(<human-readable parameters>) marked abstract
|
||||
<class name>.<method name>(<human-readable parameters>) abstract method added
|
||||
<class name>.<method name>(<human-readable parameters>) method removed
|
||||
<class name>.<method name>(<human-readable parameters>) method moved to the superclass
|
||||
<class name>.<method name>(<human-readable parameters>) method return type changed from <before> to <after>
|
||||
<class name>.<method name>(<human-readable parameters>) method visibility changed from <before> to <after>
|
||||
<class name>.<method name>(<human-readable parameters>) method marked final
|
||||
<class name>.<method name>(<human-readable parameters>) method parameter <type> removed
|
||||
<class name>.<method name>(<human-readable parameters>) method parameter type changed from <before> to <after>
|
||||
<class name>.<method name> method <parameter name> parameter marked @<class name>
|
||||
<class name> (class|interface) now (extends|implements) <class name> and inherits its final method <method name>(<human-readable parameters>)?
|
||||
<class name> (class|interface) now (extends|implements) <class name> and inherits its abstract method <method name>(<human-readable parameters>)?
|
||||
<class name> class now interface
|
||||
|
||||
<class name>(<human-readable parameters>) constructor removed
|
||||
<class name>(<human-readable parameters>) constructor parameter <type> removed
|
||||
<class name>(<human-readable parameters>) constructor parameter type changed from <before> to <after>
|
||||
<class name>(<human-readable parameters>) constructor visibility changed from <before> to <after>
|
||||
|
||||
<class name>.<field name> field removed
|
||||
<class name>.<field name> field moved to the superclass
|
||||
<class name>.<field name> field type changed from <before> to <after>
|
||||
<class name>.<field name> field visibility changed from <before> to <after>
|
||||
|
||||
<property name> property removed from resource bundle <bundle name>
|
||||
|
||||
Where the placeholders must be enclosed in code quotes (`name`):
|
||||
|
||||
<class name> is a fully-qualified name of the class, e.g. `com.intellij.openapi.actionSystem.AnAction$InnerClass`.
|
||||
<method name> is the exact method's name. Note that constructors have dedicated patterns.
|
||||
<human-readable parameters> is a string representing parameters, which are not necessarily fully qualified. They do not affect the parser. For example, instead of (java.lang.Object, java.util.List, int) you are free to write (Object, List<String>, int)
|
||||
<parameter name> is exact name of the method's parameter
|
||||
<property name> is a full name of a property from .properties file, like `some.action.description`
|
||||
<bundle name> is a fully qualified name of the property bundle, which includes its package, like `message.IdeBundle`
|
||||
|
||||
NOTE: If a code change you're trying to document doesn't match any of the above patterns, please ask in #plugins-verifier
|
||||
|
||||
NOTE: You are allowed to prettify the pattern using links: [`org.example.Foo`](https://github.com/JetBrains/intellij-community/tree/master/)
|
||||
|
||||
NOTE: Entries not starting with code quotes (`name`) can be added to document non-code changes and will be skipped in API verification.
|
||||
-->
|
||||
|
||||
<link-summary>List of known Breaking API Changes in 2019.*</link-summary>
|
||||
|
||||
<include from="snippets.topic" element-id="apiChangesHeader"/>
|
||||
|
||||
## 2019.3
|
||||
|
||||
### IntelliJ Platform 2019.3
|
||||
|
||||
`com.intellij.codeInsight.TailType.getLocalCodeStyleSettings(Editor, int)` method removed
|
||||
: Use `com.intellij.psi.codeStyle.CommonCodeStyleSettings.getLocalCodeStyleSettings(Editor, int)` instead.
|
||||
|
||||
`com.intellij.codeInsight.TailType.EQ` field removed
|
||||
: Use `com.intellij.codeInsight.lookup.EqTailType.INSTANCE` instead.
|
||||
|
||||
`com.intellij.codeInsight.TailType.COMMA` field removed
|
||||
: Use `com.intellij.codeInsight.lookup.CommaTailType.INSTANCE` instead.
|
||||
|
||||
`com.intellij.codeInsight.completion.CompletionContributor.getActionShortcut(String)` method removed
|
||||
: Use `com.intellij.codeInsight.completion.CompletionUtil.getActionShortcut(String)` instead
|
||||
|
||||
`com.intellij.codeInsight.AutoPopupController.runTransactionWithEverythingCommitted(Project, Runnable)` method removed
|
||||
: Use `com.intellij.codeInsight.AutoPopupControllerImpl.runTransactionWithEverythingCommitted(Project, Runnable)` instead
|
||||
|
||||
`com.intellij.codeInsight.completion.InsertionContext.getCodeStyleSettings()` method removed
|
||||
: Use `com.intellij.codeInsight.completion.util.CompletionStyleUtil.getCodeStyleSettings(InsertionContext)` instead
|
||||
|
||||
`com.intellij.codeInsight.completion.CompletionUtil.sortMatching(PrefixMatcher, Collection)` method removed
|
||||
: Use `com.intellij.codeInsight.completion.PrefixMatcher.sortMatching(Collection)` instead
|
||||
|
||||
`com.intellij.json.JsonFileTypeFactory` class removed
|
||||
: Use <include from="snippets.topic" element-id="ep"><var name="ep" value="com.intellij.fileType"/></include> instead.
|
||||
|
||||
`com.intellij.util.containers.ConcurrentHashSet` class removed
|
||||
: Use `com.intellij.util.containers.ContainerUtil#newConcurrentSet` instead.
|
||||
|
||||
`com.intellij.openapi.editor.impl.EditorFactoryImpl(EditorActionManager)` constructor removed
|
||||
: Use `com.intellij.openapi.editor.EditorFactory.getInstance()` instead.
|
||||
|
||||
`com.intellij.util.net.ssl.CertificateManager.HOSTNAME_VERIFIER` field removed
|
||||
: Use `org.apache.http.conn.ssl.DefaultHostnameVerifier` instead.
|
||||
|
||||
`com.intellij.openapi.util.BuildNumber.getBuildNumber()` method removed
|
||||
: See `BuildNumber.asString`, `BuildNumber.getBaselineVersion()` and `BuildNumber.getComponents()` as alternatives.
|
||||
|
||||
`com.intellij.remoteServer.configuration.deployment.DeploymentConfigurationManager.createAndRunConfiguration(ServerType, RemoteServer)` method removed
|
||||
: Use `DeploymentConfigurationManager.createAndRunConfiguration(ServerType, RemoteServer, DeploymentSourceType)` instead.
|
||||
|
||||
#### VCS
|
||||
`com.intellij.openapi.vcs.changes.ui.ChangesListView.UNVERSIONED_FILES_DATA_KEY` field removed
|
||||
: Use `com.intellij.openapi.vcs.changes.ui.ChangesListView.UNVERSIONED_FILE_PATHS_DATA_KEY` instead.
|
||||
|
||||
`com.intellij.openapi.vcs.VcsVFSListener.myAddedFiles` field removed
|
||||
: Use `com.intellij.openapi.vcs.VcsVFSListener.myProcessor.acquireAddedFiles()` instead.
|
||||
|
||||
`com.intellij.openapi.vcs.VcsVFSListener.myDeletedFiles` field removed
|
||||
: Use `com.intellij.openapi.vcs.VcsVFSListener.myProcessor.acquireAllDeletedFiles().deletedFiles` instead.
|
||||
|
||||
`com.intellij.openapi.vcs.VcsVFSListener.myDeletedWithoutConfirmFiles` field removed
|
||||
: Use `com.intellij.openapi.vcs.VcsVFSListener.myProcessor.acquireAllDeletedFiles().deletedWithoutConfirmFiles` instead.
|
||||
|
||||
`com.intellij.openapi.vcs.VcsVFSListener.myExceptions` field removed
|
||||
: Use `com.intellij.openapi.vcs.VcsVFSListener.myProcessor.acquireExceptions()` or `com.intellij.openapi.vcs.VcsVFSListener.myProcessor.addException(VcsException exception)` instead.
|
||||
|
||||
#### Test Framework
|
||||
`com.intellij.testFramework.PlatformTestUtil.registerExtension(ExtensionsArea, T, Disposable)` method removed
|
||||
: Use `com.intellij.testFramework.ServiceContainerUtil#registerExtension(BaseExtensionPointName, T, Disposable)` instead.
|
||||
|
||||
`com.intellij.testFramework.PlatformTestUtil.registerExtension(ExtensionsArea, BaseExtensionPointName, T, Disposable)` method removed
|
||||
: Use `com.intellij.testFramework.ServiceContainerUtil#registerExtension(BaseExtensionPointName, T, Disposable)` instead.
|
||||
|
||||
`com.intellij.testFramework.fixtures.DefaultLightProjectDescriptor.getModuleType()` method removed
|
||||
: Use `com.intellij.testFramework.fixtures.DefaultLightProjectDescriptor.getModuleTypeId()` instead (see `com.intellij.openapi.module.ModuleTypeId`).
|
||||
|
||||
### Java Plugin 2019.3
|
||||
|
||||
`com.intellij.codeInspection.magicConstant.MagicCompletionContributor.getAllowedValues(PsiElement)` method return type changed from `com.intellij.codeInspection.magicConstant.MagicConstantInspection.AllowedValues` to `com.intellij.codeInspection.magicConstant.MagicConstantUtils.AllowedValues`
|
||||
: Use new type instead.
|
||||
|
||||
### Groovy Plugin 2019.3
|
||||
|
||||
`org.jetbrains.plugins.groovy.extensions.GroovyScriptTypeDetector(GroovyScriptType, String[])` constructor removed
|
||||
: Use constructor `GroovyScriptTypeDetector(GroovyScriptType)` instead, and `com.intellij.fileType` to register additional extensions.
|
||||
|
||||
### Cucumber Plugin 2019.3
|
||||
|
||||
`org.jetbrains.plugins.cucumber.javascript.CucumberJavaScriptStepDefinitionCreator#createStepDefinition(GherkinStep, PsiFile)` method removed
|
||||
: Use `org.jetbrains.plugins.cucumber.javascript.CucumberJavaScriptStepDefinitionCreator#createStepDefinition(GherkinStep, PsiFile, boolean)` instead.
|
||||
|
||||
`org.jetbrains.plugins.cucumber.psi.GherkinStep#getStepName()` method removed
|
||||
: Use `org.jetbrains.plugins.cucumber.psi.GherkinStep#getName()` instead.
|
||||
|
||||
`org.jetbrains.plugins.cucumber.CucumberJvmExtensionPoint#resolveStep()` method removed
|
||||
: See `org.jetbrains.plugins.cucumber.steps.reference.CucumberStepReference#multiResolveInner()` instead.
|
||||
|
||||
`org.jetbrains.plugins.cucumber.CucumberJvmExtensionPoint#getGlues()` method removed
|
||||
: Java specific method was moved to CucumberJava implementation.
|
||||
|
||||
### DataGrip and Database Tools Plugin 2019.3
|
||||
|
||||
`com.intellij.sql.dialects.mssql.MssqlDialect` class renamed to `com.intellij.sql.dialects.mssql.MsDialect`
|
||||
: Do not use SQL dialect classes directly.
|
||||
|
||||
`com.intellij.sql.dialects.oracle.OracleDialect` class renamed to `com.intellij.sql.dialects.oracle.OraDialect`
|
||||
: Do not use SQL dialect classes directly.
|
||||
|
||||
`com.intellij.sql.dialects.postgres.PostgresDialect` class renamed to `com.intellij.sql.dialects.postgres.PgDialect`
|
||||
: Do not use SQL dialect classes directly.
|
||||
|
||||
### RubyMine and Ruby Plugin 2019.3
|
||||
|
||||
`org.jetbrains.plugins.ruby.ruby.codeInsight.types.RubyTypeProvider.createTypeBySymbolFromProviders(Symbol symbol, Context context)` method parameter `Context` removed
|
||||
: This was done as part of [`RUBY-24760`](https://youtrack.jetbrains.com/issue/RUBY-24760) in order to move to new Context-less approach.
|
||||
|
||||
### PyCharm and Python Plugin 2019.3
|
||||
|
||||
`com.jetbrains.python.inspections.PythonVisitorFilter` class moved to package `com.jetbrains.python.psi`
|
||||
|
||||
`com.jetbrains.python.psi.PyUtil.addElementToStatementList(PsiElement, PyStatementList, boolean)` method removed
|
||||
: Use `com.jetbrains.python.refactoring.PyRefactoringUtil.addElementToStatementList(PsiElement, PyStatementList, boolean)` instead
|
||||
|
||||
`com.jetbrains.python.psi.search.PyProjectScopeBuilder.excludeSdkTestsScope(Project)` method removed
|
||||
: Use `com.jetbrains.python.psi.search.PySearchUtilBase.excludeSdkTestsScope(Project)` instead.
|
||||
|
||||
`icons.PythonIcons.Python.PropertySetter` field removed
|
||||
: Use `icons.PythonPsiApiIcons.PropertySetter` instead.
|
||||
|
||||
`icons.PythonIcons.Python.PropertyGetter` field removed
|
||||
: Use `icons.PythonPsiApiIcons.PropertyGetter` instead.
|
||||
|
||||
`PARSE.expected.colon` property removed from resource bundle `com.jetbrains.python.PyBundle`
|
||||
: Use `com.jetbrains.python.PyPsiBundle` instead.
|
||||
|
||||
`PARSE.expected.expression` property removed from resource bundle `com.jetbrains.python.PyBundle`
|
||||
: Use `com.jetbrains.python.PyPsiBundle` instead.
|
||||
|
||||
## 2019.2
|
||||
|
||||
### IntelliJ Platform 2019.2
|
||||
Constructor injection referring to extension points not supported
|
||||
: Obtain reference to extension points via `(Project)ExtensionPointName.findExtension()` in your constructor instead.
|
||||
|
||||
`com.intellij.openapi.components.BaseState.map$default(BaseState, Map, int, Object)` method removed
|
||||
: Use `com.intellij.openapi.components.BaseState.map()` instead.
|
||||
|
||||
`org.nustaq` package removed
|
||||
: [fast-serialization](https://github.com/RuedigerMoeller/fast-serialization) library was removed, please use `com.intellij.serialization.ObjectSerializer` instead.
|
||||
|
||||
`java.org.java_websocket` package removed
|
||||
: [Java-WebSocket](https://github.com/TooTallNate/Java-WebSocket) library was removed, bundle it with your plugin instead.
|
||||
|
||||
`com.intellij.ui.layout.Cell.invoke$default(Cell, JComponent, CCFlags[], int, GrowPolicy, String, int, Object)` method parameter type changed
|
||||
: The signature of this function has been seriously changed without the possibility to keep the old function. Change invocations and overriding of that function according to new parameters and recompile the code.
|
||||
|
||||
`com.intellij.ui.layout.Row.label$default(Row, String, int, UIUtil.ComponentStyle, UIUtil.FontColor, boolean, int, Object)` method removed
|
||||
: This method has been pulled up to the base class `Cell`; since it has default parameters, it's a binary breaking change in Kotlin.
|
||||
Recompile your code to pick up the new signature.
|
||||
|
||||
`com.yourkit` package removed
|
||||
: YourKit library has been extracted into the separate plugin, which is not bundled in all IDEs by default. YourKit library is a library for profiling IDE, and its util classes shouldn't be used for general purposes. Instead of `com.yourkit.util.Strings` please use `org.apache.commons.lang.StringUtils`. Instead of `com.yourkit.util.ArrayUtil` please use `org.apache.commons.lang.ArrayUtils`.
|
||||
|
||||
`org.jetbrains.intellij.build.ProductProperties.yourkitAgentBinariesDirectoryPath` field removed
|
||||
: Please bundle [performanceTesting plugin](https://plugins.jetbrains.com/plugin/7819-performance-testing) in case you would like to bundle YourKit profiler within your IDE.
|
||||
|
||||
`org.jetbrains.intellij.build.ProductProperties.enableYourkitAgentInEAP` field removed
|
||||
: Please bundle [performanceTesting plugin](https://plugins.jetbrains.com/plugin/7819-performance-testing) in case you would like to bundle YourKit profiler within your IDE.
|
||||
|
||||
`com.intellij.extapi.psi.PsiElementBase` class removed
|
||||
: Please use `com.intellij.psi.impl.PsiElementBase` or one of its descendants as a base class for PSI elements, e.g. `com.intellij.extapi.psi.ASTWrapperPsiElement`, as suggested in [Custom Language Support Tutorial](grammar_and_parser.md).
|
||||
|
||||
`com.intellij.extapi.psi.MetadataPsiElementBase` class removed
|
||||
: Please use different base class for PSI elements.
|
||||
|
||||
`com.intellij.ide.actions.SearchAgainAction` class now extends `com.intellij.openapi.editor.actionSystem.EditorAction` and inherits its final method `actionPerformed`
|
||||
: Please use the <include from="snippets.topic" element-id="ep"><var name="ep" value="com.intellij.editorActionHandler"/></include> to register a different handler for the action.
|
||||
|
||||
`com.intellij.ide.actions.SearchBackAction` class now extends `com.intellij.openapi.editor.actionSystem.EditorAction` and inherits its final method `actionPerformed`
|
||||
: Please use the <include from="snippets.topic" element-id="ep"><var name="ep" value="com.intellij.editorActionHandler"/></include> to register a different handler for the action.
|
||||
|
||||
`com.intellij.lexer.RestartableLexer.getRestartableState()` method removed
|
||||
: Please use `com.intellij.lexer.RestartableLexer.isRestartableState(int state)` instead.
|
||||
|
||||
`com.intellij.lexer.RestartableLexer.isRestartableState(int state)` abstract method added
|
||||
: Implement method in `RestartableLexer` implementations.
|
||||
|
||||
`com.intellij.lexer.RestartableLexer.start(CharSequence buffer, int startOffset, int endOffset, int initialState, TokenIterator tokenIterator)` abstract method added
|
||||
: Implement method in `RestartableLexer` implementations.
|
||||
|
||||
## 2019.1
|
||||
|
||||
### IntelliJ Platform 2019.1
|
||||
|
||||
`kotlinx.coroutines.experimental` package removed
|
||||
: Bundled Kotlin library is updated to 1.3, so the plugins must [migrate](https://blog.jetbrains.com/kotlin/2018/09/kotlin-1-3-rc-is-here-migrate-your-coroutines/) to the stable versions of coroutines.
|
||||
|
||||
`com.intellij.openapi.vcs.impl.ProjectLevelVcsManagerImpl(Project, FileStatusManager, FileIndexFacade, ProjectManager, DefaultVcsRootPolicy, VcsFileListenerContextHelper)` constructor removed
|
||||
: Use `com.intellij.openapi.vcs.impl.ProjectLevelVcsManagerImpl.<init>(Project, FileStatusManager, FileIndexFacade, ProjectManager, DefaultVcsRootPolicy)`.
|
||||
|
||||
`com.intellij.injected.editor.DocumentWindow.injectedToHost(int, boolean)` abstract method added
|
||||
: Implement the method in `DocumentWindow` implementations.
|
||||
|
||||
`git4idea.rebase.GitCommitEditingAction.actionPerformed(AnActionEvent)` method marked final
|
||||
: Implement `actionPerformedAfterChecks` instead of `actionPerformed`.
|
||||
|
||||
`git4idea.rebase.GitCommitEditingAction.actionPerformedAfterChecks(AnActionEvent)` abstract method added
|
||||
: Implement `actionPerformedAfterChecks` instead of `actionPerformed`.
|
||||
|
||||
`com.intellij.util.lang.UrlClassLoader.loadPlatformLibrary` method removed
|
||||
: Use `com.intellij.util.loader.NativeLibraryLoader.loadPlatformLibrary` instead.
|
||||
|
||||
`com.intellij.openapi.util.KeyedExtensionCollector.getExtensions()` method marked final
|
||||
: Remove custom implementation.
|
||||
|
||||
### DataGrip and Database Tools Plugin 2019.1
|
||||
|
||||
`com.intellij.sql.psi.SqlTokens.SQL_IDENT` field type changed from `com.intellij.sql.psi.impl.SqlTokenType` to `com.intellij.sql.psi.SqlTokenType`
|
||||
: In most of the cases, it's enough to recompile the code. It may also be needed to check that the code doesn't rely on the field's type.
|
||||
|
||||
### Kotlin Plugin API 1.3
|
||||
|
||||
`org.jetbrains.kotlin.KtNodeTypes.BOOLEAN_CONSTANT` field type changed from `org.jetbrains.kotlin.KtNodeType` to `com.intellij.psi.tree.IElementType`
|
||||
: Field type has been generalized. In most of the cases, it's enough to recompile the code of the plugin.
|
||||
|
||||
`org.jetbrains.kotlin.KtNodeTypes.CHARACTER_CONSTANT` field type changed from `org.jetbrains.kotlin.KtNodeType` to `com.intellij.psi.tree.IElementType`
|
||||
: Field type has been generalized. In most of the cases, it's enough to recompile the code of the plugin.
|
||||
|
||||
`org.jetbrains.kotlin.KtNodeTypes.FLOAT_CONSTANT` field type changed from `org.jetbrains.kotlin.KtNodeType` to `com.intellij.psi.tree.IElementType`
|
||||
: Field type has been generalized. In most of the cases, it's enough to recompile the code of the plugin.
|
||||
|
||||
`org.jetbrains.kotlin.KtNodeTypes.INTEGER_CONSTANT` field type changed from `org.jetbrains.kotlin.KtNodeType` to `com.intellij.psi.tree.IElementType`
|
||||
: Field type has been generalized. In most of the cases, it's enough to recompile the code of the plugin.
|
||||
|
||||
`org.jetbrains.kotlin.KtNodeTypes.STRING_TEMPLATE` field type changed from `org.jetbrains.kotlin.KtNodeType` to `com.intellij.psi.tree.IElementType`
|
||||
: Field type has been generalized. In most of the cases, it's enough to recompile the code of the plugin.
|
||||
@ -17,9 +17,6 @@ The IDE typically determines the type of a file by looking at its filename or ex
|
||||
A custom language file type is a class derived from [`LanguageFileType`](%gh-ic%/platform/core-api/src/com/intellij/openapi/fileTypes/LanguageFileType.java), which passes a [`Language`](%gh-ic%/platform/core-api/src/com/intellij/lang/Language.java) subclass to its base class constructor.
|
||||
|
||||
### Registration
|
||||
<tabs>
|
||||
|
||||
<tab title="2019.2+">
|
||||
|
||||
Use <include from="snippets.topic" element-id="ep"><var name="ep" value="com.intellij.fileType"/></include> to register `LanguageFileType` implementation and instance via `implementationClass` and `fieldName` attributes.
|
||||
Also, `name` and `language` must be declared matching `FileType.getName()` and ID of language returned from `LanguageFileType.getLanguage()`, respectively.
|
||||
@ -33,20 +30,6 @@ To associate the file type in the IDE, specify one or more associations listed i
|
||||
| Filename pattern(s) | `patterns` | Semicolon-separated list of patterns (`*` and `?`) |
|
||||
| Hashbang _(2020.2+)_ | `hashBangs` | Semicolon-separated list of hash bang patterns |
|
||||
|
||||
</tab>
|
||||
|
||||
<tab title="Earlier versions">
|
||||
|
||||
> The `FileTypeFactory` approach is deprecated. Use it only when the plugin supports platform versions older than 2019.2.
|
||||
>
|
||||
{style="warning"}
|
||||
|
||||
To register a file type, the plugin developer provides a subclass of [`FileTypeFactory`](%gh-ic%/platform/ide-core/src/com/intellij/openapi/fileTypes/FileTypeFactory.java), which is registered via
|
||||
the <include from="snippets.topic" element-id="ep"><var name="ep" value="com.intellij.fileTypeFactory"/></include>.
|
||||
|
||||
</tab>
|
||||
</tabs>
|
||||
|
||||
**Examples**
|
||||
- [Custom Language Support Tutorial: Language and File Type](language_and_filetype.md)
|
||||
- [`LanguageFileType`](%gh-ic%/platform/core-api/src/com/intellij/openapi/fileTypes/LanguageFileType.java) subclass in [Properties language plugin](%gh-ic%/plugins/properties/properties-psi-api/src/com/intellij/lang/properties/PropertiesFileType.java)
|
||||
|
||||
@ -101,7 +101,7 @@ Depending on the version of the IntelliJ Platform, different steps are used to c
|
||||
|
||||
<tabs>
|
||||
|
||||
<tab title="2022.3 and later">
|
||||
<tab title="2022.3+">
|
||||
|
||||
Using the <include from="snippets.topic" element-id="ep"><var name="ep" value="com.intellij.defaultLiveTemplates"/></include> and <include from="snippets.topic" element-id="ep"><var name="ep" value="com.intellij.liveTemplateContext"/></include>, register the implementations with the IntelliJ Platform.
|
||||
The `file` attribute in <include from="snippets.topic" element-id="ep"><var name="ep" value="com.intellij.defaultLiveTemplates"/></include> specifies `path/filename` under the <path>src/main/resources</path> folder.
|
||||
@ -119,7 +119,7 @@ Specify required `contextId` attribute in <include from="snippets.topic" element
|
||||
|
||||
</tab>
|
||||
|
||||
<tab title="Versions since 2020.1 till 2022.3">
|
||||
<tab title="Earlier versions">
|
||||
|
||||
Using the <include from="snippets.topic" element-id="ep"><var name="ep" value="com.intellij.defaultLiveTemplates"/></include> and <include from="snippets.topic" element-id="ep"><var name="ep" value="com.intellij.liveTemplateContext"/></include>, register the implementations with the IntelliJ Platform.
|
||||
The `file` attribute in the <include from="snippets.topic" element-id="ep"><var name="ep" value="com.intellij.defaultLiveTemplates"/></include> specifies `path/filename` under the <path>src/main/resources</path> folder.
|
||||
@ -134,43 +134,6 @@ The `file` attribute in the <include from="snippets.topic" element-id="ep"><var
|
||||
|
||||
</tab>
|
||||
|
||||
<tab title="Versions 2019.3 and Earlier">
|
||||
|
||||
The `MarkdownTemplateProvider` implementing [`DefaultLiveTemplatesProvider`](%gh-ic%/platform/lang-impl/src/com/intellij/codeInsight/template/impl/DefaultLiveTemplatesProvider.java) tells the Platform where to find the Live Template settings file.
|
||||
Make sure to include the full path to the file, relative to the <path>src/main/resources</path> directory, excluding the file extension.
|
||||
|
||||
```java
|
||||
package org.intellij.sdk.liveTemplates;
|
||||
|
||||
import com.intellij.codeInsight.template.impl.DefaultLiveTemplatesProvider;
|
||||
import org.jetbrains.annotations.Nullable;
|
||||
|
||||
final class MarkdownTemplateProvider implements DefaultLiveTemplatesProvider {
|
||||
@Override
|
||||
public String[] getDefaultLiveTemplateFiles() {
|
||||
return new String[]{"liveTemplates/Markdown"};
|
||||
}
|
||||
|
||||
@Nullable
|
||||
@Override
|
||||
public String[] getHiddenLiveTemplateFiles() {
|
||||
return null;
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
Using the <include from="snippets.topic" element-id="ep"><var name="ep" value="com.intellij.defaultLiveTemplates"/></include> and <include from="snippets.topic" element-id="ep"><var name="ep" value="com.intellij.liveTemplateContext"/></include>, register the implementations with the IntelliJ Platform.
|
||||
|
||||
```xml
|
||||
<extensions defaultExtensionNs="com.intellij">
|
||||
<defaultLiveTemplatesProvider
|
||||
implementation="org.intellij.sdk.liveTemplates.MarkdownTemplateProvider"/>
|
||||
<liveTemplateContext
|
||||
implementation="org.intellij.sdk.liveTemplates.MarkdownContext"/>
|
||||
</extensions>
|
||||
```
|
||||
|
||||
</tab>
|
||||
</tabs>
|
||||
|
||||
## Check Plugin
|
||||
|
||||
@ -46,28 +46,22 @@ This procedure ensures that unused tool windows don't cause any overhead in star
|
||||
|
||||
#### Conditional Display
|
||||
|
||||
If the tool window of a plugin should not be displayed for all projects:
|
||||
If the tool window of a plugin should not be displayed for all projects, the plugin can provide a corresponding condition.
|
||||
|
||||
<tabs>
|
||||
|
||||
<tab title="2023.3 and later">
|
||||
<tab title="2023.3+">
|
||||
|
||||
Implement suspending `ToolWindowFactory.isApplicableAsync(Project)` in Kotlin.
|
||||
|
||||
</tab>
|
||||
|
||||
<tab title="2021.1 and later">
|
||||
<tab title="Earlier versions">
|
||||
|
||||
Implement `ToolWindowFactory.isApplicable(Project)`.
|
||||
|
||||
</tab>
|
||||
|
||||
<tab title="2019.3 and earlier">
|
||||
|
||||
Specify the `conditionClass` attribute in <path>plugin.xml</path> with a class implementing [`Condition<Project>`](%gh-ic%/platform/util/src/com/intellij/openapi/util/Condition.java) (can be the same class as the `ToolWindowFactory` implementation).
|
||||
|
||||
</tab>
|
||||
|
||||
</tabs>
|
||||
|
||||
> The condition is evaluated only once when the project is loaded.
|
||||
|
||||
Loading…
x
Reference in New Issue
Block a user