Home » Support » User Guide » Instrumentation Wizard » Android

Android

To make an Android app automatable by Ranorex, it is necessary to instrument this application using the Instrumentation wizard.

Note: Have a look at Android Testing - Getting Started to learn how to automate Android applications.

Android instrumentation wizard

Choose the APK file of the app and the device, the instrumented APK file will be deployed to. More information about setting up a mobile device can be found in section Manage Devices.

If the APK is already instrumented and only needs to be deployed on a mobile device, the checkbox 'Instrument the APK under test before deployment' can be unchecked.

After processing the instrumentation and deploying the instrumented APK file to the selected device, the installation has to be confirmed on the device.

Finished Android instrumentation

The instrumented APK file can be found at location referenced by the link 'Open instrumentation File location'.

After instrumenting the APK file, the app is available in the 'Mobile Recording' section of Record Setting dialog.

Instrumented APK in Record Settings
Instrumented APK in Record Settings

The Ranorex Service App installed on the mobile device shows an overview of instrumented apps installed on the device.

Overview of instrumented APKs

Note: If you have problems with instrumenting your APK using the instrumentation wizard or if you want to integrate the instrumentation into your build process, please have a look at the "Instrumentation with Source Code" section.