Comment générer du javadoc pour les dépendances maven
-
14-11-2019 - |
Question
J'ai un projet Maven avec l'extrait de POM suivant:
<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>
L'idée est d'avoir une dépendance définie dans laquelle se trouvent certaines sources (ceci est créé avec succès avant). Maintenant, je veux exécuter Javadoc sur exactement cette dépendance. Quand j'appelle
mvn javadoc:jar -DincludeDependencySources=true -DdependencySourceIncludes=de.foo.bar:some-api:*:doc:zip
il échoue avec le message
Ne pas exécuter Javadoc car le projet n'est pas un package compatible Java ClassPath
Qu'est-ce qui ne va pas ? Et cela fonctionnerait-il de toute façon?
Ou comment puis-je générer du Javadoc à partir d'une dépendance spécifique (en supposant que ce projet a plus de dépendances)?
Merci
La solution
Pour générer du Javadoc pour les sources dépendantes, une séquence d'étapes doit être effectuée. Ceux-ci sont décrits dans ce lien.
Vous devez essentiellement vous assurer que les fichiers source de la dépendance sont générés / disponibles et <includeDependencySources>
Le paramètre est activé.