maven - 如何为Maven依赖关系生成Javadoc

Question

我有一个带有以下POM代码段的Maven项目:

<modelVersion>4.0.0</modelVersion>
<artifactId>Foo-Deploy</artifactId>
<name>Foo-Deploy</name>
<packaging>pom</packaging>
<description>foobar</description>
<dependencies>
<dependency>
        <groupId>de.foo.bar</groupId>
        <artifactId>some-api</artifactId>
        <version>${project.version}</version>
        <classifier>doc</classifier>
        <type>zip</type>
    </dependency>
</dependencies>

这个想法是要定义一个依赖，其中有一些源(在此之前成功创建)。
现在，我想完全在此依赖项上运行javadoc。当我打电话

mvn javadoc:jar -DincludeDependencySources=true -DdependencySourceIncludes=de.foo.bar:some-api:*:doc:zip

它失败并显示消息

Not executing Javadoc as the project is not a Java classpath-capable package

怎么了 ？并且它会以任何方式工作吗？

或如何从特定依赖项生成javadoc(假设此项目具有更多依赖项)？

谢谢

Answer 1

要为依赖源生成javadoc，需要执行一系列步骤。这些在this link中概述。

本质上，您需要确保依赖项的源文件已生成/可用并且已启用<includeDependencySources>参数。