Wie man Javadoc für Maven-Abhängigkeiten erzeugt

Question

Ich habe ein Maven-Projekt mit dem folgenden POM-Schnipsel:

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

Die Idee ist, eine Abhängigkeit zu definieren, in der sich einige Quellen befinden (die zuvor erfolgreich erstellt wurden). Nun möchte ich javadoc für genau DIESE Abhängigkeit ausführen. Wenn ich aufrufe

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

schlägt er mit der Meldung

Javadoc wird nicht als Projekt ausgeführt nicht Java-Klassenpfad-fähig ist Paket

Was ist los? Und würde es trotzdem funktionieren?

oder wie kann ich javadoc aus einer bestimmten Abhängigkeit generieren (vorausgesetzt, dieses Projekt hat mehrere Abhängigkeiten)?

Danke

Answer 1

Um Javadoc für abhängige Quellen zu erzeugen, muss eine Reihe von Schritten durchgeführt werden. Diese sind beschrieben in dieser Link .

Im Wesentlichen müssen Sie sicherstellen, dass die Quelldateien der Abhängigkeit erzeugt/verfügbar sind und <includeDependencySources> Parameter aktiviert ist.