Dynamic Plugins
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.
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
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
totrue
Verify that IDE runs with VM parameter
-XX:+UnlockDiagnosticVMOptions
Open the
.hprof
snapshot generated on plugin unload, look for the plugin ID stringFind the
PluginClassLoader
referencing the plugin ID stringLook 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.