Source Code

The source code for Genesis is available under the Apache License 2.0. The code is stored in a Subversion repository at Google Code.

[edit] Getting the Source Code

If you are using Eclipse (recommended), skip to the section below on building the application, which includes directions for checking out the source code.

If plan to build from the command line, use this command to anonymously download the latest project source code:

svn checkout http://dftproject.googlecode.com/svn/trunk dftproject

If you are a project committer, use this command instead:

svn checkout https://dftproject.googlecode.com/svn/trunk dftproject --username <your user name>

You can get your password from the Google Code project source page (you'll need to login first).

[edit] Building Genesis

Here is the quickest way to get Genesis built and running from the source code:

1. Download and install Eclipse 3.3 or later.
   Genesis uses features that are not available in earlier versions of Eclipse, so 3.2 won't work. Because Genesis is an RCP application made up of several plug-ins, you'll probably want to get the Eclipse for RCP/Plug-in Developers package.
2. Install the Subclipse plug-in (this will make it easy to download the source code directly into your workspace):
   1. Go to Help --> Software Updates --> Find and Install.
   2. Select Search for new features to install
   3. Click the New Remote Site button.
   4. Type "Subclipse" into the Name field and "http://subclipse.tigris.org/update_1.2.x" into the URL field.
   5. Make sure that the checkbox next to Subclipse is checked and click Finish.
   6. Select the Subclipse feature and follow the instructions until the installation is complete. You may need to restart.
3. Once you have Subclipse installed, download the Project Set File containing all the projects from http://dftproject.googlecode.com/issues/attachment?aid=6268687071960527585&name=dft-projectset.psf and save it someplace on your system.
4. From the Eclipse File menu select Import... and then choose Team Project Set and navigate to the location on your system where you saved the Project Set File. Eclipse will check out all of the necessary source code.
5. To get ready to run Genesis, you can either :
   1. Use an existing launch definition file by doing the following:
      1. Download the file from http://dftproject.googlecode.com/issues/attachment?aid=1598593282533226707&name=DFT-Genesis.launch and place it in the top level directory of the org.dft.genesis.ui project
      2. Refresh the project (you may have to close and reopen it if Eclipse is being finicky)
   2. Create your own launch definition by following these steps:
      1. Switch back to the Java perspective. You should see each of the projects you just checked out in the package explorer.
      2. Expand the org.dftproject.genesis.ui project and open the genesis.product file.
         This project contains the primary user interface code, as well as application and product definitions for Genesis. The genesis.product file is the product definition itself. It specifies what features constitute Genesis, what icons and splash screen to use, and so forth.
      3. An editor for the genesis.product file should appear. On the first page of this editor (the Overview page), click the Launch an Eclipse application link.
      4. Genesis will attempt to start up (you should see the splash screen), but will fail because it cannot locate all the necessary plug-ins. This is the quickest way to create a launch configuration, but now we need to specify where all the plug-ins are. Dismiss the error that appears and then open the launch configuration that we just created:
         1. Open the Run menu.
         2. Click the Open Run Dialog option.
         3. Go to the Plug-ins tab and click the Add Required Plug-ins button.
            This page is where you specify which plug-ins should be available when Genesis starts up. The Add Required Plug-ins is a quick way to enable all the plug-ins that are necessary for Genesis to run.
         4. Click Apply and then click Close.
6. Now you're ready to run Genesis. You can do this by clicking the Run or Debug buttons on the toolbar and selecting the DFT-Genesis or genesis.product launch configuration.