Make Agents Yourself

*Draft version...*

h1. SpeADL MAY Project SetUp

_Estimated time: 3 minutes_

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 to benefit from MAY source code generation.

Then, create a new file with the speadl extension within the src folder: 

!https://wwwsecu.irit.fr/redmine/attachments/download/434/new_file_speadl1.png!

!https://wwwsecu.irit.fr/redmine/attachments/download/435/new_file_speadl2.png!

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. Using Maven

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 like this:

<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>2.1.0</version> <!-- uses 3.0.0-SNAPSHOT with may v3 -->

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

        <sourceDirectory>src</sourceDirectory>

        <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. 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... and click Ok.

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