RomRaider/Building_RomRaider.txt

Steve Wadsworth (lizzardo on RomRaider forum)

This file is an attempt to consolidate available information on setting up, building,
and packaging RomRaider.  All instructions assume a Windows environment and the use
of Eclipse for development.  Apologies for the Windows-centricity, but some of the
tools inherited from the RomRaider project are Windows-based.

----------------------------------------------
Setting up the project (from romraider.com)

As an open source project, RomRaider depends on Java developers like you for
enhancements, bug fixes and general maintenance. This page is meant to be a
guide to setting up a development environment from scratch. The guide was
originally written by Tgui in this thread and has been adapted and revised.

RomRaider<EFBFBD>s official IDE is Eclipse. You are free to use any Java IDE you
choose, but due to the extremely simple process of setting up the environment
and the power of Eclipse, it<69>s probably your best choice.

    * Installing Eclipse and Subclipse
          o Install the latest version of the Java Development Kit
          o Get and Install Eclipse for your platform
          o Install Subclipse for Subversion (SVN) integration, following the
              steps outlined here.
    * Setting up the RomRaider project
          o Open the Java perspective in Eclipse by clicking
              Window > Open Perspective > Java
          o Right click in the package explorer and select <20>Import<72><74>
          o Select <20>Checkout Projects from SVN<56> and click <20>Next<78>
          o Select <20>Use a new repository location:<3A> and click <20>Next<78>
          o Enter <20>https://svn2.assembla.com/svn/romraider<65> and click <20>Next<78>
          o Highlight <20>trunk<6E> in the folder tree and click <20>Next<78>
          o Name the project <20>romraider<65> and click <20>Finish<73>

Now all you have to do is add the Jars within your libs dir to the project
java build path. You should read this.

http://www.eclipse.org/documentation/main.html

----------------------------------------------

Notes on the above:

1)  Make sure the build path for the Java builder is set correctly.  On the top menu:

        Project -> Properties -> Java Build Path

    On the Source tab, the default output folder should be set to

        romraider/build/classes

2)  The jars in the java build path mentioned above should be correct in the SVN
    repository.

3)  A command line Subversion client needs to be installed and available in the default
    path.  To verify this, open a command prompt and run 
    
        svn info https://svn2.assembla.com/svn/romraider
        
    You should get a response of the form
    
        Path: romraider
        URL: https://svn2.assembla.com/svn/romraider
        Repository Root: https://svn2.assembla.com/svn/romraider
        Repository UUID: 38686702-15cf-42e4-a595-3071df8bf5ea
        Revision: 78
        Node Kind: directory
        Last Changed Author: kascade
        Last Changed Rev: 78
        Last Changed Date: 2008-05-02 15:50:23 -0700 (Fri, 02 May 2008)

    If this does not work correctly, the ant build will fail.

The ant build file is in the main directory and uses the default name of "build.xml".

The Java builder is set as the default.  During development it's convenient to have
the "Problems" pane show warning and errors.  The ant build does not send warnings
or errors there.  The ant build is primarily for automation of the complete build
process for packaging.

To build using ant, right-click on the build
file in the Package Explorer (Java perspective) and select

Run As -> Ant Build

The "help" target lists available targets with a brief description of each.

The "all" target does just that.  It rebuilds everything, finishing with the installers.