1、插件内的文件
2、插件类加载器
3、插件组件(component)
4、插件的扩展以及扩展点(Extensions、Extension Points)
5、插件的Action
6、插件的Service
7、插件配置文件结构
8、插件依赖
插件内的文件
有两种方式组织你的插件目录内的文件。
1、插件相关的 jar 文件放在插件根目录下
2、jar 文件放在 lib 文件夹下
如下:实际上,大部分都是插件目录下放个lib文件夹,把插件放到 lib 下。
我们通过 idea 的 build 菜单的 "prepare plugin moudle xxx for deployment" 生成的插件文件内,解压也是一个 lib 文件夹,里面放插件。
除此之外,plugin.xml 文件应该放在 META-INF 文件夹下保存。
插件类加载器
每一个插件都可以有一个独立的类加载器,这样的好处是,允许不同插件可以使用不同版本的库。
默认情况下,插件不会使用 IDE 的类加载器,所以 plugin.xml 中的 depends 的 <depends>com.intellij.modules.platform</depends> 如果不加上去,插件打包之后并不会生效。
你也可以使用 <depends> 元素来指定一个或多个当前插件所依赖的插件,这样一来,我们就可以在当前插件使用其他插件的类加载器,这样我们就可以引用其他插件里面定义的类。
插件组件
插件组件是插件集成的基础概念,有三种组件:
1、应用级组件(Application level components):IDE 启动的时候会创建和初始化。我们可以通过 Application 实例来获取这些组件。(通过 ApplicationManager获取Application实例,application.getComponent(Class))
2、项目级组件(Project level components):该类组件为每个 Project 实例创建。我们可以通个 Project 实例来获取这些组件。(通过 Project project = anActionEvent.getData(PlatformDataKeys.PROJECT); 获取 Project 实例,project.getComponent(Class))
3、模块级组件(Module level components):该类组件为每个 project 的 Moudule 创建。我们可以通过 Module 实例来获取这些组件。
我们插件定义的每一个组件(component) 应该在配置文件中配置相关的接口(可选)和实现类,如下:
<application-components> <component> <implementation-class>com.eleven24.HelloWorldRegistration</implementation-class> </component> </application-components>
配置的实现类将会被用于组件实例化。
两个相同级的组件不能有相同的接口类。
每个组件有一个唯一的名字用来作为外部标识或者内部需要,通过组件的 getComponentName() 返回:
public class HelloWorldRegistration implements ApplicationComponent { @NotNull public String getComponentName() { return "HelloWorldPlugin"; } }
组件命名
推荐使用 <plugin_name>.<component_name> 的方式命名。
应用级组件
一个应用级的组件实现类可以选择是否去实现 ApplicationComponent 接口。
一个没有任何依赖的组件应该有一个空参数的构造方法用以实例化。如果组件依赖其他组件,可以在构造方法参数中指定依赖的组件。IntelliJ Platform 会确保以正确的顺序来实例化组件,以保证我们组件可以正确实例化。
应用级组件必须在 plugin.xml 的 <application-components> 块中注册。
项目级组件
一个 Project 级的组件可以选择是否去实现 ProjectComponent 接口。
一个 project 级的组件如果需要 Project 实例,可以在该组件类的构造方法中指定一个 Project 类型的参数。同时如果依赖其他组件也可以指定其他 Application level 或者 Project level 的组件作为构造方法参数。
project 级组件必须在 plugin.xml 的 <project-components> 块中注册。
模块级组件
一个 Module 级的组件可以选择是否去实现 ModuleComponent 接口。
一个 Module 级组件可以在构造方法指定一个 Module 类型的参数。同时如果依赖其他组件,也可以指定 application level、projetc level 或 module level 组件作为参数。
module 级组件必须在 plugin.xml 的 <module-components> 块中注册。
组件状态的持久化
如果组件类实现了 JDOMExternalizable 或者 PersistentStateComponent 接口,组件的状态将会自动保存和加载。
当组件类实现了 PersistentStateComponent 接口,组件状态会保存在一个 xml 文件中,你可以通过 @State 和 @Storage 注解来指明当前的状态。
当组件实现了 JDOMExternalizable 接口,组件将会在下面的文件中保存它们的状态:
- project 级的组件的状态会保存在 .ipr 文件中,如果 plugin.xml 的 workspace 选项被设置为 true,将会被保存在 .iws 文件而不是 .ipr 文件中。
- module 级的组件状态将会保存在 .iml 文件中
更多信息可查看:Persisting State of Components
插件默认配置
定义在 <component_name>.xml 文件中,该文件需要放在 默认 package 的 classpath 下。
如果插件有默认配置,readExternal() 将会被调用两次:
1、第一次读取默认配置
2、第二次读取保存的配置
插件组件生命周期
组件按下面的顺序加载:
1、创建 - 构造方法被调用
2、初始化 - initComponent 方法被调用(前提是实现了 ApplicationComponent 接口)
3、配置 - readExternal 方法被调用(前提是实现了 JDOMExternalizable 接口),或者 loadState 被调用 (组件实现了 PersistentStateComponent 接口)
4、对于 module 组件, 如果一个模块被添加到 project, ModuleComponent 接口的 moduleAdded 方法将会被调用。
5、对于 project 组件,如果一个 project 被加载完, ProjectComponent 接口的 projectOpened 方法将会被调用。
组件按下面的顺序卸载:
1、保存配置 - writeExternal 被调用(如果该组件实现了 JDOMExternalizable 接口),getState 被调用(如果组件实现了 PersistentStateComponent 接口)
2、清理 - 组件的 disposeComponent 方法被调用
注意,不能在组件的构造方法中使用 getComponent() 方法去获取其他组件,如果你需要获取其他组件,可以将它们加到构造方法的参数中,或者在 initComponent 方法再进行此种操作。
todo: 添加例子