前言

以IntelliJ IDEA为例,通常我们调试maven项目时,都是直接点击调试按钮即可。但maven编写的插件就不同了,由于插件需要打包成Jar加载到项目中,所以如果我们需要在编写插件源码时调试的话,就不能直接点击调试按钮了(因为没有Main类),那么该怎么办呢?

解决方案一(直接在插件项目中调试)

假设及正在编写的maven插件拥有如下坐标:



<groupId>myPluginGroupId</groupId>
<artifactId>myPluginArtifactId</artifactId>
<version>myPluginVersion</version>



再假设你想将这个插件用在某个项目中,而项目中的pom.xml是这样定义这个插件的:



<plugin>
    <groupId>myPluginGroupId</groupId>
    <artifactId>myPluginArtifactId</artifactId>
    <version>myPluginVersion</version>
      <executions>
               <execution>
                     <id>myPluginGoal</id>
                     <phase>compile</phase>
                     <goals>
                          <goal>myPluginGoal</goal>
                     </goals>
               </execution>
          </executions>
</plugin>



其中,myPluginGoal 即为你要调试的目标。

那么可以在Terminal中输入命令:



mvnDebug myPluginGroupId:myPluginArtifactId:myPluginVersion:myPluginGoal



然后,程序会自动分配8000 Listen端口。此时,在myPluginGoal对应的程序中打上断点,再点击调试按钮,就可以调试啦!

解决方案二(目标项目和插件项目联调)

这样的调试方式其实是服务器客户端的方式,目标项目是服务器,插件项目是客户端;只不过服务器和客户端都在我们本地电脑上。

首先在在目标项目中,增加Maven运行配置

maven 配置plugin的位置 maven plugin goal_maven 配置plugin的位置

进入配置后,先进入Parameters中,配置Command line:

maven 配置plugin的位置 maven plugin goal_maven_02

注意其中的jm目标可能是detect、delete、insert、update,根据实际情况选择,也就是“解决方案一”中的myPluginGoal。除此,要把groupId 、artifactId、版本号改成自己插件的对应值。

注:如果插件已经在目标项目的 pom 中定义,可以只写 jm:detect ,后面的 -DgroupId 等参数可以不写。

其中 -D 是 maven 命令,可以在终端输入 mvn -h 查看其作用:设置属性。类似例子可参见 https://maven.apache.org/guides/getting-started/maven-in-five-minutes.html

再进入Runner, 不勾选“Use project settings”,配置VM Options:

maven 配置plugin的位置 maven plugin goal_maven_03

其中的端口号可以改成其他的。

然后配置maven插件项目

maven 配置plugin的位置 maven plugin goal_开发工具_04

增加Remote配置,并将其中的端口号改成和目标项目端口号相同的值即可。

现在可以开始调试啦

首先点击目标项目的运行按钮,启动Listening...,再到插件项目中打好断点、点击调试按钮,即可开始调试。

后记

调试的方法有多种,本文中的方法比较简单,如有特殊需求可查询其他方法。

参考资料

《Maven实战》第17章介绍了编写maven插件的方法