eclipse.md

Eclipse Setup

These instructions may be out of date!!!

If you use eclipse, please update this document

Plugins:

• Buildship Gradle Integration
  1. Install Plugin
• Checkstyle
  1. Install Plugin
  2. Follow: https://checkstyle.org/eclipse-cs/#!/project-setup
  3. After step 3 "Activate Checkstyle for your project", select the TripleA configuration file instead of "Sun Checks". Checkstyle file: triplea/config/checkstyle/checkstyle.xml
• Lombok
  1. Download jar file and execute it: java -jar lombok.jar
     • manual install if that does not work
     • Version to use: Same version as Gradle (see lombok configuration in the top-level Gradle buildscript)
  2. Enable annotation processing: how-to-configure-java-annotation-processors-in-eclipse

Formatter

1. Install Google Java Format Plugin
   • Important Use the unofficial 1.7 version available here: https://github.com/google/google-java-format/files/2774507/google-java-format-eclipse-plugin-1.7.0.jar.zip
   • Download the 1.7 version, unzip it, and move the extracted 'jar' file to the eclipse 'dropins' folder.
2. Project > Java Code Style > Formatter
   1. Import profile, select the Triplea formatter file: triplea/.ide-eclipse/format/triplea-eclipse-java-google-style.xml
   2. Change Formatter implementation to 'google-java-format'

Cleanup

1. Project > Java Code Style > Cleanup
2. Select the Triplea cleanup file: triplea/.ide-eclipse/format/triplea_java_eclipse_format_style.xml

Import Order

1. Project > Java Code Style > Organize Imports
2. Click 'Import' and select the import file: triplea/.ide-eclipse/format/triplea.importorder

Should look like this when configured:

Useful:

• EGit in Eclipse - with tutorial
• Run Configurations are checked in
• Run ./gradlew downloadAssets one time to get images downloaded