Install RxServiceApp, RxBrowser, and RxMiniKeePass

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

Important: If your iOS device already has Ranorex-signed versions of RxServiceApp, RxBrowser, or RxMiniKeePass installed, uninstall them first before installing and using versions signed with your own Apple certificate.

Devices that don’t have the Ranorex-signed apps installed yet can proceed with the standard installation and signing process.

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

1. Log in to the Apple Developer Portal - Certificates
   
   
2. Select Apple Distribution and click Continue
   
   
3. Next, upload a Certificate Signing Request (CSR)
   1. On your Mac, open Keychain Access
   2. Select Keychain Access > Certificate Assistant > Request a Certificate from a Certificate Authority…
      
      
   3. Select Save to disk and complete the process
      
4. Go back to the Developer portal to upload the CSR file
   
   
5. Download the generated certificate, double-click it to open it in Keychain Access
6. Locate the newly added certificate. Select both the certificate and its associated private key
   
7. Right-click, select Export 2 items…. 
   
8. Save as a .p12 file and set a password for the file.

Register Test Devices

1. In the Apple Developer Portal – Devices add the devices you want to use for testing.
   

Create an ad-hoc provisioning profile

1. Go to the Profiles tab
   
   
2. Create a new Ad Hoc Distribution Profile
   
   
3. In Select an App ID, choose an App ID that matches the Ranorex iOS apps you want to sign. 
   1. If Xcode has already created a wildcard App ID for your team, select the available Xcode Wildcard App ID.
      
   2. 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 as ranorex.rxserviceapp and ranorex.rxwebbrowser as:
      
      Select the App ID in the profile creation wizard, then click Continue. 
      
      
4. Choose the distribution certificate created earlier
   
   
5. Select the devices you want to install the Ranorex apps on. Enter a descriptive profile name and click Generate
   

Prepare for Instrumentation in Ranorex

1. Copy the following files to your Windows machine where Ranorex is installed:
   
   
   1. The .p12 distribution certificate
   2. The Ad Hoc provisioning profile
2. Download the Ranorex iOS apps (e.g., RxServiceApp) from the Ranorex Mobile Downloads Portal

Install the app by using the Ranorex Instrumentation Wizard

1. Connect your iOS device to the Windows machine via USB cable
2. Open Ranorex and start the Instrumentation Wizard
   
   
3. Select  Instrument a mobile device, and click Next
   
   
4. In the Instrument a mobile device window, select iOS, and click Next
   
   
5. Choose the device you want to instrument and click Next
   
   
6. On the next screen, switch to the Mobile app testing tab
   1. Select the IPA file you previously generated
   2. Upload the provisioning profile
   3. Upload the .p12 distribution certificate
   4. Enter the p12 password
      
   5. Click Next.
      
7. Ranorex runs the instrumentation process. Once complete, a confirmation message appears indicating Operation successful.