微信公众号搜"智元新知"关注
微信扫一扫可直接关注哦!

在Maven插件中设置Mojos和参数的描述

如何解决在Maven插件中设置Mojos和参数的描述

我正在编写一个maven插件,我想添加一些有关可用目标和参数的文档。

当我运行mvn help:describe -dplugin=myplugin -Ddetail时,它会打印出可用的目标和参数。但是它无处不在(没有描述)。通过搜索互联网,我不知道要在哪里设置这样的描述。

作为参考,我的插件是用scala编写的,看起来大致像这样。

import org.apache.maven.plugins.annotations.{ Component,Parameter }


class MyMojo extends AbstractMojo {

 @Parameter(defaultValue = "false",readonly = false)
 private var skipformatting: Boolean = _

}

所以我的问题是:在哪里可以设置描述,使其以mvn help:describe -dplugin=myplugin出现?

解决方法

我强烈建议使用以下内容:

  <plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-plugin-plugin</artifactId>
    <version>3.6.0</version>
    <executions>
      <execution>
        <id>default-descriptor</id>
        <phase>process-classes</phase>
      </execution>
      <execution>
        <id>generate-helpmojo</id>
        <goals>
          <goal>helpmojo</goal>
        </goals>
      </execution>
    </executions>
  </plugin>

,它将在构建过程中生成帮助部分。是的,您必须添加一些像这样的javadoc:

@Mojo(name = "failure",defaultPhase = LifecyclePhase.NONE,requiresDependencyResolution = ResolutionScope.NONE,threadSafe = true)
public class FailureMojo extends AbstractMojo {

我不明白为什么您的Mojo上没有任何注释?

像这样的文档:https://maven.apache.org/plugins/maven-install-plugin/plugin-info.html将从参数等的javadoc生成。https://github.com/apache/maven-install-plugin/blob/master/src/main/java/org/apache/maven/plugins/install/InstallMojo.java#L69

,

根据在help:describe等熟悉的插件上运行maven-jar-plugin的示例,tt似乎基于Mojo类的Javadoc。

版权声明:本文内容由互联网用户自发贡献,该文观点与技术仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容, 请发送邮件至 dio@foxmail.com 举报,一经查实,本站将立刻删除。