Debugging Component Code

You can use Eclipse to launch Isight to help debug your component code.

  1. Launch Eclipse.

    The Eclipse editor appears.

  2. In the Package Explorer area, right click the project and select Run as -> Run Configurations.

    The Run Configuration dialog box appears.

  3. Right-click Java Application on the left side of the dialog box, and select New.

    A new configuration is created.

  4. In the Project text box, enter the name of the project.

  5. In the Name text box, enter the name of the project.

    The run configuration name must be set to the project name because if the project name is different from the run configuration name, Eclipse will not show the source code when debugging.

  6. In the Main Class text box, enter the following:

    com.engineous.system.gui.desktop.DesktopMain

  7. Select Include system libraries when searching for a main class.

  8. Click the Arguments tab, and enter the following in the Program arguments and VM arguments areas:

    • Program arguments:

      logonprompt:no profile:Standalone

    • VM arguments:

      -Xms32M -Xmx1000M -Dfiper.system.esihome="<Isight_install_directory>" 
-Desihome="<Isight_install_directory>"
-Dfiper.system.user=development 
-Dfiper.system.temp="<%TEMP%/fiper>"
-Dfiper.user.temp="<%TEMP%/fiper>" 
-Dfiper.system.templib="<%TEMP%/fiper/templib>"

    You can set the temp directories to any desired location.

  9. Click the Environment tab.

    The procedure for defining environment variables depends on the platform on which you are running Eclipse.

  10. If you are running Eclipse on a Windows machine, do the following:

    1. Click New.

      The New Environment Variable dialog box appears.

    2. In the Name text box, enter Path.
    3. In the Value text box, enter the following:

      <Isight_install_dir>\<os_dir>\code\bin\

    4. Click OK to close the New Environment Variable dialog box.

      The Run Configurations dialog box appears.

  11. If you are running Eclipse on a Linux machine, do the following:

    1. Click New.

      The New Environment Variable dialog box appears.

    2. In the Name text box, enter Path.
    3. In the Value text box, enter the following:

      <Isight_install_dir>/<os_dir>/code/bin/;

      <Isight_install_directory>/<operating_system>/lib/Linux_7.3_x86;

    4. Repeat the above steps and create a new variable named LD_LIBRARY_PATH and set its value to:

      <Isight_install_directory>/<operating_system>/lib/Linux_7.3_x86

    5. Click OK to close the New Environment Variable dialog box.

      The Run Configurations dialog box appears.

  12. Select Append environment to native environment.

  13. Click Apply to accept the changes and to have Eclipse run Isight.

    You can use break points to pause execution at the desired line of code. It is recommended that you create separate copies of the run setup for each of your component projects.