使用 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>

问题：
一切都正确打包到 jar 中，但我的来源丢失了。
如果我尝试做一个简单的mvn package，它会告诉我 sun 包不存在。

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

我认为最后一部分是我在 jar 中找不到源代码的主要原因，因此我的问题是如何告诉 maven 忽略这些导入。

Answer 1

问题是maven在java安装目录/lib文件夹的tools.jar中找不到包com.sun.javadoc。

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 home。

注意：此依赖项在 MacOS 上不起作用。请参阅：JDK tools.jar as maven dependency - 摘要：为每个操作系统使用配置文件以便能够指定正确的路径。

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