How to build the LiveTribe :: Console module

  1. Download and install J2SE 5. J2SE 5 is required to compile and run the LiveTribe Console.
  2. Download and install a Subversion client (most modern IDE already feature subversion support). In the following, we will refer to command line subversion client program svn.
  3. Download and install Maven 2. In the following we will refer to the command line maven client program mvn.
  4. Download and install the Eclipse IDE, version 3.2 or superior.
  5. Checkout and build the livetribe-ioc module from the nursery. The following commands will create the livetribe-ioc jar in the local maven repository on your computer. We will use this jar later.
  6. Download and install the Eclipse RCP, version 3.2 or superior. Pay attention to not download Eclipse, the IDE. The file to download is named eclipse-RCP-<version>-<os>-<ws>.zip. Note the "RCP" in the file name.

    Is it normally sufficient to unzip the Eclipse RCP file into a directory of your choice, for example ${user.home}/livetribe/eclipse.
  7. Copy the livetribe-ioc jar from the local maven repository to the Eclipse RCP installation:
    • cp ${user.home}/.m2/repository/org/livetribe/nursery/livetribe-ioc/1.0-SNAPSHOT/livetribe-ioc-1.0-SNAPSHOT.jar ${user.home}/livetribe/eclipse/plugins/org.livetribe.nursery.livetribe-ioc_1.0-SNAPSHOT.jar

      The livetribe-ioc jar is also an OSGI bundle, and as such is perfectly compatible with the Eclipse platform. Note also how the copied file follows the Eclipse naming convention.
  8. Checkout the LiveTribe Console source code in the directory of your choice, for example ${user.home}/livetribe/livetribe-console:
  9. Start Eclipse, the IDE, and import the LiveTribe Console source code into the workspace.

    From the menu, start the import wizard by selecting: File -> Import -> Existing Project into Workspace.

    In the next wizard page, choose as root directory the LiveTribe Console subproject directory: ${user.home}/livetribe/livetribe-console/trunk/org.livetribe.console.ui.

    In the wizard page, the "Projects" list should have one project with a checked checkbox. We suggest to uncheck the checkbox "Copy projects into workspace".

    Click Finish, and repeat the steps to import any other LiveTribe Console subproject you're interested to work on.
  10. Configure the target platform in the Eclipse IDE, by opening the Preferences dialog from the menu: Window -> Preferences -> Plugin Development -> Target Platform.

    Set the "Location" to be the place where you unzipped the Eclipse RCP distribution: ${user.home}/livetribe/eclipse.

    Be sure the livetribe-ioc bundle is listed in the "Plug-ins" tab, then click OK.