Welcome to the new Ranorex Support Portal

Instrument apps

Before you can use test automation with a mobile app, you must instrument the app. Instrumenting an app means configuring the app so that Ranorex Studio can access the GUI and functions of the app for the purpose of creating and running an automated test.

Instrumenting apps works differently for Android and iOS, which is why the procedures are explained separately in this chapter.

In this chapter

Preinstrumented Ranorex Web Browser for Android


For web tests on Android devices, the preinstrumented Ranorex web browser for Android is required.

Download and install the Ranorex Web Browser

  1. Scan the QR code below or go to https://support.ranorex.com/rxApp to download the Ranorex Web Browser for Android.

  1. Select the preinstrumented browser in the mobile download archive:

  1. Install it as you would any other app on your mobile device.

  1. Opened Ranorex Web Browser.

  2. The app is also listed in the Ranorex Service App, which indicates that it has been instrumented correctly.

Preinstrumented Ranorex Web Browser for iOS


For web tests on iOS devices, the preinstrumented Ranorex web browser for iOS is required.

Download and install the Ranorex web browser

  1. Scan the QR code below or go to https://support.ranorex.com/rxApp to download the Ranorex Web Browser for iOS.

  1. Select the preinstrumented browser in the mobile download archive:

  1. Install it as you would any other app on your mobile device.

  1. Opened Ranorex Web Browser.

  2. The app is also listed in the Ranorex Service App, which indicates that it has been instrumented correctly.

Instrument an Android app


You need to instrument Android apps before you can use them for mobile tests with Ranorex Studio.

Download

Reference


Instrumenting Android apps is explained in the following chapter:

Interfaces and connectivity > Ranorex Instrumentation Wizard > ⇢ Android apps.

Instrument an iOS app


You need to instrument iOS apps before you can use them for mobile tests with Ranorex Studio.

Instrumenting an iOS app means integrating a special Ranorex library (Ranorex libs) into the source code of the app and then compiling it. Afterwards, the app needs to be signed with a P12 certificate and the proper provisioning profile.

For more information on iOS development and release procedures, please refer to the official Apple documentation.

There are two ways to instrument iOS apps:

  • With the Ranorex Instrumentation Wizard (recommended)
Download

Reference


Instrumenting iOS apps using the Instrumentation Wizard is explained in:

Interfaces and connectivity > Ranorex Instrumentation Wizard > ⇢ iOS apps

  • Manual instrumentation of the source code in iOS with Xcode iOS developers can integrate the Ranorex library, compile it, and sign the app manually using Xcode.
Download

Reference


Manual instrumentation is explained in the following chapter:

Web and mobile testing > Advanced mobile testing > ⇢ iOS source-code instrumentation

Preinstrumented iOS sample app


Ranorex provides a preinstrumented iOS sample app for evaluation and learning purposes. The app is KeyPass for iOS, distributed under the GNU General Publice License. For information regarding the copyright holder and the license agreement, go to https://keepass.info/help/v1/license.html.

Download and install the sample app

  1. Scan the QR code below or go to https://support.ranorex.com/rxApp.

  1. The mobile download archive is categorized according to Ranorex Studio versions and mobile OS. Download the RxMiniKeePass app for iOS devices for your Ranorex Studio version.

  2. Next, install the sample app as you would any other app on your device.

  1. The RxMiniKeypass app appears on your home screen.

  2. Since the app is already instrumented, it also automatically appears in the Ranorex Service App.

USERS LOVE US

SUBSCRIBE TO OUR NEWSLETTER

Get the latest test automation information right in your mailbox.

FOLLOW US

© 2024 Ranorex GmbH. All Rights Reserved