Getting Started with OpenSHA Development

Obtaining Source Code

Two options are available to obtain the OpenSHA source code:

1. Browse Source on this website. Once in the trunk folder, the current release code may be downloaded as a zip file (the link is at the bottom of the page)
2. Check the codebase out from our Subversion repository. Instructions on how to do this from within Eclipse are provided below.

1) Download Eclipse

The latest version of Eclipse can be obtained from ​The Eclipse Website

The "Eclipse IDE for Java Developers" should be fine, however the Enterprise Edition (EE) will work as well.

2) Install the Subversion (SVN) Plug-in

The Eclipse SVN Plug in is called "Subclipse".

To install in Eclipse, follow the tutorial here: ​Subclipse Installation

(be sure to use http://subclipse.tigris.org/update_1.6.x as the update site when prompted)

3) Add the OpenSHA Source Repository

Once Subclipse is properly installed, from within eclipse:

• Select Window > Open Perspective > Other.
• Select SVN Repository Exploring and hit OK.

The SVN Repository tab should now be visible:

• Click the Add SVN Repository button shown here...

• Enter http://intensity.usc.edu/svn/opensha as the URL and hit Finish.
• Enter your username and password.

4) Check out the OpenSHA Project

• Click the arrow to expand the repository tree.
• Right click on trunk and select Checkout...:

• If you are happy with the default options (they are fine for most people), just click Finish.
  • If you would like to specify where to put your "Working Copy" of the project, click Next instead.
• Be patient, it may take a little while to check out the entire project the first time.
• Once it is checked out, switch to the Java perspective Window > Open Perspective > Java (or Other, then Java).
• More patience, it will probably take a little while to build the project as well (you should see Building Workspace in the lower right corner of the Eclipse window.

Working with OpenSHA

The instructions above will enable any registered user to get a copy of the codebase. However, any new code by authorized developers must be committed to the repository on a branch. There are many

If you think there is some new