Home » Support » User Guide » Instrumentation Wizard » Java AWT/Swing

Java AWT/Swing

The Java AWT/Swing technology limitation will pop up if your Java installation or application is not instrumented correctly.

Java AWT/Swing Technology Limitation
Java AWT/Swing Technology Limitation

The Instrumentation Wizard tries to add the Plug-In specific files to the Java Runtime Environment (JRE) of your choice and to activate the Java Plug-In for Ranorex.

You have 3 different choices:

  • Select a JRE from a list of running Java applications: Here you can choose the Java runtime based on the application you want to instrument. This is the preferred method, as you can determine exactly which Java runtime is being used by your application under test.
  • Select a JRE from a list of installed Java runtimes: Here you can choose the Java Runtime Environment you want to be instrumented from a list of all installed Java runtimes on your machine.
  • Specify a custom Java runtime directory: Here you can specify the folder holding the Java runtime you want to be instrumented.
Java Instrumentation Wizard
Java Instrumentation Wizard
After activating the Java AWT/Swing instrumentation, Ranorex will not be limited in recognizing UI elements of your Java application. Restart your application under test and your Ranorex tools to ensure that the newly added instrumentation works correctly.
Finished Java Instrumentation
Finished Java Instrumentation
If you are using Windows XP SP2, please also make sure that the Windows Update KB884020 is installed, which resolves problems with the local network communication.

If the activation of the Java Plug-In was not successful, please make sure that you have installed Ranorex correctly, that you have chosen the right directory of your JRE, and if you have started the Instrumentation Wizard from the “bin” folder that it has been started with admin rights.

Failed Java Instrumentation
Failed Java Instrumentation