Status: Resolved

This issue has been fixed in RepreZen API Studio 1.6.9 and later releases, by upgrading the target platform to Eclipse Oxygen. If you are expreiencing this issue, we recommend that you install the latest release of RepreZen API Studio. See the announcement for further details.

This issue applies to:

When running on this configuration, RepreZen API Studio may install successfully, and appear to start normally.  But once the API Studio application loads, the menu and dialogs are not accessible, and RepreZen API Studio is unresponsive to keyboard/mouse interaction.

This article describes the technical background, two recommended workarounds, and expectations for a permanent fix. 

Cause: Java 1.8.0_152 introduced a bug that affects Eclipse IDE

Java 1.8.0_152 (also known as release 8u152) introduced a bug that affects some versions of Eclipse and Eclipse-based applications. You can find more details in this OpenJDK ticket or this Eclipse community forum discussion thread.  The issue is ongoing with later patch releases of Java as well. 

Solution 1: Run API Studio Desktop with Java 1.8.0_151

One recommended workaround is to run RepreZen with another Java patch release, e.g., 1.8.0_151

These steps need to be done only once. Once you've completed these steps, RepreZen API Studio will be using a compatible JVM release and should work normally.

  1. Install jdk1.8.0_151 from the download page:


  2. Open the /Applications/RepreZen API Studio.app/Contents/Eclipse/RepreZen.ini file and provide the path to the JVM as a -vm parameter.  Assuming that JDK 1.0.0_151 is installed to its default location at /Library/Java/JavaVirtualMachines/jdk1.8.0_151.jdk/Contents/Home/bin, the -vm setting should look like this:

    -vm
    /Library/Java/JavaVirtualMachines/jdk1.8.0_151.jdk/Contents/Home/bin

     The entire RepreZen.ini should look like this:


    -startup
    ../Eclipse/plugins/org.eclipse.equinox.launcher_1.3.100.v20150511-1540.jar
    --launcher.library
    ../Eclipse/plugins/org.eclipse.equinox.launcher.cocoa.macosx.x86_64_1.1.300.v20150602-1417
    -pluginCustomization
    plugin_customization.ini
    -vm
    /Library/Java/JavaVirtualMachines/jdk1.8.0_151.jdk/Contents/Home/bin
    -vmargs
    -Djavax.xml.accessExternalDTD=all
    -Djava.net.preferIPv4Stack=true
    -Xms256m
    -Xmx512m
    -XX:PermSize=192M
    -XX:MaxPermSize=256M
    -Djavax.xml.accessExternalDTD=all
    -XstartOnFirstThread
    -Dorg.eclipse.swt.internal.carbon.smallFonts
  3. Launch RepreZen as usual. The UI should be responsive now.

Solution 2: Install API Studio for Eclipse

As this bug is not present in the recent versions of Eclipse, you may also install RepreZen on top of a new Eclipse distribution. 

  1. Download and install the latest Eclipse Oxygen release from the Eclipse website
  2. Follow the steps for "Installing API Studio for Eclipse" from this article:

         RepreZen API Studio Installation Options: Desktop and Eclipse IDE