Hacking on Aeron

Working in IDEA

IDEA imports gradle build files itself.

1. Install the JDK 8 or 11.
2. Clone the Aeron project.
3. Run ./gradlew to setup the build.
4. 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 sub-modules.

On a Mac

When running ./gradlew, if you see any unit test failures with io.aeron.exceptions.DriverTimeoutException in the stack trace, you may be running afoul of this

It may also be useful to update to a newer version of bash, as Mac's ship with a much older version. brew install bash should do the trick.

Other IDEs

The main IDE used by the Aeron contributors is IDEA. Please share experiences if you have had success setting up any other IDEs to work with Aeron.