Use new syntax for a custom section ID definition

This commit is contained in:
Jakub Chrzanowski 2023-03-20 11:45:20 +01:00
parent c57140442c
commit 780ef50ef1
No known key found for this signature in database
GPG Key ID: C39095BFD769862E
6 changed files with 214 additions and 214 deletions

View File

@ -156,7 +156,7 @@ See [Using the configuration cache](https://docs.gradle.org/current/userguide/co
## Configuration
### IntelliJ Extension
{id="configuration-intellij-extension"}
{#configuration-intellij-extension}
After the Gradle IntelliJ Plugin is applied, the `intellij` extension can be used to configure the plugin and common settings of the provided tasks.
@ -192,7 +192,7 @@ intellij {
#### version
{id="intellij-extension-version"}
{#intellij-extension-version}
All available JetBrains IDEs versions can be found in the repositories described on the [](intellij_artifacts.md) page.
@ -218,7 +218,7 @@ Acceptable values
#### type
{id="intellij-extension-type"}
{#intellij-extension-type}
The type of the IntelliJ-based IDE distribution.
The type may also be specified as a prefix of the value for the [`intellij.version`](#intellij-extension-version) property instead.
@ -247,7 +247,7 @@ Acceptable values
To build against IDEs not supported directly by `type`, please see their corresponding page in _Part VIII — Product Specific_.
#### pluginName
{id="intellij-extension-pluginname"}
{#intellij-extension-pluginname}
The plugin name part used in the generated ZIP distribution: <path>build/distributions/PluginName-1.0.0.zip</path> and name of the plugin directory in the sandbox directory.
@ -260,7 +260,7 @@ Default value
#### localPath
{id="intellij-extension-localpath"}
{#intellij-extension-localpath}
The path to the locally installed IDE distribution that should be used to build the plugin.
Using the `intellij.localPath` allows to build the plugin using an IDE that is not available in [](intellij_artifacts.md).
@ -284,7 +284,7 @@ Samples
#### localSourcesPath
{id="intellij-extension-localsourcespath"}
{#intellij-extension-localsourcespath}
The path to local archive with IDE sources.
Used for resolving source files of the locally installed IDE distribution when [`intellij.localPath`](#intellij-extension-localpath) is specified.
@ -298,7 +298,7 @@ Default value
#### plugins
{id="intellij-extension-plugins"}
{#intellij-extension-plugins}
The list of bundled IDE plugins and plugins from [JetBrains Marketplace](https://plugins.jetbrains.com) or configured [`intellij.pluginsRepositories`](#intellij-extension-pluginsrepositories).
@ -330,7 +330,7 @@ Acceptable values
#### updateSinceUntilBuild
{id="intellij-extension-updatesinceuntilbuild"}
{#intellij-extension-updatesinceuntilbuild}
Enables patching <path>[plugin.xml](plugin_configuration_file.md)</path> with the values of [`patchPluginXml.sinceBuild`](#tasks-patchpluginxml-sincebuild) and [`patchPluginXml.untilBuild`](#tasks-patchpluginxml-untilbuild) properties.
@ -343,7 +343,7 @@ Default value
#### sameSinceUntilBuild
{id="intellij-extension-samesinceuntilbuild"}
{#intellij-extension-samesinceuntilbuild}
Enables patching <path>[plugin.xml](plugin_configuration_file.md)</path> with the [`patchPluginXml.untilBuild`](#tasks-patchpluginxml-untilbuild) using value of [`patchPluginXml.sinceBuild`](#tasks-patchpluginxml-sincebuild) with `*` wildcard, like `sinceBuild.*`, e.g., `221.*`.
@ -360,7 +360,7 @@ Default value
#### instrumentCode
{id="intellij-extension-instrumentcode"}
{#intellij-extension-instrumentcode}
Enables the instrumentation of Java classes with [nullability](https://www.jetbrains.com/help/idea/nullable-and-notnull-annotations.html) assertions and compilation of forms created by [IntelliJ GUI Designer](https://www.jetbrains.com/help/idea/gui-designer-basics.html).
@ -373,7 +373,7 @@ Default value
#### sandboxDir
{id="intellij-extension-sandboxdir"}
{#intellij-extension-sandboxdir}
The path of [sandbox directory](ide_development_instance.md#the-development-instance-sandbox-directory) that is used for running IDE with developed plugin.
@ -386,7 +386,7 @@ Default value
#### intellijRepository
{id="intellij-extension-intellijrepository"}
{#intellij-extension-intellijrepository}
The IntelliJ-based IDE distributions repository URL.
@ -399,7 +399,7 @@ Default value
#### pluginsRepositories
{id="intellij-extension-pluginsrepositories"}
{#intellij-extension-pluginsrepositories}
Configures repositories for downloading plugin dependencies.
See [Maven Interface](https://plugins.jetbrains.com/docs/marketplace/maven-interface.html) for details on Maven repository format.
@ -420,7 +420,7 @@ Acceptable values
#### jreRepository
{id="intellij-extension-jrerepository"}
{#intellij-extension-jrerepository}
URL of repository for downloading [JetBrains Runtime](ide_development_instance.md#using-a-jetbrains-runtime-for-the-development-instance).
@ -433,7 +433,7 @@ Default value
#### ideaDependencyCachePath
{id="intellij-extension-ideadependencycachepath"}
{#intellij-extension-ideadependencycachepath}
Path to the directory where IDE dependency cache is stored.
If not set, the dependency will be extracted next to the downloaded ZIP archive in [Gradle cache](https://docs.gradle.org/current/userguide/directory_layout.html#dir:gradle_user_home) directory.
@ -447,7 +447,7 @@ Default value
#### downloadSources
{id="intellij-extension-downloadsources"}
{#intellij-extension-downloadsources}
Enables downloading the IntelliJ Platform sources.
It is enabled by default if the `CI` environment variable is not set which is present on Continuous Integration environments, like GitHub Actions, TeamCity, and others.
@ -461,7 +461,7 @@ Default value
#### configureDefaultDependencies
{id="intellij-extension-configuredefaultdependencies"}
{#intellij-extension-configuredefaultdependencies}
Enables configuration of the default IntelliJ Platform dependencies in the current project.
Otherwise, the `DependenciesUtils.intellij()`, `DependenciesUtils.intellijPlugin()`, and `DependenciesUtils.intellijPlugins()` functions could be used for an explicit configuration.
@ -475,7 +475,7 @@ Default value
#### extraDependencies
{id="intellij-extension-extradependencies"}
{#intellij-extension-extradependencies}
Configures extra dependency artifacts from the IntelliJ repository.
The dependencies on them could be configured only explicitly using the `DependenciesUtils.intellijExtra()` function in the `dependencies` block.
@ -492,14 +492,14 @@ Default value
### buildPlugin
{id="tasks-buildplugin"}
{#tasks-buildplugin}
Assembles a plugin and prepares ZIP archive for [deployment](publishing_plugin.md).
`buildPlugin` task extends the [`Zip`](https://docs.gradle.org/current/dsl/org.gradle.api.tasks.bundling.Zip.html) Gradle task.
#### archiveBaseName
{id="tasks-buildplugin-archivebasename"}
{#tasks-buildplugin-archivebasename}
The base name of the ZIP archive.
@ -514,7 +514,7 @@ Default value
### buildSearchableOptions
{id="tasks-buildsearchableoptions"}
{#tasks-buildsearchableoptions}
Builds an index of UI components (searchable options) for the plugin.
This task runs a headless IDE instance to collect all the available options provided by the plugin's [](settings.md).
@ -527,7 +527,7 @@ Note, that this is a [`runIde`](#tasks-runide)-based task with predefined argume
#### outputDir
{id="tasks-buildsearchableoptions-outputdir"}
{#tasks-buildsearchableoptions-outputdir}
{style="narrow"}
Type
@ -538,14 +538,14 @@ Default value
### downloadRobotServerPlugin
{id="tasks-downloadrobotserverplugin"}
{#tasks-downloadrobotserverplugin}
Downloads `robot-server` plugin.
The `robot-server` plugin is required for running the UI tests using the [`runIdeForUiTests`](#tasks-runideforuitests) task.
#### version
{id="tasks-downloadrobotserverplugin-version"}
{#tasks-downloadrobotserverplugin-version}
The version of the Robot Server Plugin to download.
@ -558,7 +558,7 @@ Default value
#### pluginArchive
{id="tasks-downloadrobotserverplugin-pluginarchive"}
{#tasks-downloadrobotserverplugin-pluginarchive}
The Robot Server Plugin archive, downloaded by default to the [Gradle cache](https://docs.gradle.org/current/userguide/directory_layout.html#dir:gradle_user_home).
@ -571,7 +571,7 @@ Default value
#### outputDir
{id="tasks-downloadrobotserverplugin-outputdir"}
{#tasks-downloadrobotserverplugin-outputdir}
Location of the extracted archive.
@ -584,13 +584,13 @@ Default value
### instrumentCode
{id="tasks-instrumentcode"}
{#tasks-instrumentcode}
The following attributes help you to tune instrumenting behaviour in `instrumentCode { ... }` block.
#### compilerVersion
{id="tasks-instrumentcode-compilerversion"}
{#tasks-instrumentcode-compilerversion}
A version of instrumenting compiler.
It's used in cases when targeting non-IntelliJ IDEA IDEs (e.g. [CLion](clion.md) or [Rider](rider.md)).
@ -604,13 +604,13 @@ Default value
### jarSearchableOptions
{id="tasks-jarsearchableoptions"}
{#tasks-jarsearchableoptions}
Creates a JAR file with searchable options to be distributed with the plugin.
#### outputDir
{id="tasks-jarsearchableoptions-outputdir"}
{#tasks-jarsearchableoptions-outputdir}
The output directory where the JAR file will be created.
@ -623,7 +623,7 @@ Default value
#### pluginName
{id="tasks-jarsearchableoptions-pluginname"}
{#tasks-jarsearchableoptions-pluginname}
The name of the plugin.
@ -636,7 +636,7 @@ Default value
#### sandboxDir
{id="tasks-jarsearchableoptions-sandboxdir"}
{#tasks-jarsearchableoptions-sandboxdir}
The sandbox output directory.
@ -649,7 +649,7 @@ Default value
### listBundledPlugins
{id="tasks-listbundledplugins"}
{#tasks-listbundledplugins}
Lists all IDs of plugins bundled within the currently targeted IDE.
This can be used to determine Plugin ID for setting up [](plugin_dependencies.md).
@ -657,7 +657,7 @@ This can be used to determine Plugin ID for setting up [](plugin_dependencies.md
See also [](#tasks-printBundledPlugins).
#### ideDir
{id="tasks-listbundledplugins-idedir"}
{#tasks-listbundledplugins-idedir}
The IDE dependency sources path.
Configured automatically with the [`setupDependencies.idea`](#tasks-setupdependencies-idea) dependency.
@ -671,7 +671,7 @@ Default value
#### outputFile
{id="tasks-listbundledplugins-outputfile"}
{#tasks-listbundledplugins-outputfile}
Path to the file, where the output list will be stored.
@ -684,7 +684,7 @@ Default value
### listProductsReleases
{id="tasks-listproductsreleases"}
{#tasks-listproductsreleases}
List all available IntelliJ-based IDE releases with their updates.
The result list is used for testing the plugin with Plugin Verifier using the [`runPluginVerifier`](#tasks-runpluginverifier) task.
@ -700,7 +700,7 @@ The result list is stored within the [`listProductsReleases.outputFile`](#tasks-
See also [](#tasks-printproductsreleases).
#### updatesFile
{id="tasks-listproductsreleases-updatesfile"}
{#tasks-listproductsreleases-updatesfile}
Path to the products releases update file.
@ -713,7 +713,7 @@ Default value
#### types
{id="tasks-listproductsreleases-types"}
{#tasks-listproductsreleases-types}
List of types of IDEs that will be listed in results.
@ -726,7 +726,7 @@ Default value
#### sinceVersion
{id="tasks-listproductsreleases-sinceversion"}
{#tasks-listproductsreleases-sinceversion}
Lower boundary of the listed results in product marketing version format, e.g., `2020.2.1`.
It takes precedence over [`listProductsReleases.sinceBuild`](#tasks-listproductsreleases-sincebuild) property.
@ -740,7 +740,7 @@ Default value
#### untilVersion
{id="tasks-listproductsreleases-untilversion"}
{#tasks-listproductsreleases-untilversion}
Upper boundary of the listed results in product marketing version format, e.g., `2020.2.1`.
It takes precedence over [`listProductsReleases.untilBuild`](#tasks-listproductsreleases-untilbuild) property.
@ -754,7 +754,7 @@ Default value
#### sinceBuild
{id="tasks-listproductsreleases-sincebuild"}
{#tasks-listproductsreleases-sincebuild}
Lower boundary of the listed results in build number format, like `192`.
@ -767,7 +767,7 @@ Default value
#### untilBuild
{id="tasks-listproductsreleases-untilbuild"}
{#tasks-listproductsreleases-untilbuild}
Upper boundary of the listed results in build number format, like `192`.
@ -780,7 +780,7 @@ Default value
#### releaseChannels
{id="tasks-listproductsreleases-releasechannels"}
{#tasks-listproductsreleases-releasechannels}
Release channels that product updates will be filtered with.
@ -793,7 +793,7 @@ Default value
#### outputFile
{id="tasks-listproductsreleases-outputfile"}
{#tasks-listproductsreleases-outputfile}
Path to the file, where the output list will be stored.
@ -806,7 +806,7 @@ Default value
#### androidStudioUpdatePath
{id="tasks-listproductsreleases-androidstudioupdatepath"}
{#tasks-listproductsreleases-androidstudioupdatepath}
For [Android Studio releases](android_studio_releases_list.md), a separated storage for the updates is used.
@ -819,7 +819,7 @@ Default value
### patchPluginXml
{id="tasks-patchpluginxml"}
{#tasks-patchpluginxml}
Patches <path>[plugin.xml](plugin_configuration_file.md)</path> files with values provided to the task.
@ -828,7 +828,7 @@ Patches <path>[plugin.xml](plugin_configuration_file.md)</path> files with value
#### destinationDir
{id="tasks-patchpluginxml-destinationdir"}
{#tasks-patchpluginxml-destinationdir}
The directory where the patched <path>[plugin.xml](plugin_configuration_file.md)</path> will be written.
@ -841,7 +841,7 @@ Default value
#### pluginXmlFiles
{id="tasks-patchpluginxml-pluginxmlfiles"}
{#tasks-patchpluginxml-pluginxmlfiles}
The list of <path>[plugin.xml](plugin_configuration_file.md)</path> files to patch.
@ -854,7 +854,7 @@ Default value
#### pluginDescription
{id="tasks-patchpluginxml-plugindescription"}
{#tasks-patchpluginxml-plugindescription}
The description of the plugin used in the [`<description>`](plugin_configuration_file.md#idea-plugin__description) tag.
@ -867,7 +867,7 @@ Default value
#### sinceBuild
{id="tasks-patchpluginxml-sincebuild"}
{#tasks-patchpluginxml-sincebuild}
The lower bound of the [version range](build_number_ranges.md) to be patched used in the `since-build` attribute of the [`<idea-version>`](plugin_configuration_file.md#idea-plugin__idea-version) tag.
@ -880,7 +880,7 @@ Default value
#### untilBuild
{id="tasks-patchpluginxml-untilbuild"}
{#tasks-patchpluginxml-untilbuild}
The upper bound of the [version range](build_number_ranges.md) to be patched used in the `until-build` attribute of the [`<idea-version>`](plugin_configuration_file.md#idea-plugin__idea-version) tag.
@ -893,7 +893,7 @@ Default value
#### version
{id="tasks-patchpluginxml-version"}
{#tasks-patchpluginxml-version}
The version of the plugin used in the [`<version>`](plugin_configuration_file.md#idea-plugin__version) tag.
@ -906,7 +906,7 @@ Default value
#### changeNotes
{id="tasks-patchpluginxml-changenotes"}
{#tasks-patchpluginxml-changenotes}
The change notes of the plugin used in the [`<change-notes>`](plugin_configuration_file.md#idea-plugin__change-notes) tag.
@ -919,7 +919,7 @@ Default value
#### pluginId
{id="tasks-patchpluginxml-pluginid"}
{#tasks-patchpluginxml-pluginid}
The ID of the plugin used in the [`<id>`](plugin_configuration_file.md#idea-plugin__id) tag.
@ -932,13 +932,13 @@ Default value
### prepareSandbox
{id="tasks-preparesandbox"}
{#tasks-preparesandbox}
Prepares sandbox directory with installed plugin and its dependencies.
#### pluginName
{id="tasks-preparesandbox-pluginname"}
{#tasks-preparesandbox-pluginname}
The name of the plugin.
@ -951,7 +951,7 @@ Default value
#### configDir
{id="tasks-preparesandbox-configdir"}
{#tasks-preparesandbox-configdir}
The directory with the plugin configuration.
@ -964,7 +964,7 @@ Default value
#### pluginJar
{id="tasks-preparesandbox-pluginjar"}
{#tasks-preparesandbox-pluginjar}
The input plugin JAR file used to prepare the sandbox.
@ -977,7 +977,7 @@ Default value
#### librariesToIgnore
{id="tasks-preparesandbox-librariestoignore"}
{#tasks-preparesandbox-librariestoignore}
Libraries that will be ignored when preparing the sandbox.
By default, excludes all libraries that are a part of the [`setupDependenciesTask.idea`](#tasks-setupdependencies-idea) dependency.
@ -991,7 +991,7 @@ Default value
#### pluginDependencies
{id="tasks-preparesandbox-plugindependencies"}
{#tasks-preparesandbox-plugindependencies}
List of dependencies of the current plugin.
@ -1004,7 +1004,7 @@ Default value
### prepareTestingSandbox
{id="tasks-preparetestingsandbox"}
{#tasks-preparetestingsandbox}
Prepares sandbox directory with installed plugin and its dependencies for testing purposes.
@ -1012,7 +1012,7 @@ See [`prepareSandbox` Task](#tasks-preparesandbox).
### prepareUiTestingSandbox
{id="tasks-prepareuitestingsandbox"}
{#tasks-prepareuitestingsandbox}
Prepares sandbox directory with installed plugin and its dependencies for UI testing purposes.
@ -1020,31 +1020,31 @@ See [`prepareSandbox` Task](#tasks-preparesandbox).
### printProductsReleases
{id="tasks-printproductsreleases"}
{#tasks-printproductsreleases}
Prints the output produced by the [`listProductsReleases`](#tasks-listproductsreleases) task.
#### inputFile
{id="tasks-printproductsreleases-inputfile"}
{#tasks-printproductsreleases-inputfile}
Output file provided by the [`listProductsReleases`](#tasks-listproductsreleases) task.
### printBundledPlugins
{id="tasks-printBundledPlugins"}
{#tasks-printBundledPlugins}
Prints the output produced by the [`listBundledPlugins`](#tasks-listbundledplugins) task.
#### inputFile
{id="tasks-printBundledPlugins-inputfile"}
{#tasks-printBundledPlugins-inputfile}
Output file provided by the [`listBundledPlugins`](#tasks-listbundledplugins) task.
### publishPlugin
{id="tasks-publishplugin"}
{#tasks-publishplugin}
Publishes plugin to the remote [JetBrains Marketplace](https://plugins.jetbrains.com) repository.
@ -1057,7 +1057,7 @@ See [](publishing_plugin.md#publishing-plugin-with-gradle) tutorial for step-by-
#### token
{id="tasks-publishplugin-token"}
{#tasks-publishplugin-token}
Authentication token.
@ -1072,7 +1072,7 @@ Default value
#### channels
{id="tasks-publishplugin-channels"}
{#tasks-publishplugin-channels}
List of channel names to upload plugin to.
@ -1085,7 +1085,7 @@ Default value
#### host
{id="tasks-publishplugin-host"}
{#tasks-publishplugin-host}
URL host of a plugin repository.
@ -1098,7 +1098,7 @@ Default value
#### distributionFile
{id="tasks-publishplugin-distributionfile"}
{#tasks-publishplugin-distributionfile}
ZIP file of plugin to upload.
@ -1111,7 +1111,7 @@ Default value
#### toolboxEnterprise
{id="tasks-publishplugin-toolboxenterprise"}
{#tasks-publishplugin-toolboxenterprise}
Specifies if the Toolbox Enterprise plugin repository service should be used.
This feature is still in the incubating phase and is not yet available for public use.
@ -1125,14 +1125,14 @@ Default value
### runIde
{id="tasks-runide"}
{#tasks-runide}
Runs the IDE instance with the developed plugin installed.
`runIde` task extends the [`JavaExec`](https://docs.gradle.org/current/dsl/org.gradle.api.tasks.JavaExec.html) Gradle task all properties available in the `JavaExec` as well as the following ones can be used to configure the `runIde` task.
#### ideDir
{id="tasks-runide-idedir"}
{#tasks-runide-idedir}
The IDE dependency sources path.
Configured automatically with the [`setupDependencies.idea`](#tasks-setupdependencies-idea) dependency.
@ -1146,7 +1146,7 @@ Default value
#### jbrVersion
{id="tasks-runide-jbrversion"}
{#tasks-runide-jbrversion}
Custom JetBrains Runtime (JBR) version to use for running the IDE.
@ -1169,7 +1169,7 @@ Accepted values
#### jbrVariant
{id="tasks-runide-jbrvariant"}
{#tasks-runide-jbrvariant}
JetBrains Runtime (JBR) variant to use when running the IDE with the plugin.
@ -1182,7 +1182,7 @@ Default value
#### jbrArch
{id="tasks-runide-jbrarch"}
{#tasks-runide-jbrarch}
JetBrains Runtime architecture.
By default, it's resolved based on the current OS and JRE architecture.
@ -1196,7 +1196,7 @@ Default value
#### pluginsDir
{id="tasks-runide-pluginsdir"}
{#tasks-runide-pluginsdir}
Path to the `plugins` directory within the sandbox prepared with the [`prepareSandbox`](#tasks-preparesandbox) task.
Provided to the `idea.plugins.path` system property.
@ -1210,7 +1210,7 @@ Default value
#### autoReloadPlugins
{id="tasks-runide-autoreloadplugins"}
{#tasks-runide-autoreloadplugins}
Enables auto-reload of dynamic plugins.
Dynamic plugins will be reloaded automatically when their JARs are modified.
@ -1228,7 +1228,7 @@ Default value
### runIdeForUiTests
{id="tasks-runideforuitests"}
{#tasks-runideforuitests}
Runs the IDE instance with the developed plugin and robot-server installed and ready for UI testing.
@ -1238,7 +1238,7 @@ See [`runIde`](#tasks-runide) task for more details.
### runIdePerformanceTest
{id="tasks-runideperformancetest"}
{#tasks-runideperformancetest}
Runs performance tests on the IDE with the developed plugin installed.
@ -1248,7 +1248,7 @@ See [`runIde`](#tasks-runide) task for more details.
Currently, the task is under adaptation; more documentation will be added in the future.
#### testDataDir
{id="tasks-runideperformancetest-testdatadir"}
{#tasks-runideperformancetest-testdatadir}
Path to directory with test projects and <path>.ijperf</path> files.
@ -1261,7 +1261,7 @@ Default value
#### artifactsDir
{id="tasks-runideperformancetest-artifactsdir"}
{#tasks-runideperformancetest-artifactsdir}
Path to the directory where performance test artifacts (IDE logs, snapshots, screenshots, etc.) will be stored.
If the directory doesn't exist, it will be created.
@ -1275,7 +1275,7 @@ Default value
#### profilerName
{id="tasks-runideperformancetest-profilername"}
{#tasks-runideperformancetest-profilername}
Name of the profiler which will be used during execution.
@ -1293,7 +1293,7 @@ Acceptable values
### runPluginVerifier
{id="tasks-runpluginverifier"}
{#tasks-runpluginverifier}
Runs the [IntelliJ Plugin Verifier](https://github.com/JetBrains/intellij-plugin-verifier) tool to check the binary compatibility with specified IDE builds (see also [](verifying_plugin_compatibility.md)).
@ -1307,7 +1307,7 @@ Plugin Verifier DSL `runPluginVerifier { ... }` allows to define the list of IDE
#### ideVersions
{id="tasks-runpluginverifier-ideversions"}
{#tasks-runpluginverifier-ideversions}
IDEs to check, in [`intellij.version`](#intellij-extension-version) format, i.e.: `["IC-2019.3.5", "PS-2019.3.2"]`.
Check the available build versions on [IntelliJ Platform Builds list](https://jb.gg/intellij-platform-builds-list).
@ -1321,7 +1321,7 @@ Default value
#### verifierVersion
{id="tasks-runpluginverifier-verifierversion"}
{#tasks-runpluginverifier-verifierversion}
IntelliJ Plugin Verifier version.
Do not change unless absolutely required.
@ -1335,7 +1335,7 @@ Default value
#### verifierPath
{id="tasks-runpluginverifier-verifierpath"}
{#tasks-runpluginverifier-verifierpath}
Local path to the pre-downloaded IntelliJ Plugin Verifier JAR file.
If set, [`runPluginVerifier.verifierVersion`](#tasks-runpluginverifier-verifierversion) is ignored.
@ -1349,7 +1349,7 @@ Default value
#### localPaths
{id="tasks-runpluginverifier-localpaths"}
{#tasks-runpluginverifier-localpaths}
A list of the paths to locally installed IDE distributions that should be used for verification in addition to those specified in [`runPluginVerifier.ideVersions`](#tasks-runpluginverifier-ideversions).
@ -1362,7 +1362,7 @@ Default value
#### distributionFile
{id="tasks-runpluginverifier-distributionfile"}
{#tasks-runpluginverifier-distributionfile}
ZIP file of the plugin to verify.
If empty, the task will be skipped.
@ -1376,7 +1376,7 @@ Default value
#### failureLevel
{id="tasks-runpluginverifier-failurelevel"}
{#tasks-runpluginverifier-failurelevel}
Defines the verification level at which the task should fail if any reported issue matches.
Can be set as `FailureLevel` enum or `EnumSet<FailureLevel>`.
@ -1407,7 +1407,7 @@ Accepted values
#### verificationReportsDir
{id="tasks-runpluginverifier-verificationreportsdir"}
{#tasks-runpluginverifier-verificationreportsdir}
The path to the directory where verification reports will be saved.
@ -1420,7 +1420,7 @@ Default value
#### downloadDir
{id="tasks-runpluginverifier-downloaddir"}
{#tasks-runpluginverifier-downloaddir}
The path to the directory where IDEs used for the verification will be downloaded.
By default, it relies on the `plugin.verifier.home.dir` system property and falls back to `XDG_CACHE_HOME` environment variable see [XDG Base Directory](https://wiki.archlinux.org/title/XDG_Base_Directory) for more details.
@ -1434,7 +1434,7 @@ Default value
#### jbrVersion
{id="tasks-runpluginverifier-jbrversion"}
{#tasks-runpluginverifier-jbrversion}
Custom JetBrains Runtime (JBR) version to use for running the verification.
@ -1457,7 +1457,7 @@ Acceptable values
#### jbrVariant
{id="tasks-runpluginverifier-jbrvariant"}
{#tasks-runpluginverifier-jbrvariant}
JetBrains Runtime (JBR) variant to use when running the verification.
@ -1470,7 +1470,7 @@ Default value
#### jbrArch
{id="tasks-runpluginverifier-jbrarch"}
{#tasks-runpluginverifier-jbrarch}
JetBrains Runtime architecture.
By default, it's resolved based on the current OS and JRE architecture.
@ -1484,7 +1484,7 @@ Default value
#### runtimeDir
{id="tasks-runpluginverifier-runtimedir"}
{#tasks-runpluginverifier-runtimedir}
The path to directory containing JVM runtime, overrides [`runPluginVerifier.jbrVersion`](#tasks-runpluginverifier-jbrversion).
@ -1497,7 +1497,7 @@ Default value
#### externalPrefixes
{id="tasks-runpluginverifier-externalprefixes"}
{#tasks-runpluginverifier-externalprefixes}
The list of classes prefixes from the external libraries.
The Plugin Verifier will not report `No such class` for classes of these packages.
@ -1511,7 +1511,7 @@ Default value
#### teamCityOutputFormat
{id="tasks-runpluginverifier-teamcityoutputformat"}
{#tasks-runpluginverifier-teamcityoutputformat}
A flag that controls the output format - if set to `true`, the [TeamCity Tests Format](https://www.jetbrains.com/help/teamcity/service-messages.html) the TeamCity compatible output will be returned to stdout.
@ -1524,7 +1524,7 @@ Default value
#### subsystemsToCheck
{id="tasks-runpluginverifier-subsystemstocheck"}
{#tasks-runpluginverifier-subsystemstocheck}
Specifies which subsystems of IDE should be checked.
@ -1543,7 +1543,7 @@ Acceptable values
### setupDependencies
{id="tasks-setupdependencies"}
{#tasks-setupdependencies}
Setups required dependencies for building and running project.
This task is automatically added to the ["After Sync" Gradle trigger](https://www.jetbrains.com/help/idea/work-with-gradle-tasks.html#config_triggers_gradle) to make the IntelliJ SDK dependency available for IntelliJ IDEA right after the Gradle synchronization.
@ -1555,7 +1555,7 @@ This task is automatically added to the ["After Sync" Gradle trigger](https://ww
#### idea
{id="tasks-setupdependencies-idea"}
{#tasks-setupdependencies-idea}
This task exposes the `setupDependencies.idea` property which contains a reference to the resolved IDE dependency used for building the plugin.
@ -1563,7 +1563,7 @@ This property can be referred in Gradle configuration to access IDE dependency c
### signPlugin
{id="tasks-signplugin"}
{#tasks-signplugin}
Signs the ZIP archive with the provided key using [marketplace-zip-signer](https://github.com/JetBrains/marketplace-zip-signer) library.
@ -1574,7 +1574,7 @@ As soon as [`signPlugin.privateKey`](#tasks-signplugin-privatekey) (or [`signPlu
For more details, see [Plugin Signing](plugin_signing.md) article.
#### certificateChain
{id="tasks-signplugin-certificatechain"}
{#tasks-signplugin-certificatechain}
A string containing X509 certificates.
The first certificate from the chain will be used as a certificate authority (CA).
@ -1593,7 +1593,7 @@ Default value
#### certificateChainFile
{id="tasks-signplugin-certificatechainfile"}
{#tasks-signplugin-certificatechainfile}
A file containing X509 certificates.
The first certificate from the chain will be used as a certificate authority (CA).
@ -1608,7 +1608,7 @@ Default value
#### privateKey
{id="tasks-signplugin-privatekey"}
{#tasks-signplugin-privatekey}
Encoded private key in PEM format.
Refers to `key` CLI option.
@ -1626,7 +1626,7 @@ Default value
#### privateKeyFile
{id="tasks-signplugin-privatekeyfile"}
{#tasks-signplugin-privatekeyfile}
A file with encoded private key in PEM format.
Refers to `key-file` CLI option.
@ -1640,7 +1640,7 @@ Default value
#### password
{id="tasks-signplugin-password"}
{#tasks-signplugin-password}
Password required to decrypt the private key.
Refers to `key-pass` CLI option.
@ -1654,7 +1654,7 @@ Default value
#### cliVersion
{id="tasks-signplugin-cliversion"}
{#tasks-signplugin-cliversion}
Returns the version of [JetBrains Marketplace ZIP Signer CLI](https://github.com/JetBrains/marketplace-zip-signer) that will be used.
@ -1667,7 +1667,7 @@ Default value
#### cliPath
{id="tasks-signplugin-clipath"}
{#tasks-signplugin-clipath}
Path to [JetBrains Marketplace ZIP Signer CLI](https://github.com/JetBrains/marketplace-zip-signer) file.
Takes precedence over [`signPlugin.cliVersion`](#tasks-signplugin-cliversion).
@ -1681,7 +1681,7 @@ Default value
#### keyStore
{id="tasks-signplugin-keystore"}
{#tasks-signplugin-keystore}
KeyStore file path.
Refers to `ks` CLI option.
@ -1695,7 +1695,7 @@ Default value
#### keyStorePassword
{id="tasks-signplugin-keystorepassword"}
{#tasks-signplugin-keystorepassword}
KeyStore password.
@ -1708,7 +1708,7 @@ Default value
#### keyStoreKeyAlias
{id="tasks-signplugin-keystorekeyalias"}
{#tasks-signplugin-keystorekeyalias}
KeyStore key alias.
Refers to `ks-key-alias` CLI option.
@ -1722,7 +1722,7 @@ Default value
#### keyStoreType
{id="tasks-signplugin-keystoretype"}
{#tasks-signplugin-keystoretype}
KeyStore type.
@ -1735,7 +1735,7 @@ Default value
#### keyStoreProviderName
{id="tasks-signplugin-keystoreprovidername"}
{#tasks-signplugin-keystoreprovidername}
JCA KeyStore Provider name.
Refers to `ks-provider-name` CLI option.
@ -1749,7 +1749,7 @@ Default value
#### inputArchiveFile
{id="tasks-signplugin-inputarchivefile"}
{#tasks-signplugin-inputarchivefile}
Input, unsigned ZIP archive file.
Refers to `in` CLI option.
@ -1757,7 +1757,7 @@ Refers to `in` CLI option.
Provided by the [`buildPlugin`](#tasks-buildplugin) task.
#### outputArchiveFile
{id="tasks-signplugin-outputarchivefile"}
{#tasks-signplugin-outputarchivefile}
Output, signed ZIP archive file.
Refers to `out` CLI option.
@ -1770,13 +1770,13 @@ Type
### verifyPlugin
{id="tasks-verifyplugin"}
{#tasks-verifyplugin}
Validates completeness and contents of <path>[plugin.xml](plugin_configuration_file.md)</path> descriptors as well as plugin archive structure.
#### ignoreFailures
{id="tasks-verifyplugin-ignorefailures"}
{#tasks-verifyplugin-ignorefailures}
Specifies whether the build should fail when the verifications performed by this task fail.
@ -1789,7 +1789,7 @@ Default value
#### ignoreWarnings
{id="tasks-verifyplugin-ignorewarnings"}
{#tasks-verifyplugin-ignorewarnings}
Specifies whether the build should fail when the verifications performed by this task emit warnings.
@ -1802,7 +1802,7 @@ Default value
#### ignoreUnacceptableWarnings
{id="tasks-verifyplugin-ignoreunacceptablewarnings"}
{#tasks-verifyplugin-ignoreunacceptablewarnings}
Specifies whether the build should fail when the verifications performed by this task emit unacceptable warnings.
@ -1815,7 +1815,7 @@ Default value
#### pluginDir
{id="tasks-verifyplugin-plugindir"}
{#tasks-verifyplugin-plugindir}
The location of the built plugin file which will be used for verification.
@ -1828,7 +1828,7 @@ Default value
### verifyPluginConfiguration
{id="tasks-verifypluginconfiguration"}
{#tasks-verifypluginconfiguration}
Validates the plugin project configuration:

View File

@ -90,7 +90,7 @@ grammarKit {
#### grammarKitRelease
{id="grammar-kit-extension-grammarkitrelease"}
{#grammar-kit-extension-grammarkitrelease}
The release version of the [Grammar-Kit](https://github.com/JetBrains/Grammar-Kit) to use.
@ -103,7 +103,7 @@ Default value
#### jflexRelease
{id="grammar-kit-extension-jflexrelease"}
{#grammar-kit-extension-jflexrelease}
The version of the IntelliJ-patched JFlex, a [fork of JFlex](https://github.com/JetBrains/intellij-deps-jflex) lexer generator for IntelliJ Platform API.
@ -116,7 +116,7 @@ Default value
#### intellijRelease
{id="grammar-kit-extension-intellijrelease"}
{#grammar-kit-extension-intellijrelease}
An optional IntelliJ version to build the classpath for [`GenerateParser`](#generateparser-task) and [`GenerateLexer`](#generatelexer-task) tasks.
@ -133,14 +133,14 @@ Default value
## Tasks
### generateLexer
{id="generatelexer-task"}
{#generatelexer-task}
The `generateLexer` task generates a lexer for the given grammar.
The task is configured using common [`grammarKit`](#grammar-kit-extension) extension.
#### sourceFile
{id="tasks-generatelexer-source"}
{#tasks-generatelexer-source}
The source <path>.*flex</path> file to generate the lexer from.
@ -153,7 +153,7 @@ Type
#### targetDir
{id="tasks-generatelexer-targetdir"}
{#tasks-generatelexer-targetdir}
The path to the target directory for the generated lexer.
@ -166,7 +166,7 @@ Type
#### targetClass
{id="tasks-generatelexer-targetclass"}
{#tasks-generatelexer-targetclass}
The Java file name where the generated lexer will be written.
@ -179,7 +179,7 @@ Type
#### skeleton
{id="tasks-generatelexer-skeleton"}
{#tasks-generatelexer-skeleton}
An optional path to the skeleton file to use for the generated lexer.
The path will be provided as `--skel` option.
@ -194,7 +194,7 @@ Default
#### purgeOldFiles
{id="tasks-generatelexer-purgeoldfiles"}
{#tasks-generatelexer-purgeoldfiles}
Purge old files from the target directory before generating the lexer.
@ -207,14 +207,14 @@ Default
### generateParser
{id="generateparser-task"}
{#generateparser-task}
The `generateParser` task generates a parser for the given grammar.
The task is configured using common [`grammarKit`](#grammar-kit-extension) extension.
#### sourceFile
{id="tasks-generateparser-source"}
{#tasks-generateparser-source}
The source <path>.bnf</path> file to generate the parser from.
@ -227,7 +227,7 @@ Type
#### targetRoot
{id="tasks-generateparser-targetroot"}
{#tasks-generateparser-targetroot}
The path to the target directory for the generated parser.
@ -240,7 +240,7 @@ Default
#### pathToParser
{id="tasks-generateparser-pathtoparser"}
{#tasks-generateparser-pathtoparser}
The location of the generated parser class, relative to the [`targetRoot`](#tasks-generateparser-targetroot).
@ -253,7 +253,7 @@ Type
#### pathToPsiRoot
{id="tasks-generateparser-pathtopsiroot"}
{#tasks-generateparser-pathtopsiroot}
The location of the generated PSI files, relative to the [`targetRoot`](#tasks-generateparser-targetroot).
@ -266,7 +266,7 @@ Type
#### purgeOldFiles
{id="tasks-generateparser-purgeoldfiles"}
{#tasks-generateparser-purgeoldfiles}
Purge old files from the target directory before generating the parser.

View File

@ -84,7 +84,7 @@ Deprecated elements are omitted in the list above.
{style="note"}
## `idea-plugin`
{id="idea-plugin"}
{#idea-plugin}
The <path>plugin.xml</path> file root element.
@ -125,7 +125,7 @@ Children
- [`<project-components>`](#idea-plugin__project-components)
### `id`
{id="idea-plugin__id"}
{#idea-plugin__id}
A unique identifier of the plugin.
It should be a fully qualified name similar to Java packages and must not collide with the ID of existing plugins.
@ -149,7 +149,7 @@ Example
```
### `name`
{id="idea-plugin__name"}
{#idea-plugin__name}
The user-visible plugin display name (Title Case).
@ -166,7 +166,7 @@ Example
```
### `version`
{id="idea-plugin__version"}
{#idea-plugin__version}
The plugin version displayed in the <control>Plugins</control> settings dialog and in the JetBrains Marketplace plugin page.
Plugins uploaded to the JetBrains Marketplace must follow semantic versioning.
@ -185,7 +185,7 @@ Example
```
### `product-descriptor`
{id="idea-plugin__product-descriptor"}
{#idea-plugin__product-descriptor}
[Paid](https://plugins.jetbrains.com/build-and-market) or [Freemium](https://plugins.jetbrains.com/docs/marketplace/freemium.html) plugin descriptor.
@ -210,7 +210,7 @@ Attributes
Default value: `false`.
### `idea-version`
{id="idea-plugin__idea-version"}
{#idea-plugin__idea-version}
The plugin's range of compatible IntelliJ-based IDE versions.
@ -242,7 +242,7 @@ Examples
```
### `vendor`
{id="idea-plugin__vendor"}
{#idea-plugin__vendor}
The vendor name or organization ID (if created) in the <control>Plugins</control> settings dialog and in the JetBrains Marketplace plugin page.
@ -276,7 +276,7 @@ Examples
```
### `description`
{id="idea-plugin__description"}
{#idea-plugin__description}
The plugin description displayed on the JetBrains Marketplace plugin page and in the <control>Plugins</control> settings dialog.
@ -305,7 +305,7 @@ Example
```
### `change-notes`
{id="idea-plugin__change-notes"}
{#idea-plugin__change-notes}
A short summary of new features, bugfixes, and changes provided with the latest plugin version.
Change notes are displayed on the JetBrains Marketplace plugin page and in the <control>Plugins</control> settings dialog.
@ -338,7 +338,7 @@ Example
### `depends`
{id="idea-plugin__depends"}
{#idea-plugin__depends}
Specifies a dependency on another plugin or a module of an IntelliJ Platform-based product.
A single [`<idea-plugin>`](#idea-plugin) element can contain multiple `<depends>` elements.
@ -394,7 +394,7 @@ Examples
```
### `incompatible-with`
{id="idea-plugin__incompatible-with"}
{#idea-plugin__incompatible-with}
_Supported since 2020.2_
Declares incompatibility with a provided module.
@ -414,7 +414,7 @@ Example
```
### `resource-bundle`
{id="idea-plugin__resource-bundle"}
{#idea-plugin__resource-bundle}
A resource bundle to be used with message key attributes in extension declarations and for [action and group localization](basic_action_system.md#localizing-actions-and-groups).
A single [`<idea-plugin>`](#idea-plugin) element can contain multiple `<resource-bundle>` elements.
@ -430,7 +430,7 @@ Example
```
### `applicationListeners`
{id="idea-plugin__applicationListeners"}
{#idea-plugin__applicationListeners}
Defines the application-level listeners.
@ -444,7 +444,7 @@ Children
: [`<listener>`](#idea-plugin__listeners__listener)
### `projectListeners`
{id="idea-plugin__projectListeners"}
{#idea-plugin__projectListeners}
Defines the project-level listeners.
@ -458,7 +458,7 @@ Children
: [`<listener>`](#idea-plugin__listeners__listener)
#### `listener`
{id="idea-plugin__listeners__listener"}
{#idea-plugin__listeners__listener}
Defines a single application or project-level listener.
A single [`<applicationListeners>`](#idea-plugin__applicationListeners) or [`<projectListeners>`](#idea-plugin__projectListeners) can contain multiple `<listener>` elements.
@ -501,7 +501,7 @@ Example
```
### `actions`
{id="idea-plugin__actions"}
{#idea-plugin__actions}
Defines the plugin actions.
@ -535,7 +535,7 @@ Example
```
#### `action`
{id="idea-plugin__actions__action"}
{#idea-plugin__actions__action}
A single action entry of the [`<actions>`](#idea-plugin__actions) implemented by the plugin.
A single [`<actions>`](#idea-plugin__actions) element can contain multiple `<action>` elements.
@ -595,7 +595,7 @@ Examples
```
##### `add-to-group`
{id="idea-plugin__actions__action__add-to-group"}
{#idea-plugin__actions__action__add-to-group}
Specifies that the action should be added to an existing group.
A single action can be added to multiple groups.
@ -629,7 +629,7 @@ Example
```
##### `keyboard-shortcut`
{id="idea-plugin__actions__action__keyboard-shortcut"}
{#idea-plugin__actions__action__keyboard-shortcut}
Specifies the keyboard shortcut for the action.
A single action can have several keyboard shortcuts.
@ -680,7 +680,7 @@ Examples
```
##### `mouse-shortcut`
{id="idea-plugin__actions__action__mouse-shortcut"}
{#idea-plugin__actions__action__mouse-shortcut}
Specifies the mouse shortcut for the action.
A single action can have several mouse shortcuts.
@ -729,7 +729,7 @@ Examples
```
##### `override-text`
{id="idea-plugin__actions__action__override-text"}
{#idea-plugin__actions__action__override-text}
Defines an alternate version of the text for the menu action or group.
@ -767,7 +767,7 @@ Examples
```
##### `abbreviation`
{id="idea-plugin__actions__action__abbreviation"}
{#idea-plugin__actions__action__abbreviation}
Defines an alias for the action name which the user can use in <ui-path>Help | Find Action...</ui-path> or <ui-path>Navigate | Search Everywhere</ui-path> popups.
A single action can have multiple abbreviations.
@ -787,7 +787,7 @@ Example
```
##### `synonym`
{id="idea-plugin__actions__action__synonym"}
{#idea-plugin__actions__action__synonym}
Defines an alternative name for searching the action by name.
A single action can have multiple synonyms.
@ -810,7 +810,7 @@ Example
```
#### `group`
{id="idea-plugin__actions__group"}
{#idea-plugin__actions__group}
Defines an action group.
The `<action>`, `<group>` and `<separator>` elements defined inside the group are automatically included in it.
@ -888,7 +888,7 @@ Examples
```
#### `reference`
{id="idea-plugin__actions__reference"}
{#idea-plugin__actions__reference}
Allows adding an existing action to the group.
The element can be used directly under the [`<actions>`](#idea-plugin__actions) element, or in the [`<group>`](#idea-plugin__actions__group) element.
@ -923,7 +923,7 @@ Examples
```
#### `separator`
{id="idea-plugin__actions__separator"}
{#idea-plugin__actions__separator}
Defines a separator between actions in a group.
The element can be used directly under the [`<actions>`](#idea-plugin__actions) element with the child [`<add-to-group>`](#idea-plugin__actions__action__add-to-group) element defining the target group, or in the [`<group>`](#idea-plugin__actions__group) element.
@ -975,7 +975,7 @@ Examples
```
### `extensions`
{id="idea-plugin__extensions"}
{#idea-plugin__extensions}
Defines the plugin extensions.
@ -1012,7 +1012,7 @@ Example
```
### `extensionPoints`
{id="idea-plugin__extensionPoints"}
{#idea-plugin__extensionPoints}
Extension points defined by the plugin.
@ -1026,7 +1026,7 @@ Children
: [`<extensionPoint>`](#idea-plugin__extensionPoints__extensionPoint)
#### `extensionPoint`
{id="idea-plugin__extensionPoints__extensionPoint"}
{#idea-plugin__extensionPoints__extensionPoint}
A single extension point entry of the [`<extensionPoints>`](#idea-plugin__extensionPoints) defined by the plugin.
A single [`<extensionPoints>`](#idea-plugin__extensionPoints) element can contain multiple `<extensionPoint>` elements.
@ -1071,7 +1071,7 @@ Children
: [`<with>`](#idea-plugin__extensionPoints__extensionPoint__with)
##### `with`
{id="idea-plugin__extensionPoints__extensionPoint__with"}
{#idea-plugin__extensionPoints__extensionPoint__with}
Specifies the required parent type for class names provided in extension point tags or attributes.
A single [`<extensionPoint>`](#idea-plugin__extensionPoints__extensionPoint) element can contain multiple `<with>` elements.
@ -1121,7 +1121,7 @@ An extension point which restricts the type provided in a `myClass` attribute to
{collapsible="true" initial-collapse-state="collapsed"}
### `application-components`
{id="idea-plugin__application-components"}
{#idea-plugin__application-components}
> Element is deprecated. Do not use it in new plugins.
>
@ -1137,7 +1137,7 @@ Children
: [`<component>`](#idea-plugin__components__component)
### `project-components`
{id="idea-plugin__project-components"}
{#idea-plugin__project-components}
> Element is deprecated. Do not use it in new plugins.
>
@ -1153,7 +1153,7 @@ Children
: [`<component>`](#idea-plugin__components__component)
### `module-components`
{id="idea-plugin__module-components"}
{#idea-plugin__module-components}
> Element is deprecated. Do not use it in new plugins.
>
@ -1169,7 +1169,7 @@ Children
: [`<component>`](#idea-plugin__components__component)
#### `component`
{id="idea-plugin__components__component"}
{#idea-plugin__components__component}
> Element is deprecated. Do not use it in new plugins.
>
@ -1191,7 +1191,7 @@ Children
- [`<option>`](#idea-plugin__components__component__option)
##### `implementation-class`
{id="idea-plugin__components__component__implementation-class"}
{#idea-plugin__components__component__implementation-class}
> Element is deprecated. Do not use it in new plugins.
>
@ -1204,7 +1204,7 @@ Required
: **yes**
##### `interface-class`
{id="idea-plugin__components__component__interface-class"}
{#idea-plugin__components__component__interface-class}
> Element is deprecated. Do not use it in new plugins.
>
@ -1217,7 +1217,7 @@ Required
: no
##### `headless-implementation-class`
{id="idea-plugin__components__component__headless-implementation-class"}
{#idea-plugin__components__component__headless-implementation-class}
> Element is deprecated. Do not use it in new plugins.
>
@ -1230,7 +1230,7 @@ Required
: no
##### `option`
{id="idea-plugin__components__component__option"}
{#idea-plugin__components__component__option}
> Element is deprecated. Do not use it in new plugins.
>
@ -1251,7 +1251,7 @@ Attributes
Option value.
##### `loadForDefaultProject`
{id="idea-plugin__components__component__loadForDefaultProject"}
{#idea-plugin__components__component__loadForDefaultProject}
> Element is deprecated. Do not use it in new plugins.
>

View File

@ -13,7 +13,7 @@ See [GitHub Changelog](https://github.com/JetBrains/intellij-sdk-docs/commits/ma
## 2023
### February
{id="february-23"}
{#february-23}
Inspection Options
: Add a section on [](inspection_options.md), which allows extending inspection behavior based on the input provided by user at runtime.
@ -24,7 +24,7 @@ Minor Changes and Additions
- Document [](spell_checking.md#runtimedictionaryprovider) EP for spellchecking.
### January
{id="january-23"}
{#january-23}
Minor Changes and Additions
:
@ -34,7 +34,7 @@ Minor Changes and Additions
## 2022
### December
{id="december-22"}
{#december-22}
Intention Preview
: Add information about how to prepare intentions to show [](code_intentions_preview.md).
@ -44,7 +44,7 @@ Minor Changes and Additions
- Add information for new [](kotlin_ui_dsl_version_2.md#cell-align) methods in Kotlin UI DSL Version 2.
### November
{id="november-22"}
{#november-22}
Plugin User Experience
: Add a new section about how to improve [plugin UX](plugin_user_experience.md) and overall plugin quality.
@ -54,14 +54,14 @@ Minor Changes and Additions
- Add information about threading in Actions in [](basic_action_system.md#principal-implementation-overrides).
### October
{id="october-22"}
{#october-22}
Minor Changes and Additions
:
- Add information about [sharing settings](persisting_state_of_components.md#sharing-settings-between-ide-installations) between different IDEs installations.
### September
{id="september-22"}
{#september-22}
Extract Part X — Themes
:
@ -79,7 +79,7 @@ Minor Changes and Additions
- Language injections: controlling [](language_injection.md#formatting)
### August
{id="august-22"}
{#august-22}
Plugin Configuration Page
: Update the [](plugin_configuration_file.md) page to describe all the elements in detail.
@ -88,7 +88,7 @@ Source links migrated from Upsource to GitHub
: All source links now point to GitHub instead of Upsource (which is going to be [sunset](https://blog.jetbrains.com/upsource/2022/01/31/upsource-end-of-sales-announcement/)).
### July
{id="july-22"}
{#july-22}
Status Bar Widgets
: Add section [](status_bar_widgets.md) describing how to implement your own status bar widgets.
@ -98,7 +98,7 @@ Minor Changes and Additions
- Add overview of [](basic_action_system.md#useful-action-base-classes).
### June
{id="june-22"}
{#june-22}
PHP Type Providers
: Add section [](php_open_api_php_type_providers.md) about type providers describing type inference in PhpStorm and how to implement your own type provider.
@ -120,7 +120,7 @@ Minor Changes and Additions
- Moved [](tools_gradle_grammar_kit_plugin.md) documentation to _Appendix III — Tooling_
### May
{id="may-22"}
{#may-22}
Navigation Bar
: Add [](navbar.md) section with an [accompanying tutorial](structure_aware_navbar.md) showing how to implement a navigation bar for a custom language.
@ -136,13 +136,13 @@ Minor Changes and Additions
- Add [](rename_refactoring.md) paragraphs mentioning `RenameInputValidator(Ex)`.
### April
{id="april-22"}
{#april-22}
Internal API Migration
: As API annotated with `ApiStatus.@Internal` should not be used in plugins, refer to [](api_internal.md) for a list corresponding API replacements and additional information.
### March
{id="march-22"}
{#march-22}
Code Samples Build Scripts Migrated to Kotlin
: All [](code_samples.md) now use Kotlin DSL in their Gradle build scripts.
@ -154,7 +154,7 @@ Alternatives to Implementing a Plugin
: Add [](plugin_alternatives.md) section describing alternative approaches to extending IDE functionality without actual plugin development.
### February
{id="february-22"}
{#february-22}
Parameter Info
: Add [](parameter_info.md) section explaining how information about function parameters can be shown in the editor.
@ -163,7 +163,7 @@ File and Code Templates
: Add [](file_and_code_templates.md) section explaining how to implement functionality that allows generating files and code fragments containing repetitive text and patterns.
### January
{id="january-22"}
{#january-22}
Highlighting
: Add [](syntax_errors.md) and [](controlling_highlighting.md) sections explaining syntax highlighting basics and filtering highlighting information.
@ -174,20 +174,20 @@ IDE Infrastructure
## 2021
### December
{id="december-21"}
{#december-21}
Trusted Project
: Potentially unsafe features must be guarded using [Trusted Project API](trusted_projects.md).
### November
{id="november-21"}
{#november-21}
Language Injection
: Add [](language_injection.md) section that shows how the IntelliJ Platform handles different languages within the same source file.
### September
{id="september-21"}
{#september-21}
IDE Infrastructure
: [](ide_infrastructure.md) handles Logging, Error Reporting, Runtime Information, and how to provide Context Help.
@ -196,13 +196,13 @@ Extension Point Lists: Listeners, Deprecation status
: [](extension_point_list.md) now contains sections listing all provided [Listener](plugin_listeners.md) Topics. See also corresponding Extension Point Lists under _Part VIII — Product Specific_. Also, all deprecated API now has a dedicated tag.
### July
{id="july-21"}
{#july-21}
Plugin Signing
: [](plugin_signing.md) describes the plugin signing process, explains how to generate a certificate, configure the Gradle [`signPlugin`](tools_gradle_intellij_plugin.md#tasks-signplugin) task, and introduces a standalone CLI tool.
### June
{id="june-21"}
{#june-21}
Testing FAQ
: [](testing_faq.md) page lists common issues, useful classes, and techniques for writing and maintaining tests.
@ -211,7 +211,7 @@ Documentation Provider
: Add [](documentation.md) section with an [accompanying tutorial](documentation_provider.md) that show how to implement a `DocumentationProvider` for custom languages.
### May
{id="may-21"}
{#may-21}
IDE specific Extension Point Lists
: See _Part VIII — Product Specific_.
@ -220,7 +220,7 @@ New Guide - Explore the IntelliJ Platform API
: Add a new section [](explore_api.md) that describes how plugin authors work with the IntelliJ Platform API and what tools they use.
### March
{id="march-21"}
{#march-21}
Element Patterns
: Add a new section about [Element Patterns](element_patterns.md) that are used when implementing [Completion Contributors](completion_contributor.md) or [PSI Reference Contributors](psi_references.md#contributed-references).
@ -237,25 +237,25 @@ Unified AST
## 2020
### December
{id="december-20"}
{#december-20}
IntelliJ Platform Explorer
: Explore usages of [Extension Points](extension_point_list.md) in open-source plugins using [IntelliJ Platform Explorer](https://jb.gg/ipe).
### November
{id="november-20"}
{#november-20}
Extension Point List
: All EPs [available in IJ Platform and Android](extension_point_list.md) can now be browsed conveniently.
### August
{id="august-20"}
{#august-20}
README added to Code Samples
: All code samples used in this guide now come with <path>README</path>, making it easier to browse them. They can be conveniently accessed via a [separate GitHub repository](https://github.com/JetBrains/intellij-sdk-code-samples).
### June-20
{id="june-20"}
{#june-20}
Dynamic Plugins update
: Added new sections _Code_ and _Troubleshooting_ to [Dynamic Plugins](dynamic_plugins.md).
@ -267,7 +267,7 @@ Disposer & Disposable
: Added [reference](disposers.md) discussing resource cleanup/management.
### May
{id="may-20"}
{#may-20}
Settings (Preferences)
: Added [guide](settings_guide.md) and [tutorial](settings_tutorial.md) on integrating with IDE Settings dialog.
@ -276,19 +276,19 @@ UI Inspector
: Inspect Swing components and associated data (like `AnAction` for menu item) using [UI Inspector](internal_ui_inspector.md).
### March
{id="march-20"}
{#march-20}
JCEF Support
: Allows [embedding](jcef.md) Chromium-based browser in the IDE.
### February
{id="february-20"}
{#february-20}
All Code Samples converted to Gradle
: [All samples](https://github.com/JetBrains/intellij-sdk-docs/tree/main/code_samples) now use the [recommended solution](creating_plugin_project.md) of setting up plugin projects.
### January
{id="january-20"}
{#january-20}
Custom Language Support Tutorial converted to Gradle
: The [corresponding tutorial](custom_language_support_tutorial.md) and [Testing a Custom Language Plugin](writing_tests_for_plugins.md) have been updated and enhanced as well.
@ -299,7 +299,7 @@ Targeting specific IDEs
## 2019
### December
{id="december-19"}
{#december-19}
Dynamic Plugins support
: Added starting point [Dynamic Plugins](dynamic_plugins.md) for migrating plugins (IntelliJ Platform 2020.1 and later).
@ -308,19 +308,19 @@ Plugin Components migration
: Components being a legacy feature, the [updated page](plugin_components.md) describes migrating them to modern replacement API.
### October
{id="october-19"}
{#october-19}
Part X — Plugin Repository moved
: All contents have been moved to [JetBrains Marketplace Documentation](https://plugins.jetbrains.com/docs/marketplace/).
### July
{id="july-19"}
{#july-19}
New page: Optimizing Performance
: Optimizing performance when [working with PSI](psi_performance.md), [during indexing](indexing_and_psi_stubs.md#improving-indexing-performance), and [](general_threading_rules.md#avoiding-ui-freezes).
### May
{id="may-19"}
{#may-19}
New Page: Kotlin UI DSL
: [Describes preferred way](kotlin_ui_dsl.md) of building UI/dialogs for IntelliJ Platform 2019.2 and later.

View File

@ -125,11 +125,11 @@ In some cases (e.g., the same heading text appears multiple times on the same pa
```
## Task 1
### Properties
{id="task1-properties"}
{#task1-properties}
[...]
## Task 2
### Properties
{id="task2-properties"}
{#task2-properties}
[...]
```

View File

@ -278,7 +278,7 @@ Standard components should not be created directly but with factory methods from
`JComponent` that occupies the cell.
### Cell.horizontalAlign/verticalAlign
{id="cell-horizontalVerticalAlign"}
{#cell-horizontalVerticalAlign}
> Deprecated in 2022.3, use [](#cell-align) instead.
@ -292,7 +292,7 @@ row("Row:") {
```
### Cell.align
{id="cell-align"}
{#cell-align}
_2022.3_