Qt testing | Ranorex
Help CenterUser GuideInterfaces and connectivity

Qt testing

The Ranorex Automation Framework fully supports out-of-the-box test automation of Qt based applications.

Qt versions:

  • Qt Widgets: Qt version 4.5.3 or higher
  • Qt Quick: Qt version 5.0.2 or higher
  • Qt WebKit: Qt version 4.6.4 or higher

There is no need for a manual instrumentation, it will be done automatically.

Only dynamically linked Qt applications are supported.

To go back to MSAA (Microsoft Active Accessibility) and Qt Accessibility recognition, the ‘Qt legacy automation mode’ can be enabled in the ⇢ Plug-In Specific Settings.

When ‘Qt legacy automation mode’ has been enabled, MSAA support for your Qt application must be enabled to ensure that Ranorex can access UI elements and properties in the Qt application. This provides additional information on Qt UI elements to automation software like Ranorex and can be accomplished by shipping and loading the ‘Accessible Plug-in’ included in the Qt SDK (Software Development Kit) with the Qt application under test (see below).

tipp icon


Be aware that qt testing is not applicable to mobile applications. It will specifically not work with Android mobile applications.

Loading Accessible Plug-in for your Qt application

Copy the ‘accessible directory (and all its contents) from the Qt SDK (used to build the application under test) installation folder to the folder of the automated application (e.g. ‘Program Files/Your-Application/plugins‘). If you do not have access to the Qt SDK which the Qt application is developed with, please contact the developer of the application and request the ‘accessible’ directory from him. Create a file called ‘qt.conf’ (or append if the file already exists) in the root directory of the automated application (e.g. ‘Program Files/Your-Application‘) with following content (copy and paste the following two lines):

Plugins = plugins

Without Accessible Plug-in

With Accessible Plug-in