Plugin Dependencies

您的插件可能依赖于其他插件的类,无论是捆绑,第三方还是您自己的插件. 为了表达这样的

依赖项(例如Kotlin),您需要执行以下步骤:

如果没有捆绑插件,请运行目标IDE的沙箱实例并在那里安装插件.
如果您使用Gradle和Kotlin构建脚本来构建插件,请在intellij块中使用setPlugins()[^ gradleplugin],例如:

intellij {
        setPlugins("org.jetbrains.kotlin:1.3.11-release-IJ2018.3-1")
}

If you’re using Gradle with a groovy build script to build your plugin, add the dependency to the plugins¹ parameter of the intellij block in your build.gradle, for example:

intellij {
    plugins 'org.jetbrains.kotlin:1.3.11-release-IJ2018.3-1'
}

如果您不使用Gradle，请将您所依赖的插件的jar添加到IntelliJ Platform SDK的类路径中 . 为此，打开“项目结构”对话框，选择您正在使用的SDK，按“类路径”选项卡中的+按钮，然后选择插件jar文件.
- 对于捆绑插件，插件jar文件位于主安装目录下的 plugins/<pluginname> or plugins/<pluginname>/lib中. .
- 如果您不确定要添加哪个jar，可以添加所有jar.对于非捆绑插件，插件jar文件位于IntelliJ Platform Plugin SDK设置中指定为“Sandbox Home”的目录下的config/plugins/<pluginname> or config/plugins/<pluginname>/lib中.

将插件添加到类路径

*在plugin.xml中添加一个<depends>标签,添加你所依赖的插件的ID作为标签的内容.

例如:

<depends>org.jetbrains.kotlin</depends>

要查找您所依赖的插件的ID,请在其jar中找到META-INF/plugin.xml文件并检查<id>标记的内容.

可选插件依赖项

您还可以指定可选的插件依赖项. 在这种情况下,即使您依赖的插件,您的插件也会加载

未安装或启用,但插件的部分功能将不可用. 为了做到这一点,

将optional =“true”config-file =“otherconfig.xml”添加到`标签中.

例如,如果您正在处理为Java和Kotlin文件添加额外突出显示的插件,则可以使用以下内容建立. 您的主plugin.xml将为Java定义一个注释器,并指定对Kotlin插件的可选依赖项:

<idea-plugin>
   ...
   <depends optional="true" config-file="withKotlin.xml">org.jetbrains.kotlin</depends>

   <extensions defaultExtensionNs="com.intellij">
      <annotator language="JAVA" implementationClass="com.example.MyJavaAnnotator"/>
   </extensions>
</idea-plugin>

然后,在与主plugin.xml文件相同的目录中创建一个名为withKotlin.xml的文件. 在那个文件中,你

为Kotlin定义一个注释器:

<idea-plugin>
   <extensions defaultExtensionNs="com.intellij">
      <annotator language="kotlin" implementationClass="com.example.MyKotlinAnnotator"/>
   </extensions>
</idea-plugin>

See the plugins attribute gradle-intellij-plugin: Configuration for acceptable values. ↩

Last modified: 11 May 2019