This guide explains how to install the Ranorex iOS apps on a device using your Apple Developer certificate and the Ranorex Instrumentation Wizard.
The process applies to the following apps:
- RxServiceApp
- RxBrowser
- RxMiniKeePass
Obtain the IPA files
You can obtain the IPA files from:
- The Ranorex installation folder:
C:\Program Files (x86)\Ranorex\Studio\Bin\RxEnv\iOS - The Mobile downloads page
Create a distribution certificate
- Log in to the Apple Developer Portal - Certificates
- Select Apple Distribution and click Continue
- Next, upload a Certificate Signing Request (CSR)
- On your Mac, open Keychain Access
- Select Keychain Access > Certificate Assistant > Request a Certificate from a Certificate Authority…
- Select Save to disk and complete the process
- Go back to the Developer portal to upload the CSR file
- Download the generated certificate, double-click it to open it in Keychain Access
- Locate the newly added certificate. Select both the certificate and its associated private key
- Right-click, select Export 2 items….
- Save as a .p12 file and set a password for the file.
Register Test Devices
- In the Apple Developer Portal – Devices add the devices you want to use for testing.
Create an ad-hoc provisioning profile
- Go to the Profiles tab
- Create a new Ad Hoc Distribution Profile
- In Select an App ID, choose an App ID that matches the Ranorex iOS apps you want to sign.
- If Xcode has already created a wildcard App ID for your team, select the available Xcode Wildcard App ID.
- If you don’t have access to Xcode or an Xcode-generated wildcard App ID is not available, create and select a wildcard App ID that matches the Ranorex app bundle IDs. For example, use a wildcard pattern such as
ranorex.*.
This wildcard App ID allows the provisioning profile to match Ranorex apps, such asranorex.rxserviceappandranorex.rxwebbrowseras:
Select the App ID in the profile creation wizard, then click Continue.
- If Xcode has already created a wildcard App ID for your team, select the available Xcode Wildcard App ID.
- Choose the distribution certificate created earlier
- Select the devices you want to install the Ranorex apps on. Enter a descriptive profile name and click Generate
Prepare for Instrumentation in Ranorex
- Copy the following files to your Windows machine where Ranorex is installed:
- The .p12 distribution certificate
- The Ad Hoc provisioning profile
- Download the Ranorex iOS apps (e.g., RxServiceApp) from the Ranorex Mobile Downloads Portal
Install the app by using the Ranorex Instrumentation Wizard
- Connect your iOS device to the Windows machine via USB cable
- Open Ranorex and start the Instrumentation Wizard
- Select Instrument a mobile device, and click Next
- In the Instrument a mobile device window, select iOS, and click Next
- Choose the device you want to instrument and click Next
- On the next screen, switch to the Mobile app testing tab
- Select the IPA file you previously generated
- Upload the provisioning profile
- Upload the .p12 distribution certificate
- Enter the p12 password
- Click Next.
- Ranorex runs the instrumentation process. Once complete, a confirmation message appears indicating Operation successful.