Configuring for the XULRunner embedded browser

The XULRunner package enables Mozilla as the embedded browser. If several XULRunner packages are installed on the same system, version mismatches can occur even if a specific XULRunner installation is registered as the default version. To clearly define the XULRunner browser and level to be used in your configuration, you must set up an explicit pointer to a XULRunner version.

About this task

The supported XULRunner versions are:
  • 1.8.x
  • 1.9.2
  • 3.6.x
Note: The XULRunner package must match the architecture (32-bit or 64-bit) of the product installation.
To download the XULRunner 1.9.2, click one of the following links:

Procedure

To set up an explicit pointer to a XULRunner version, complete the following steps.

  1. In the eclipse.ini file included in the product installation, locate the -vmargs section.
    Note:

    For users of IBM MobileFirst™ only:

    • If a Worklight.sh file is present in the same product directory as the eclipse.ini file, add your updates to the -vmargs sections of both files.
    • Some installations use JRE arguments from the Worklight.sh script instead of from the eclipse.ini file.
  2. In the -vmargs section, add the following JVM system variable where /home/myuser/xulrunner is the path to the root of an uncompressed XULRunner package.
    -Dorg.eclipse.swt.browser.XULRunnerPath=/home/myuser/xulrunner

Complete the following step to use the XULRunner browser instead of the WebKit browser.

  1. Add the following JVM parameter to the -vmargs section at the end of the eclipse.ini file.
    Note:

    For users of MobileFirst Studio only: If the Worklight.sh file is present, add the same code to the end of this file.

    -Dorg.eclipse.swt.browser.DefaultType=mozilla 
Icon that indicates the type of topic Task topic
Timestamp icon Last updated: July 17, 2017 21:58

File name: trpebrowser_linux_xul.html