Initial Project Setup / Eclipse Run Script

It is helpful to run Eclipse with a script to ensure that proper versions of Eclipse and Java are used.

The following sections are included in this documentation:

Prerequisites

This step requites that Eclipse/Photran was previously installed as per the Developer Environment / Eclipse and Photran documentation.

Default Eclipse Run Script

Linux

TODO smalers 2016-12-31 need to complete this.

Windows

The following batch file was created in the repository to run Eclipse and is suitable if the project is configured as per this documentation. It is recommended that developers use the script as is if possible to run from a Windows command shell that has been initialized with the proper MinGW environment variables.

C:\Users\user\cdss-dev\StateCU\git-repos\cdss-app-statecu-fortran\build-util\eclipse\run-eclipse-statecu.bat

A snapshot of the script contents is as follows (see the repository for current version):

rem Run Eclipse with Java 8, to make sure the right versions are used
rem This assumes that Java 8 and Eclipse have been installed as per the StateCU developer documentation.

rem Specify the VM to use and the maximum memory
"C:\Program Files\Eclipse\eclipse-parallel-mars-64\eclipse" -vm "C:\Program Files\Java\jre8\bin\java" -vmargs -Xmx700M

Note that the command line parameters passed to Eclipse are an alternative to changing the eclipse.ini file distributed with the Eclipse software. If the above is not suitable, it is recommended that the above script is copied as a developer-specific version as described in the next section.

Developer-specific Run Script

If the above script is not appropriate for the specific developer, make a copy and modify. For example, save in a cdss-dev\StateCU\build-util folder.

Next Step

Use the run script to start Eclipse. The next step is to set up an initial Eclipse workspace.