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

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, switch to the SVN Repository perspective in Eclipse and add the repository location from above.
4. If you expand the repository location you'll find the genesis folder, under which you'll find a number of projects. Check all of them out, except for the target project (which is only needed when building a Genesis installation or archive):
   1. Select all of the projects under genesis without selecting genesis itself (except the target project).
   2. Right-click one of them.
   3. Select Checkout.
   4. Click Finish.
   5. Wait until the source code is downloaded.
5. Switch back to the Java perspective. You should see each of the projects you just checked out in the package explorer.
6. 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.
7. 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.
8. Genesis will attempt to start up (you should see the splash screen), but will fail because it cannot locate all the neccessary 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.
9. 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 neccessary for Genesis to run.
10. Click Apply and then click Close.
11. Now you're finally ready to run Genesis. You can do this by clicking the Run or Debug buttons on the toolbar.