This issue is only present on macOS, and only on Java 1.8.0_152, released in October 17, 2017. 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.
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.
- Install jdk1.8.0_151 from the download page:
- 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:
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
- 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.
- Download and install the latest Eclipse Oxygen release from the Eclipse website.
- Follow the steps for "Installing API Studio for Eclipse" from this article:
RepreZen API Studio Installation Options: Desktop and Eclipse IDE
We fully expect that there will be a permanent resolution to this problem, either through subsequent updates to Java, and/or by migrating RepreZen API Studio's target platform from Mars.2 to a newer release of Eclipse.
API Studio is built on the Mars.2 (2015) Eclipse target platform so that our users can install it from Eclipse Marketplace into standard Eclipse IDEs, version Mars.2 or later. The eventual migration to the more recent Neon (2016) or Oxygen (2017) target platform will leave some Eclipse IDE releases behind; API Studio will no longer be available for installation into Eclipse IDEs older than the target platform on which API Studio is built.
In the meantime, we recommend using one of the two workarounds described above.