Developers are setup with either Eclipse or Netbeans IDE, but any editor will work. External Maven commands are launched to compile, package, and run unit tests. Here are instructions for getting setup with a SymmetricDS developer workspace using either Eclipse or Netbeans.
- Install the Eclipse IDE.
- Install Maven. Make sure the Maven "bin" directory is in your system path.
- From Eclipse, check out each project from https://svn.code.sf.net/p/symmetricds/code/trunk/.
- Configure the Maven repository variable for Eclipse. Go to Window->Preferences. In the tree, select Java->Build Path->Classpath Variables. Click the New button and enter "M2_REPO" with a value of your ".m2" directory. (Windows: C:\Documents and Settings\user\.m2, Unix: /home/user/.m2)
- In Windows, common Maven tasks are accessible through Eclipse external tools. Go to Run->External Tools->External Tools. The following tasks are avalable:
- Symmetric Eclipse - Generates Eclipse artifacts for each project to make them Java projects.
- Symmetric Compile and Package Only
- Symmetric Test and Package
- In Linux, use Maven from the command line
- To generate Eclipse artifacts for each project run: mvn eclipse:eclipse from the symmetric-assemble project.
- If you are going to be using Eclipse's code formatting capabilities and also expect to check in code please be sure to import the Eclipse formatter settings that the SymmetricDS team uses. It is in symmetric-server/src/shortcuts.
- Install the NetBeans IDE.
- Install the Netbeans Maven plugin from within the Netbeans plugin window.
- Install the Maven build manager.
- Configure the Netbeans Maven plugin's External Maven Home home folder to where Maven was installed from by going into the Tools....Options....Miscellaneous...Maven.
- Checkout the code from https://svn.code.sf.net/p/symmetricds/code/trunk/
- Create a project for the checked out code when it asks. e.g., symmetricds.
- Common Maven tasks are available on the right click menu for the project.