This tutorial will teach you the following:

  1. How to obtain the source code of HIPE.
  2. How to use the Eclipse development environment to modify a component of HIPE.
  3. How to put back the modified component into HIPE to see the result of your changes.

Getting HIPE source code

You can get HIPE source code in two ways:

  • If you are installing a user release, select the Advanced installation and make sure that the option Would you like to have the source code installer? is checked (see figure below).
  • If you are downloading a developer build from the Continuous Integration System, run the installer with the option --src=yes or --developer (--developer implies --src=yes).

FIXME insert figure.

You can find the source code in the same repository that contains HIPE binary files. It resides by default in the .hcss.d directory within your home directory.

In this tutorial you will make a tiny (but highly visible) change in the ia_gui_apps module. Go to this directory:

.hcss.d/repository/modules/hcss/ia_gui_apps

This directory contains one or more further subdirectories, each representing a version number of the module. For example:

1.153.4  1.193.4  1.220  1.221

If you install or update HIPE often you will likely have several entries. How do you find out which one corresponds to a certain HIPE version? Go to your HIPE installation directory and open the installed.userlibraries file. Search for ia_gui_apps and you will find an entry similar to the following:

<archive path="/home/drizzo/.hcss.d/repository/modules/hcss/ia_gui_apps/1.220/ia_gui_apps_1.220.jar"/>

This tells you that the right directory is 1.220. Among the files in this directory, ia_gui_apps.src_1.220.zip is the one containing the source.

Installing and configuring Eclipse

Now that you have the source, you need to set up the tools to modify it.

Creating an Eclipse project

-- DavideRizzo - 30 Apr 2010

Edit | Attach | Watch | Print version | History: r14 | r4 < r3 < r2 < r1 | Backlinks | Raw View | Raw edit | More topic actions...
Topic revision: r1 - 2010-04-30 - DavideRizzo
 
This site is powered by the TWiki collaboration platform Powered by Perl