comment utiliser doc des plugins

**boboss123** · 02/12/2009, 10h34

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 :

Sélectionner tout - Visualiser dans une fenêtre à part

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 :

Sélectionner tout - Visualiser dans une fenêtre à part

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

**Katachana** · 02/12/2009, 10h46

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

**tchize_** · 02/12/2009, 10h49

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

**boboss123** · 02/12/2009, 11h33

merci

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 :

Sélectionner tout - Visualiser dans une fenêtre à part

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>
 
						<!-- identifiant quelconque -->
						<id>id_javadoc</id>
 
						<!-- phase ou on lance le plugin -->
						<phase>???</phase>
 
						<!-- commande du plugin appelees -->
						<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) ?

**tchize_** · 02/12/2009, 12h17

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

**boboss123** · 02/12/2009, 13h11

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 :

Sélectionner tout - Visualiser dans une fenêtre à part

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"