Tutorial: Qt Framework (RVL)¶
Rapise includes support for testing applications written using the Qt Framework and QWidget controls.
To ensure Rapise can access UI elements and properties in your Qt application, MSAA (Microsoft Active Accessibility) support must be enabled. This provides additional information on Qt UI elements to automation software like Rapise and can be accomplished by distributing and loading the "Accessible Plug-in" (included in the Qt SDK) with the Qt application under test.
This tutorial illustrates Rapise's ability to test such Qt applications using a sample application that already includes MSAA support.
This tutorial uses the Rapise Visual Language (RVL) (scriptless) mode. If you're interested in the JavaScript version, see our separate tutorial.
Testing the Sample Qt Application¶
In Rapise, on the Start Page, click the Fetch Samples button to ensure you have the latest samples available.
Then, navigate to:
1 |
|
and double-click on the QtWidgetApp.exe
file to start the sample application.
If you have everything configured correctly, you will see:
Once the application is started, open Rapise and click the File > New Test
menu option:
Enter Qt Sample Test as the name, and choose Basic: Windows Desktop Application as the methodology. On the next page, choose Rapise Visual Language (RVL) as the scripting language:
Once the test is created, you will see:
Click the Record button to display the "Select an Application to Record" dialog:
Choose the Sample QtWidget Application from the list of running applications, change the library selection from Auto
to Qt Framework
, and click Select
.
Now, in the sample application, click on some of the Qt controls. Rapise will record the actions:
When you click Finish, Rapise will prompt you to confirm where you want the recorded test steps to be placed:
Select the first row in the test grid and click Insert Here. You will see the recorded test script and learned objects in Rapise:
When you click Play, Rapise will play back your test script against the application:
Sometimes you need to learn objects that are not visible or are obscured by other objects. To assist with this, Rapise provides the Object Spy tool.
The Spy tool allows you to view the objects in the application within a learnable hierarchy.
During recording, click the Spy button, and Rapise will display the Accessible Spy:
You can then use the Accessible Spy to track and find objects in the application hierarchy. You can navigate to parent objects by right-clicking on them and choosing Parent. Once you have found the desired object, click Learn Object in the Spy toolbar, and Rapise will add the selected object to the list of learned objects for testing.