eclipse_project

Creating an Eclipse project for kmttg

This Wiki summarizes the steps needed to create an Eclipse project for kmttg. Note that this is based on older Eclipse IDE installations, so may vary a little for new versions.

REQUIREMENTS

Eclipse IDE installation
svn client
Optional: Apache ant

PREPARE ECLIPSE WORK AREA

• Create a "kmttg" folder alongside where all your other Eclipse top level project folders are
• If you have a Sourceforge account and kmttg project write permissions, populate new work area using:
  svn checkout --username=USERNAME https://svn.code.sf.net/p/kmttg/code/trunk .
• Ordinarily, though, for read only copy of the current repository:
  svn checkout svn://svn.code.sf.net/p/kmttg/code/trunk .

The above should populate the work area with all the source from kmttg repository.

ECLIPSE SETUP

Now that the work area is created, you need to make Eclipse aware of it as follows:

• File->New->Project

  • Java Project
  • Project name: kmttg
  • Contents = Create new project in workspace
  • Finish

• After the above you should see "kmttg" project entry.

RUNNING KMTTG FROM ECLIPSE

• In Eclipse setup a new "kmttg" run configuration as follows:
  name = kmttg
  Main = com.tivo.kmttg.main.kmttg

• Note that I don't usually run kmttg this way during development. Rather I use "ant" to make a build and then copy kmttg.jar to run location.

COMPILING KMTTG USING APACHE ANT

If you want to prepare/compile kmttg outside of Eclipse (which is what I use) you can use "ant" with the existing build.xml file to do everything easily for you:

• From the svn work area where you did svn checkout execute the following:
  ant

• Following a successful compile the above will make a zip file under the dist directory which is a full distribution of kmttg that can be used by others.

• During development I build using ant and then replace kmttg.jar in my normal kmttg installation.