FAQ Maven 2Consultez toutes les FAQ
Nombre d'auteurs : 4, nombre de questions : 74, dernière mise à jour : 22 septembre 2006
Sommaire→Utilisation→Documentation- Comment générer le site d'un projet ?
- Comment générer la javadoc pour un projet ?
- Comment vérifier la qualité du code avec checkstyle ?
- Comment vérifier la qualité du code avec PMD ?
- Comment connaître l'activité d'un projet ?
- Comment générer un rapport croisé des sources ?
- Comment analyser les métriques avec JDepend ?
- Comment générer un rapport des tags ?
- Comment générer un rapport de couverture des tests ?
Dans une console de commandes, accéder au répertoire du projet, et exécuter la commande suivante :
mvn site
Le répertoire /target/site situé dans votre projet contient alors le site.
Ajouter dans le fichier pom.xml les balises suivantes :
<reporting>
...
<plugins>
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-javadoc-plugin</artifactId>
<configuration>
<minmemory>128m</minmemory>
<maxmemory>512m</maxmemory>
...
</configuration>
</plugin>
</plugins>
...
</reporting>
Exécuter ensuite la commande suivante qui créera le site du projet avec le rapport javadoc :
mvn site
Voir aussi : About Maven Javadoc Plugin
Ajouter dans le fichier pom.xml les balises suivantes :
<project>
...
<reporting>
<plugins>
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-checkstyle-plugin</artifactId>
</plugin>
</plugins>
</reporting>
...
</project>
Exécuter ensuite la commande suivante qui créera le site du projet avec le rapport checkstyle :
mvn site
Voir aussi : About Maven Checkstyle Plugin
Ajouter dans le fichier pom.xml les balises suivantes :
<project>
...
<reporting>
<plugins>
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-pmd-plugin</artifactId>
</plugin>
</plugins>
</reporting>
...
</project>
Exécuter ensuite la commande suivante qui créera le site du projet avec le rapport PMD :
mvn site
Voir aussi :
PMD : un outil pour l'audit de code
About Maven PMD Plugin
Ajouter au fichier pom.xml les balises suivantes :
<project>
...
<reporting>
<plugins>
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-changelog-plugin</artifactId>
</plugin>
</plugins>
</reporting>
...
<scm>
<connection>scm:svn:http://chemin_du_projet</connection>
<developerConnection>scm:svn:https://chemin_du_projet</developerConnection>
<url>scm:svn:http://chemin_du_projet</url>
</scm>
...
</project>
Le paramétrage du SCM est nécessaire car les rapports d'activité se basent dessus.
Dans une console de commandes, accéder au répertoire du projet, et exécuter la commande suivante :
mvn site
Le répertoire /target/site situé dans votre projet contient maintenant trois rapports d'activité :
- changelog : rapport indiquant toutes les activités sur le SCM.
- dev-activity : rapport indiquant par développeur le nombre de commits, de fichiers modifiés.
- file-activity : rapport indiquant les fichiers qui ont été révisés.
Un rapport croisé des sources permet de naviguer dans les sources du projet à partir du site généré par Maven.
Ajouter au fichier pom.xml les balises suivantes :
<project>
...
<build>
...
</build>
<reporting>
<plugins>
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-jxr-plugin</artifactId>
</plugin>
</plugins>
</reporting>
...
</project>
Dans une console de commandes, accéder au répertoire du projet, et exécuter la commande suivante :
mvn site
Ajouter dans le fichier pom.xml les balises suivantes :
<project>
...
<reporting>
<plugins>
<plugin>
<groupId>org.codehaus.mojo</groupId>
<artifactId>jdepend-maven-plugin</artifactId>
</plugin>
</plugins>
</reporting>
...
</project>
Dans une console de commandes, accéder au répertoire du projet, et exécuter la commande suivante :
mvn site
Voir aussi :
About Maven JDepend Plugin
Analyse de la qualité du code Java avec JDepend 2.7
Ajouter dans le fichier pom.xml les balises suivantes :
<project>
...
<reporting>
<plugins>
<plugin>
<groupId>org.codehaus.mojo</groupId>
<artifactId>taglist-maven-plugin</artifactId>
<version>2.0-beta-1</version>
<configuration>
<tags>TODO, @todo</tags>
</configuration>
</plugin>
</plugins>
</reporting>
...
</project>
Dans une console de commandes, accéder au répertoire du projet, et exécuter la commande suivante :
mvn site
Voir aussi : Maven 2 Taglist Plugin
Nous allons utiliser pour ce faire plugin Cobertura.
Un outil d'analyse de couverture des tests permet de savoir quelles portions de code n'ont pas été testée, et ainsi agir en fonction.
Ajouter dans le fichier pom.xml les balises suivantes :
<project>
...
<build>
...
<plugins>
...
<plugin>
<groupId>org.codehaus.mojo</groupId>
<artifactId>cobertura-maven-plugin</artifactId>
<executions>
<execution>
<goals>
<goal>clean</goal>
</goals>
</execution>
</executions>
</plugin>
</plugins>
</build>
<reporting>
<plugins>
...
<plugin>
<groupId>org.codehaus.mojo</groupId>
<artifactId>cobertura-maven-plugin</artifactId>
</plugin>
</plugins>
</reporting>
</project>
Dans une console de commandes, accéder au répertoire du projet, et exécuter la commande suivante :
mvn site
Voir aussi : Maven 2 Cobertura Plugin