intellij-sdk-code-samples/dynamic_plugins.md at 4e802980f25ca0c23e63c8f8c05b07ec6d373b27

mirror of https://github.com/JetBrains/intellij-sdk-code-samples.git synced 2025-07-28 01:07:49 +08:00

Jakub Chrzanowski 4e802980f2

* [webhelp] Fixes for TXP00152, TXP00002, test build 27 Jul 22:26

* [webhelp] Fixes for Part #4 TXP00010, EXCEPT decimal numbers in section titles

* [webhelp] Fixes for Part #5 TXP00017

* [webhelp] Fixes for Part #4 TXP00010 - removed numbers from page section titles in "Custom Language Support Tutorial" and "Testing a Custom Language Plugin".

* [webhelp] Removed numbers from page section titles in rest of project *.md files.

* [new webhelp] Build #44 changes

* [new webhelp] Maintenance merge from master

* [new webhelp] Add placeholder file for webhelp import.

* [webhelp] Correct redirects for file name changes

* [webhelp] TOC not needed in webhelp

* [format] {:toc} not needed for webhelp

* add {:disable-links} to ensure demo links are not interpreted as real links.

* Put all badges on the same line to simplify composition.

* formatter.md: fix upsource link

* fix some links

* api_changes_list.md: remove note

* migrate to webhelp - initial

* fix GH edit URL

* remove sdkdocs-template setup in VCS config

* remove recently_updated.md

* restore COC/CONTRIBUTING.md

* api_changes_list.md: remove note

* useful_links.md: IPE

Co-authored-by: JohnHake <john.hake@jetbrains.com>
Co-authored-by: Yann Cébron <yann.cebron@jetbrains.com>

2021-01-14 16:07:39 +01:00

4.0 KiB

Raw Blame History

Starting with the 2020.1 release, installing, updating, and uninstalling plugins without restarting the IDE is available in the IntelliJ Platform. During plugin development, Auto-Reload also allows code changes to take effect immediately in the sandbox IDE instance.

If a plugin requires restart (e.g., due to using native libraries) specify require-restart="true" for <idea-plugin> root tag in plugin.xml.

{type="note"}

Restrictions

For a plugin to support this, all restrictions listed below must be met. To verify a plugin locally, run Analyze | Run Inspection by Name... | Plugin.xml dynamic plugin verification inspection on all plugin descriptor files.

For plugins hosted on the JetBrains Plugins Repository the built-in Plugin Verifier will run these checks automatically. See Plugin Verifier for more information on how to run it locally or on CI.

No Use of Components

No Components must be used; existing ones must be migrated to services, extensions, or listeners.

Action Group Requires ID

All <group>s must declare a unique id.

Use Only Dynamic Extensions

Whether defined in the platform itself or coming from other plugins, all extensions must be marked as dynamic (see next paragraph).

Some deprecated extension points (e.g., com.intellij.configurationProducer) are intentionally non-dynamic, and their usage should be migrated to the corresponding replacement.

Mark Extension Points as Dynamic

The plugin's extension points must adhere to specific usage rules and then be declared ready for dynamic use explicitly.

Configurables Depending on Extension Points

Any Configurable which depends on dynamic extension points must implement Configurable.WithEpDependencies.

No Use of Service Overrides

Application, project, and module services declared with overrides="true" are not allowed.

Code

Loading and unloading plugins happens in EDT and under write action.

{type="note"}

CachedValue

Loading/Unloading a plugin clears all cached values created using CachedValuesManager.

Do not Store PSI

Do not store references to PSI elements in objects which can survive plugin loading or unloading; use SmartPsiElementPointer instead.

Do not Use FileType/Language as Map Key

Replace with String from Language.getID()/FileType.getName().

Plugin Load/Unload Events

Register com.intellij.ide.plugins.DynamicPluginListener application listener to receive updates on plugin load/unload events.

This can be used to e.g., cancel long-running activities or disallow unload due to ongoing processes.

Troubleshooting

When a plugin is being uninstalled or updated, the IDE waits synchronously for plugin unload and asks for restart if the unload failed.

Logging

All events are tracked under com.intellij.ide.plugins.DynamicPlugins category in IDE log file.

Diagnosing Leaks

To find leaks preventing clean unload, perform the following steps:

Set registry key ide.plugins.snapshot.on.unload.fail to true
Verify that IDE runs with VM parameter -XX:+UnlockDiagnosticVMOptions
Open the .hprof snapshot generated on plugin unload, look for the plugin ID string
Find the PluginClassLoader referencing the plugin ID string
Look at references to the PluginClassLoader instance. Every one of them is a memory leak (or part of a memory leak) that needs to be resolved.

4.0 KiB Raw Blame History