Make Agents Yourself

Make Agents Yourself » MAY Install »

MAY Maven Eclipse Setup » Historique » Révision 8

Révision 7 (Anonyme, 02/10/2014 11:15) → Révision 8/15 (Anonyme, 10/10/2014 15:27)

h1. SpeADL MAY Maven Eclipse Setup SetUp 

 h2. Install the Maven Eclipse Plugin 

 The Maven Eclipse Plugin, also named M2E, is available as part of the normal Eclipse distribution but must be explicitly installed. 

 Go to *Help* / *Install New Software...* and select the *All available site* in the drop-down list (it may take some time to load). 

 Expand the *Collaboration* category and select *m2e - Maven Integration for Eclipse*. 

 Click *Next*, finish the installation procedure and restart Eclipse when asked to. 

 h2. Convert an Existing Project to Maven 

 The first step is to convert your project into a Maven project. 
 To do this, right click on your project and on *Configure* / *Convert to Maven Project*. 

 You will be asked to create a new POM file. Just click *Finish* after editing the package, name and version if desired. 

 Alternatively, you can directly create a Maven project, this is out of scope of this document. 

 h2. Edit the POM File 

 Next, open the POM file in the project 

 <pre> 
 <project ...> 
	 <modelVersion>4.0.0</modelVersion> 
	 <groupId>XXX</groupId> 
	 <artifactId>XXX</artifactId> 
	 <version>XXX</version> 

	 <properties> 
		 <may-lib-version>3.3.0</may-lib-version> 
	 </properties> 

	 <dependencies> 
		 <dependency> 
			 <groupId>fr.irit.smac.lib.may</groupId> 
			 <artifactId>common-components</artifactId> 
			 <version>${may-lib-version}</version> 
		 </dependency> 
	 </dependencies> 

	 <repositories> 
		 <repository> 
			 <id>fr.irit.smac</id> 
			 <url>http://www.irit.fr/~Victor.Noel/maven-repos/</url> 
		 </repository> 
	 </repositories> 

	 <build> 
		 <!-- This is already present in the default POM --> 
		 <sourceDirectory>src</sourceDirectory> 
		 <resources> 
			 <resource> 
				 <directory>src</directory> 
				 <excludes> 
					 <exclude>**/*.java</exclude> 
				 </excludes> 
			 </resource> 
		 </resources> 
		 <plugins> 
			 <!-- This is already present in the default POM --> 
			 <plugin> 
				 <artifactId>maven-compiler-plugin</artifactId> 
				 <version>3.1</version> 
				 <configuration> 
					 <source>1.7</source> 
					 <target>1.7</target> 
				 </configuration> 
			 </plugin> 
			 <!-- This configure the maven to take into account the SpeADL code --> 
			 <plugin> 
				 <groupId>org.codehaus.mojo</groupId> 
				 <artifactId>build-helper-maven-plugin</artifactId> 
				 <version>1.8</version> 
				 <executions> 
					 <execution> 
						 <id>add-source</id> 
						 <goals> 
							 <goal>add-source</goal> 
						 </goals> 
						 <configuration> 
							 <sources> 
								 <source>speadl-gen</source> 
							 </sources> 
						 </configuration> 
					 </execution> 
					 <!-- The following is only needed so that speadl files are included  
						 in the generated maven artifact --> 
					 <execution> 
						 <id>add-resource</id> 
						 <goals> 
							 <goal>add-resource</goal> 
						 </goals> 
						 <configuration> 
							 <resources> 
								 <resource> 
									 <directory>${project.build.sourceDirectory}</directory> 
									 <includes> 
										 <include>**/*.speadl</include> 
									 </includes> 
								 </resource> 
							 </resources> 
						 </configuration> 
					 </execution> 
				 </executions> 
			 </plugin> 
		 </plugins> 
	 </build> 
 </project> 
 </pre> 

 h2. Possible issues and resolutions 

 h3. Errors on the Project 

 You may get an error message saying your project configuration is out of date with your new pom.xml. 

 Update it: right click on your project *Maven* / *Update Project...* and click *Ok*. 

 h3. Errors in the POM File 

 You also may get an error saying the following in the POM file: 

    Plugin execution not covered by lifecycle configuration: org.codehaus.mojo:build-helper-maven-plugin:1.8:add-source (execution: add-source, phase: generate-sources) 

 Click on *Discover new m2e connectors*, it should pre-check *buildhelper*, simply click *Finish* to accept and do the installation.