maven-site-plugin 未使用 javadocs 生成 apidocs 文件夹

Question

我继承了一个项目，该项目应该构建 javadoc 文件并将它们放在站点目录中。这还没有完成。我已经查看了我能找到的所有示例，但无法弄清楚配置在哪里被破坏。

        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-site-plugin</artifactId>
            <version>3.0</version>
            <executions>
                <execution>
                    <phase>prepare-package</phase>
                    <goals>
                        <goal>site</goal>
                    </goals>
                    <configuration>
                        <reportPlugins>
                            <plugin>
                                <groupId>org.apache.maven.plugins</groupId>
                                <artifactId>maven-javadoc-plugin</artifactId>
                                <version>2.8</version>
                            </plugin>
                        </reportPlugins>
                    </configuration>
                </execution>
            </executions>
        </plugin>

非常感谢任何和所有帮助。

Answer 1

您已将 Maven 站点插件的 site 目标绑定(bind)到 prepare-package 阶段。您已在此插件配置中配置了 javadoc 生成。

因此，如果您运行 Maven 的默认生命周期目标，例如 mvn package 或 mvn install，您应该获得带有 javadocs 的站点报告。

如果您运行mvn site，它将跳过插件配置绑定(bind)的prepare-package阶段，因此不会生成javadoc。