How to setup Eclipse for Github
This tutorial covers the basics of the process, from downloading Eclipse, and the needed plugins “Maven Integration for Eclipse (Juno and newer)”, to running goGPS within the IDE. If you already have Eclipse and the plugin installed and you are using them, most likely you will not need to read this tutorial for running goGPS Java within Eclipse.
The first of all, download and install Eclipse (here we are using “Eclipse Standard” version Kepler), run it, access the workbench and click on “Help” – “Eclipse Marketplace…”.
After installing Eclipse, you are ready to install the Maven plugin. Start Eclipse and access the workbench and click on “Help” – “Eclipse Marketplace…”. Then search “Maven” (note that some recent versions of Eclipse may have the Maven plugin already installed)
Click the “Install” button in “Maven Integration for Eclipse (Juno and newer)” and go through the following windows.
Please note that installing these two Eclipse plugins does not necessarily mean that your system is already equipped with Maven. Depending on which operating system you are using, you might already have them installed or not. Please check your system and install the software package if necessary.
In case you are working behind a proxy server, you will need to setup Eclipse and Maven accordingly. Depending on the operating system that you are using, this might be done in different ways, so if you have problems with this step, feel free to ask in the gogps-discuss mailing list.
Once the plugin is installed and working, you can import goGPS Java by clicking on “File” – “Import…”, opening the “Git” folder and selecting “Projects from Git”.
The “Import Projects from Git” will appear, in which it is needed to enter "https://github.com/goGPS-Project/goGPS.git" as the “URI”, then "Host" and "Repository path" will be filled automatically.
Click “Next” and check-in the “master” branch in Branch Selection window.
Click "Next".
Wait until downloading the codes finish.
Choose "Import as general project" and click "Next"
Click "Finish" button.
Note that the procedure above has created a “goGPS” folder in your Eclipse workspace, containing a folder “src” and a file “pom.xml”, “data”, “test” folders inside “goGPS”.
Within the “data” folder you can place the RINEX files contained in the archive “data.zip” available in the Github (https://github.com/goGPS-Project/goGPS/wiki/data.zip).
If you have your own RINEX data available, you can place them in the “data” folder, but keep in mind that you will need to modify the paths leading to these files in “TestGoGPS.java”.
It is now time to set the project to use Maven, and to do that you can right-click on the project folder within the “Package Explorer” panel and select “Configure” – “Convert to Maven Project”.
Maven will download the dependencies needed by goGPS and setup the project, and after this process the “gogps” project folder in the “Package Explorer” panel should look like the following figure.
Let’s now create a run configuration to execute goGPS Java in post-processing. In the menu “Run”, select “Run Configurations…”.
Create a new configuration for a “Java Application”, name it “TestGoGPS” (or anything you like) and in the “Main” tab enter or browse to “gogps” as “Project” and “org.gogpsproject.TestGoGPS” as “Main Class”.
Apply, close the “Run Configurations” window and try to run goGPS by selecting “Run” – “Run As” – “TestGoGPS” or simply by clicking the green button with a white arrow as displayed in the figure.
If everything went well, you should see an output like in the following figure and a KML file with the result should have been created in the “test” folder.
In order to be able to run real-time applications that require a serial connection to a COM port (e.g. log data from a receiver connected to a USB port), you will also need to download the Rxtx library (http://rxtx.qbang.org/wiki/index.php/Download). Installation instructions can be found here: http://rxtx.qbang.org/wiki/index.php/Installation (NOTE: you only need to install the driver libraries, e.g. rxtxSerial.dll for Windows and librxtxSerial.so for Linux). A copy of the RXTX sources and compiled binaries used in the current version of goGPS Java is stored here: https://code.google.com/p/gogps/downloads/list