How to setup eclipse workspace to build the DataExplorer == Prepare your system == - Install the JDK (prefer 64-Bit to enable full system heap usage) - Install Eclipse - Install ant-contrib from http://ant-contrib.sourceforge.net/ or use jar from build/ant folder after project import - Make sure that the ANT classpath (Window > Preferences > Ant > Runtime) is correct, containing... - all the jars from Eclipse's org.apache.ant plugin directory - the tools.jar from the JDK's lib directory - the antcontrib.jar - Check that the file encoding is set to UTF-8 (Window > Preferences > General > Workspace) - install git for your operating system, git contains also ssh functionality to make it easier for WIndows users (for Windows install check-out and commit in UNIX style to enable cross platform development) - optional: Make Java sources available: Window > Preferences > Java > Installed JREs Edit... in rt.jar Source attachment...: Java/jdk/src.zip == Setup DataExplorer in Eclipse == - Check out all projects via CVS (https://savannah.nongnu.org/cvs/?group=dataexplorer). Checking out only specific projects won't work, as the build files expect all projects to exist - Clone git repository outside on a command shell or bash shell - Create a directory for instance ../git and change directory into it, do not create this directory below your workspace - Anonymous clone: git clone git://git.savannah.nongnu.org/dataexplorer.git - Member clone: git clone @git.sv.gnu.org:/srv/git/dataexplorer.git - Eclipse -> Import -> Git -> Projects from git -> existing local repository -> select the folder dataexplorer below your git folder - Import existing projects -> all projects should be automatically selected -> OK - Next, configure the needed classpath variable: - Window > Preferences > Java > Build Path > Classpath Variables - Add "SWT_JAR_PATH" with the appropriate path to your system in "build/lib///swt.jar" - Add "USB4JAVA_PATH" with the appropriate path to your system in "build/lib///libusb4java-1.2.0.jar" - Complete Ant libraries if not already done - Fix RXTXcomm problem messages: Set Window > Preferences > Maven > Errors/Warnings > Plugin execution not covered by lifecycle configuration to 'Ignore' - Verify Window > Preferences > ... > Workspace "Text File Encoding" to UTF-8 and "New text file line delimiter" to UNIX - Open the properties editor of Eclipse - Enable project specific settings for "Clean Up" and "Formatter" - Import the settings from "build/setup" (code_cleanup_preferences.xml and code_format_preferences.xml) - Java -> Compiler -> Compliance Level -> 11 - Build and update capabilities - Configure build/build.properties install.dir to your requirements (used by "clean dev-build install" to local directory, take care about permissions) (install.dir.windows=C:/Program\ Files\ (x86) ) == Prepare stuff == - In the "build" project, locate the file "build build.xml clean dev-build.launch" - Right-click on it and choose "Run as" - Select the first entry from the context menu to create all needed directories and files within == Start the application within Eclipse == - In the DataExplorer project, locate the file "DataExplorer.launch", right-click on it and choose "Debug as > Java Application" - Linux user should add -DSWT_GTK3=0 as argument for the launcher