Requirements
- JDK 6 (http://java.sun.com/javase/downloads/index.jsp)
- Eclipse 3.3 or above (http://www.eclipse.org/downloads/)
- Maven 3.0.0 or above (http://maven.apache.org/download.html)
Development environment configuration
Maven installation
A detailed instruction about Maven set up you find at http://maven.apache.org/download.html#Installation. Note, that AgE requires Maven 3.0.0 or above. To assure that Maven is correctly installed, run the command
mvn --version
which should print installed Maven version.
Maven integration with Eclipse
However there is a popular plugin (m2eclipse) which integrates Maven with Eclipse, it is not desired to use it, as it causes some problems with project set-up and development (such as not resolved dependencies).
We suggest to perform only the following steps:
In Eclipse set up class-path variable M2_REPO, which should point to local Maven repository (by default located in $USER_DIR/.m2/repository)
- Open Window -> Preferences -> Java -> Build Path -> Classpath Variables
- Click "New..."
- Set name as
M2_REPOand proper localization.
Platform set-up
To set up you project based on AgE platform follow these steps:
- Check out your project from SVN
- Create Eclipse project files (
.project,.classpath) by running from your project directory command:In some cases Maven shows that some dependencies are unresolved. Read #Missing Maven dependencies for more details.mvn eclipse:eclipse
- Open Eclipse IDE and import your projects using option Existing Project into Workspace
Running examples
Example projects have ready-to-use Eclipse launches placed in src/main/config/. To run such example, click right button on *.launch file and choose Run as -> launch_name.