comment utiliser doc des plugins

Version imprimable

Bonjour,

j'ai des problèmes pour comprendre l'utilisation des plugins que l'on peut trouver ici : http://maven.apache.org/plugins/index.html

Par exemple je veux utiliser le plugin : javadoc

- il fait parti de la section "Reporting plugins", je dois donc le définir dans la balise <reporting> => ce qui donne ça :
Code:

1 2 3 4 5 6 7 8 9 10 11 <reporting> <plugins> <plugin> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-javadoc-plugin</artifactId> <version>2.6.1</version> </plugin> </plugins> </reporting>
Ensuite j'aimerai lancer automatiquement ce plugin, je dois donc mettre dans la definition de mon plugin ces balises :
Code:

1 2 3 4 5 6 7 8 9 <executions> <execution> <id></id> <phase></phase> <goals> <goal></goal> </goals> </execution> </executions>
=> le probleme est que je ne sais pas quels paramètres mettre : pouvez-vous me dire comment vous faite pour savoir quels paramètres utiliser (je trouve la doc pas très clair) ?
De plus j'ai recuperer ces balises dans un exemple trouvé sur le net mais aurais-je pu les trouver en utilisant uniquement la doc (je me vois mal lire tout le site pour trouver ce type d'information...la quantité d'information est enorme)?

02/12/2009, 10h46
Katachana

Tu as toutes les informations dans la F.A.Q
02/12/2009, 10h49
tchize_

chaque plugin documenté chez maven a une section "usage" qui donne un exempel succint d'utilisation
http://maven.apache.org/plugins/mave...gin/usage.html

Quand aux sections execution, elle sevent à lier des goals de ton plugin à des phases de maven. C'est largement défini dans la section de documentation sur la structure du pom:
http://maven.apache.org/pom.html#Plugins

Les "goals" sont spécifiques à chaque plugins et documenté dans chaque plugin (section "goals"):
http://maven.apache.org/plugins/mave...ugin-info.html

merci

Citation:

Envoyé par Katachana

Tu as toutes les informations dans la F.A.Q

=> la FAQ, c'est bien lorsqu'il y a les réponses mais dès qu'on sort des sentiers battus, on ne trouve plus son bonheur.
J'essaie de façon général a savoir où trouver les infos et comment les utiliser

Donc si je lis les docs de tchize, il faut mettre ça :
Code:

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 <reporting> <plugins> <plugin> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-javadoc-plugin</artifactId> <version>2.6.1</version> <executions> <execution>  <id>id_javadoc</id>  <phase>???</phase>  <goals> <goal>javadoc</goal> </goals> </execution> </executions> </plugin> </plugins> </reporting>
=> je n'ai pas trouvé ce qu'il fallait mettre dans la balise <phase> : comment sait-on dans quelles phases est utilisé le plugin ?
De plus, ou puis-je trouver les balises que je peux mettre dans la balise <configuration> (il me semble que le lien est mort) ?

02/12/2009, 12h17
tchize_

c'est pas le plugin, mais toi qui défini la phase dans laquelle tu veux l'exécuter. Tu choisir donc une des phase du "build life cycle". Les différentes phases sont décrites dans la doc du build lifecycle: http://maven.apache.org/guides/intro...lifecycle.html

Pour configuration, c'est spécifique à chaque plugin / goal. C'est décirt dans chaque goal. Ici pour le goal javadoc -> http://maven.apache.org/plugins/mave...adoc-mojo.html

ok merci beaucoup, je commence à bien comprendre comment ça fonctionne.

ça veut donc dire qu'on peut lancer le plugin jar avant met que l'appli soit compilée ? ce n'est pas une abération ?

par contre j'ai une erreur sur la définition de mon plugin :

Code:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
	<!-- plugin pour la creation de la javadoc dans le site -->
	<!-- lancement manuel : mvn site -->
	<reporting>
		<plugins>
 
			<plugin>
				<groupId>org.apache.maven.plugins</groupId>
				<artifactId>maven-javadoc-plugin</artifactId>
				<version>2.6.1</version>
 
				<!-- configuration : defini les parametres de focntionnement du plugin -->
				<!-- chaque fonction/goal de chaque plugin a ses propres parametres -->
				<configuration>
					<minmemory>128m</minmemory>
					<maxmemory>512m</maxmemory>
				</configuration>
 
 
				<!-- execution automatique du plugin -->
				<executions>
					<execution>
 
						<!-- identifiant quelconque pour le debug -->
						<id>id_javadoc</id>
 
						<!-- phase ou on lance le plugin -->
						<phase>package</phase>
 
						<!-- commandes (goals) du plugin appelees -->
						<goals>
							<goal>javadoc</goal>
						</goals>
					</execution>
				</executions>
 
			</plugin>
 
		</plugins>
	</reporting>

ça me met qu'il ne reconnait pas le tag "executions"

03/12/2009, 17h18
Tomekaa

Le tag <executions> n'est pas prévu pour les plugins de reporting, seulement pour les plugins de build.
04/12/2009, 11h57
boboss123

ok merci pour l'information