Make Agents Yourself

h1. SpeADL MAY Installation

h2. Java Development Kit

You will need to install the Java Development Kit (JDK) in order to run Eclipse.

You can donwload it here if you don't have it already : http://www.oracle.com/technetwork/java/javase/downloads/

h2. Eclipse Kepler

The following instructions will guide you through the SpeADL MAY installation process.

Sometimes, eclipse answer delays are a bit long, make sure you don't abort an operation thinking it crashed: wait for it to finish.

You will need the latest Eclipse *Kepler* distribution. The Eclipse IDE for Java Developers will be fine.

*Warning : make sure you download the version that matches your JDK. If you have a 32bits JDK, take the 32bits version of Eclipse Kepler. If you have the 64bits JDK, choose Eclipse Kepler 64bits.*

You can download Eclipse Kepler here: http://www.eclipse.org/downloads/.

Latest version is R1 available at this link: http://www.eclipse.org/downloads/packages/eclipse-standard-431/keplersr1

This entire tutorial has been written for this particular Kepler eclipse version (screenshots may be outdated), so make sure you download and use this one.

Install it and launch it.

There is a known bug on windows that requires eclipse to be launched in administrator mode in order to install plugin correctly (not sure if this is still true...).

Make sure you always launch it in this mode during the installation process:

!https://wwwsecu.irit.fr/redmine/attachments/download/433/install_admin.png!

h2. Eclipse and proxy

If you are behind a proxy you may need to configure eclipse.

*Window* / *Preferences*

!https://wwwsecu.irit.fr/redmine/attachments/download/390/eclipse_proxy1.jpg!

Type *connection* in the text field and it will bring the following :

!https://wwwsecu.irit.fr/redmine/attachments/download/391/eclipse_proxy2.jpg!

Select *Network Connections* and choose *Manual* for the Active Provider setting.

Then select the ligne with *HTTP* and click *Edit*.

!https://wwwsecu.irit.fr/redmine/attachments/download/392/eclipse_proxy3.jpg!

Enter your Host and Port information. At the IRIT these are :

*Host* : proxy.irit.fr

*Port* : 8001

!https://wwwsecu.irit.fr/redmine/attachments/download/394/eclipse_proxy5.jpg!

Click *OK*.

Do the same for the *HTTPS* line. You should obtain the following :

!https://wwwsecu.irit.fr/redmine/attachments/download/393/eclipse_proxy4.jpg!

Click *OK*.

h2. Make Agents Yourself Plugin

Now you are ready to install the MAY plugin for eclipse : *Help* / *Install New Software...* / *Add...*

*Name* : may

*Location* : http://www.irit.fr/~Victor.Noel/may/update-may-3.2/

!https://wwwsecu.irit.fr/redmine/attachments/download/349/new_may_add_repo.jpg!

Select *Make Agents Yourself* and click *Next*. It will take some times calculating requirements and dependencies.

If Eclipse complains about a missing dependency such as Xtext, close the window, follow the previous process of adding an update site: *Help* / *Install New Software...* / *Add...*

*Name* : xtext

*Location* : http://download.eclipse.org/modeling/tmf/xtext/updates/composite/releases/

Click *Next* again when it shows you the install details and accept the terms of the licence agreements, then *Finish*.

Click *OK* when you get the security warning, and accept to restart Eclipse now.

!https://wwwsecu.irit.fr/redmine/attachments/download/339/security_warning.jpg!

h2. Maven plugin

http://eclipse.org/m2e/

With this tool, you can easily publish projects informations and share JARs across several projects.

Installing it will save you a lot of time trying to navigate many projects, and will allow you to quickly start using MAY, resolving dependencies and providing you access to existing MAY components.

Follow the instructions on this page to install it : [[Maven Plugin Install for Eclipse]].

h2. SpeADL MAY Project Setup

When all is installed and that you have configured Maven to work with your proxy, you are ready to create a MAY project.

For further instructions, click here: [[SpeADL MAY Project SetUp]].