In this chapter, we’ll cover the initial steps of a mobile web test on an Android device. After these initial steps, test creation follows the same principles as in the ⇢ Android app test example and ⇢ general web test creation.
In this chapter
- Preparations
- Choose a mobile browser
- Create a solution for mobile testing
- Create the test
- Setup
- Build the test
Preparations
To create a mobile web test, you need to make the following preparations:
Device settings
- Apply the required ⇢ device settings to your Android device and install the Ranorex Service App.
Connect mobile device
- ⇢ Connect your mobile device to your computer, preferably via USB, and ⇢ add it as an endpoint in Ranorex Studio.
Install the Ranorex Web Browser app for Android
- Ranorex provides a ⇢ preinstrumented web browser that is required for creating and executing Android web tests.
Choose a mobile browser
Ranorex provides a preinstrumented web browser. You need to use this browser to automate Android web tests.
Installing this app is explained in
Web and mobile testing > Mobile testing > ⇢ Instrument apps
Create a solution for mobile testing
-
⇢ Create a new solution for mobile testing using the RocketStart wizard.
-
Open the Endpoints pad.
-
Open the recording module Recording1.rxrec.
Ranorex Studio should now look as follows:
-
Empty action table in the recording module
-
Empty repository
-
Your device in the endpoints pad
-
Ranorex Service App running on the mobile device, showing the preinstrumented web browser app. If you chose a different web browser and instrumented it correctly, it will also appear here.
Create the test
-
Click RECORD.
-
The dialog for selecting the mobile device and instrumented app appears.
-
Select your Android device app (web browser), specify the URL, and click Create.
Setup
Ranorex Studio now executes the following processes to set up mobile test building:
In Ranorex Studio
Ranorex Studio starts the selected app on your mobile device and adds the respective actions in the action table.
-
The RUN button changes to reflect that it now runs the test on the current automation root, i.e. the active endpoint/mobile devices, not the computer.
-
An action that starts the app on the mobile device has been added to the action table.
-
An action that navigates to the specified URL in the selected browser app has also been added.
On the mobile device
Ranorex Studio starts the selected browser and navigates to the specified URL on the mobile device.
Ranorex Spy
Ranorex Spy starts in live tracking mode for all UI elements of the instrumented mobile app.
-
Element browser in Spy showing all the UI elements of the instrumented app.
-
Live view of the instrumented app on the mobile device.
Build the test
From this point forward, test building follows the same principles as in the ⇢ Android app test example and ⇢ general web test creation.