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.
Note It's recommended to fresh instrument your app for every new Ranorex release. For further information have a look at the section 'Mobile Testing - Versioning'.
Android instrumentation wizard
Next to instrumenting and deploying your Android app, the Instrumentation Wizard allows you to update the Ranorex Service on your device as well as deploy the RXBrowser app, which enables web testing for Android.
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 App under test' 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 and deploying the APK file, the app is available in the 'Record a Mobile Test' section of Record Setting dialog.
Choose mobile as technology
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.