In this chapter, we’ll show you how to instrument your app using source code on iOS. Simply follow the instructions below. Alternatively, many video tutorials on YouTube detail this process.
Attention
It is recommended you only instrument with source code if you are an experienced iOS developer.
Attention
Whenever you update Ranorex Studio (i.e. use newer automation libraries/Ranorex Service App), reinstrument your apps. Otherwise, automation may not work as intended.
-
Download the automation lib from the Mobile Download Archive on your Mac.
Note
The file size of Ranorex Automation Library is about 30 megabytes. This does not automatically make your app 30 megabytes bigger since it is a universal library and only the parts essential for your app will dynamically be added when compiling it.
-
Open the XCode project of your application under test.
-
To avoid shipping an instrumented app to your customers it is recommended to create a separate target for your app under test. You should select the project file and duplicate the existing target.
-
Rename the newly created target.
Note
As XCode does not automatically update all necessary files, you have to rename them manually. You will have to alter the target itself, the targets .plist file (in the workspace as well as in Build Settings -> Packaging), the targets’ project name (Build Settings -> Packaging) and the schemes name (Product -> Manage Schemes).
-
Add the previously downloaded automation lib to your newly created target.
-
After doing this, the automation lib will be listed in the ‘Linked Binary With Libraries’ list in the ‘Build Phases’ pane of the test target.
-
Add the CFNetwork framework to the list.
Note
Additionally, with iOS 8.3 add the IOKit.framework.
-
In the Build Settings pane of the test, add the switches ‘-ObjC -all_load’ to the option Other Linker Flags.
-
Under the Info tab, add a Bundle display name key (CFBundleDisplayName).
-
Insert the URL schema in the application settings to open the instrumented IPA from RxServices or Ranorex Studio, for more information review the iOS Service App page. Below, an example of a schema:
<key>CFBundleURLTypes</key>
<array>
<dict>
<key>CFBundleTypeRole</key>
<string>Editor</string>
<key>CFBundleURLName</key>
<string>ranorex.your.application.name</string>
<key>CFBundleURLSchemes</key>
<array>
<string>ranorex.your.application.name</string>
</array>
</dict>
</array>
Attention
If a designer implements the existing Apple API, which restricts any schema from running the application, the instrumented IPA does not run within RxServices and Ranorex Studio.
-
Run the RxServices IPA, put it into the background, and next, run the instrumented IPA and put it in the background as well. This makes the application recognizable by the RxServices IPA.
The new IPAs should be displayed in the list of available IPAs in the RxServices application and in Ranorex Studio.
After performing these steps, your project can be built using the newly created target and scheme for your iOS devices as well as simulators.
Note
If you see the debug output ‘RxAutomationEngine init‘ in the console pane, your app has been instrumented successfully.
Note
Because the Ranorex automation lib uses non-public APIs, make sure that you do not submit a Ranorex instrumented app to the app store as your app might be rejected and you might be banned from submitting apps to the app store for a period of time.
To add your device via Wi-Fi, it’s necessary that the application under test is started on your iOS device or simulator.
The development provisioning profile should be used for testing your app and not the distribution provisioning profile.
To improve the object recognition of your app under the test set the accessibility label attribute of your controls 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.