Make Agents Yourself

*Draft version...*

h1. SpeADL MAY Project SetUp

h2. A classic JAVA project to start with...

First, create a java project, choose a name, and click finish. Add the SpeADL Nature to the project : right click on the project / Configure / Add SpeADL Nature.

_This is necessary in order to..._

Then, create a new file with the speadl extension within the src folder. Eclipse will ask you if you want to add Xtext nature to the project, click yes.

!https://wwwsecu.irit.fr/redmine/attachments/download/336/add_xtext_nature_confirm.jpg!

h2. Maven convertion

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

You will be asked to create a new POM file. Just click finish and edit it manually. A good starting pom.xml for a new project is the following:

<pre>

<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"

	xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">

	<modelVersion>4.0.0</modelVersion>

	<groupId>XXX</groupId>

	<artifactId>XXX</artifactId>

	<version>0.0.1-SNAPSHOT</version>

	<dependencies>

		<dependency>

			<groupId>fr.irit.smac.may.lib</groupId>

			<artifactId>common-components</artifactId>

			<version>0.0.3-SNAPSHOT</version>

			<type>jar</type>

			<scope>compile</scope>

		</dependency>

	</dependencies>

	<repositories>

		<repository>

			<id>fr.irit.smac</id>

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

		</repository>

	</repositories>

	<build>

		<plugins>

			<plugin>

				<groupId>org.codehaus.mojo</groupId>

				<artifactId>build-helper-maven-plugin</artifactId>

				<version>1.7</version>

				<executions>

					<execution>

						<id>add-source</id>

						<phase>generate-sources</phase>

						<goals>

							<goal>add-source</goal>

						</goals>

						<configuration>

							<sources>

								<source>src-gen</source>

							</sources>

						</configuration>

					</execution>

				</executions>

			</plugin>

		</plugins>

	</build>

</project>

</pre>

h1. Possible issues and resolutions

h2. m2e connectors

Open your pom.xml file with the Maven POM Editor. In the overview tab, if you get this error:

!https://wwwsecu.irit.fr/redmine/attachments/download/344/me2_connectors.jpg!

Click "discover new m2e connectors", select buildhelper, then click finish.

Click Next to install m2e connector for build-helper-maven-plugin. Accept the terms of the licence agreements, and the security warning. Restart Eclipse.

h2. Project configuration is not up-to-date

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 Configuration...

!https://wwwsecu.irit.fr/redmine/attachments/download/337/update_project_conf.jpg!

h2. Proxy and Maven

In case you are behind a proxy, Maven may not be able to resolve dependencies.

You might get an error message like "failed to read arfifact descriptor" and "could not calculate build plan".

!https://wwwsecu.irit.fr/redmine/attachments/download/340/proxy_issue.jpg!

You have to configure Maven.

Window / Preferences / Maven / User Settings

!https://wwwsecu.irit.fr/redmine/attachments/download/338/maven_settings_proxy.jpg!

The settings.xml file located in the indicated directory usually doesn't even exit. Go to this directory and create an empty settings.xml file.

Edit it like this:

<pre>

<settings>

  <proxies>

   <proxy>

      <active>true</active>

      <protocol>http</protocol>

      <host>XXX</host>

      <port>YYY</port>

    </proxy>

  </proxies>

</settings>

</pre>

Replace XXX by your proxy URL and YYY by the port used. Ask your administrator if you don't know it.

When it's done, click Browse and select your settings.xml file, then click Update Settings.

This may take some take before the errors disapear, Maven is resolving dependencies and updating the project.

You can track the progression by clicking on this button, located down in the eclipse interface.

!https://wwwsecu.irit.fr/redmine/attachments/download/341/updating.jpg!