Hacking on Aeron

Working in Eclipse

The Aeron project has set up the gradle build such that it is able to generate the appropriate eclipse project configuration files. To get up and running in Eclipse you need to do the following

1. Install the latest JDK 8 from Oracle.
2. Install the JDT 8 Beta for Eclipse Kepler
3. Create a new JDK configuration within Eclipse pointing at the freshly installed JDK8. Make sure that you give this JDK the name 'JDK1.8'.
4. Clone the Aeron project.
5. Run ./gradlew eclipse.
6. From Eclipse go to 'Import' -> 'Import Existing Projects into Workspace'. Select the directory contain the cloned Aeron project. Ensure that you check the 'Search for nested projects' option. Click Finish.

You should now have 5 new projects within Eclipse:

• Aeron
• aeron-client
• aeron-common
• aeron-driver
• aeron-samples

Working in IDEA

IDEA imports gradle build files itself, but unfortunately due to a bug you need to use gradle 1.10 rather than 1.11. 1.10 works fine with the gradle build.

1. Install the latest JDK 8 from Oracle.
2. Download Gradle 1.10 and extract it to a directory.
3. Clone the Aeron project.
4. Run ./gradlew to setup the build.
5. Inside IDEA go 'File' -> 'Import Project' then select the top-level build.gradle. Choose the 'Use local gradle distribution' option and select the directory you installed gradle into previously and click ok.

You should now have a top level "Aeron" project with 4 sub-modules.