用maven包装自定义javadoc doclet

Question

我已经编写了自己的java doclet，并希望将其打包到一个jar文件中，以便稍后使用它。

我目前正在使用maven和这些设置来生成它：

<build>
    <finalName>Doclet</finalName>
    <plugins>
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-compiler-plugin</artifactId>
            <version>2.3.2</version>
            <configuration>
                <source>1.8</source>
                <target>1.8</target>
            </configuration>
        </plugin>

        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-jar-plugin</artifactId>
            <version>2.3.1</version>
            <configuration>
              <archive>
                <manifest>
                  <addClasspath>true</addClasspath>
                  <mainClass>de.test.tools.doclet.Doclet</mainClass>
                </manifest>
              </archive>
            </configuration>
        </plugin>

        <!-- Maven Assembly Plugin -->
        <plugin>
            <artifactId>maven-assembly-plugin</artifactId>
            <executions>
                <execution>
                    <id>make-my-jar-with-dependencies</id>
                    <phase>package</phase>
                    <goals>
                        <goal>single</goal>
                    </goals>
                </execution>
            </executions>
            <configuration>

                <archive>
                    <manifest>
                        <addClasspath>true</addClasspath>
                        <mainClass>de.test.tools.doclet.Doclet</mainClass>
                    </manifest>
                </archive>

                <descriptorRefs>
                    <descriptorRef>jar-with-dependencies</descriptorRef>
                </descriptorRefs>

            </configuration>
        </plugin>
    </plugins>
</build>

问题：

所有的东西都被正确地打包到了罐子里，但是我的来源丢失了。

如果我尝试做一个简单的mvn package，它会告诉我sun包不存在。

错误:包com.sun.javadoc不存在

我认为最后一部分是为什么我无法在jar中找到我的源的主要原因，因此我的问题是如何让maven忽略这些导入。

Answer 1

问题是，maven无法找到包com.sun.javadoc，它位于java安装dir的tools.jar文件夹中的/lib文件夹中。

Eclipse之所以能够执行它，是因为我将它添加到了类路径中，但是maven不知道从哪里可以获得资源。因此，添加以下系统依赖关系解决了我的问题：

<dependency>
    <scope>system</scope>
    <groupId>com.sun</groupId>
    <artifactId>tools</artifactId>
    <version>YOUR_JAVA_VERSION</version>
    <systemPath>${java.home}/../lib/tools.jar</systemPath>
</dependency>

用您的版本替换该版本，并确保在您的环境中已经知道java。

注意：这个依赖项在MacOS上不起作用。参见：JDK tools.jar as maven dependency -摘要:为每个操作系统使用概要文件可以指定正确的路径。

我只需要支持Linux + Windows，所以这对我来说是最好的解决方案。