iOS Service App

This quick starting guide shows you how to properly use the new iOS RxServiceApp to create automated tests and how to prepare your iOS project so that start/stop app functionality can be used.

The following step-by-step instructions are based on Xcode 6.

If the app will be instrumented manually, please do the following steps to register the custom URL scheme so that the starting and stopping will work correctly:

1. Open your Project in Xcode.
2. Select your project project navigation directory
3. Select the Info tab from the Options section.
   
   
4. In the above screenshot, expand the last option URL Types. You will see (+) icon, click it to add URL Types.
   
   
5. You need to add an identifier and URL Scheme. The identifier is the application bundle identifier and the URL Scheme you need to add is identifier but add ranorex before the identifier. For example application identifier is com.demoapp then the URL Scheme will be ranorex.com.demoapp
   

Note: If no URL scheme is set, the app under test cannot be launched and you will get an error message when you try to start the app with Ranorex. In the app list of the iOS RxServiceApp there will be also a warning message “Can’t launch”.

After Instrumenting and deploying the app for the first time, start the app manually once.

The newly instrumented and deployed app needs to be started manually for the first time so that it gets registered at the RxServiceApp.

If the app is instrumented with Ranorex Studio on the Windows machine, the correct URL scheme will be set automatically.

Due to restrictions in Apple API, it may occur that the instrumented IPA is not able to run from Ranorex Studio, while RxServices application is in the background mode. It is recommended to perform any test while the instrumented IPA is in the foreground.

To use the new start/stop functionality via USB or WiFi, make sure that the RxServiceApp is running and is active on the device. You can either use the instrumentation wizard to deploy the service app as described in ⇢ Instrumentation Wizard – iOS, or download and install the service app on your device from our mobile download archive by scanning the following QR Code or using the following short URL:

Use the QR Code above or the URL https://bitly.com/mArchive to directly access the download archive on your mobile device.

Note
Start/Stop functionality can not be used from the home screen of the device, even if the RxServiceApp is running in the background.

You can still create automated tests without the iOS RxServiceApp. Please note that without the RxServiceApp the start/stop functionality won’t work.

To add a device without the service app, make sure that an instrumented app is running and active on the device.

Note
When using the start functionality, the app under test will be launched multiple times, because it needs to be reset into the initial state.
If you want to create an automated test on an instrumented app that has no URL Scheme, please make sure, that the RxServiceApp is not installed on the device and that the testing app is active on the device.