iOS Setup and Troubleshooting


In order to connect iOS devices to Kobiton Desktop Application, please follow these steps:

Turn off auto-update

There are 2 configs need to be turned off:

  • In the Software Update:

    1. Open up the Settings app
    2. Tap on the General settings
    3. In the Software Update, turn Off the Automatic Updates


  • In the iTunes & App Store:

    1. Open up the Settings app
    2. Tap on iTunes & App Store
    3. Under the section titled Automatic Downloads, you’ll see an item called Updates
    4. Tap on the toggle switch to turn it Off so that it goes from green to gray. If it’s already gray, then the setting is already changed and there’s nothing you need to do further.


Note: Setup screen never sleep or with the maximum time allowed in the device.

Delete the iOS update patch (if any):

  1. On your iPhone, iPad, or iPod touch, go to Settings and tap General
  2. Select iPhone Storage or iPad Storage depending on your device
  3. Locate the iOS software download in the list and tap on it
  4. Select Delete Update and confirm you do want to delete it


Disable passcode

Note: If the passcode is unavailable from Settings, please skip this step. In other words, the default profile set as Kobiton profile in this context, you only need to make sure that the passcode is disabled.

  • Go to Settings > Passcode, Select Turn Passcode Off.


Setup developer mode

  • Open Xcode app and wait for it to finish processing the device.

  • To enable UI Automation access Settings > Developer > Enable UI Automation.


  • To enable the Web Inspector access Settings > Safari > Advanced > Web Inspector.


FAQ and Troubleshooting


  1. Handle software update dialog on iOS devices

    • Tap "Remind Me Later" button on "Software Update" dialog


    • Tap "Later" button on "Software Update" dialog


    • Tap "Later" button on "Software Update" dialog


  2. Handle trust this computer dialog on iOS devices

    • Tap "Trust" button on "Trust This Computer" dialog


    • Unplug device

    • Restart device (hold Power button several seconds and swipe turn off then turn on)

    • Plug device

    • Wait for 5-10 seconds to tap Trust button if required

  3. Handle Processing Symbol Files in Xcode for new iOS devices

    • Open Xcode, click on menu Window -> Device to open Device Window

    • Confirm that Xcode sees the plugged iOS device

    • If NOT, see (C.4) Create symbold files for iOS device plugged in first time in Setup Mac machine

  4. Confirm Wildcard App ID is used in iOS provision profile

    • Open Terminal app

    • Navigate to location of .mobileprovision file used in Desktop, run cat .mobileprovision

    • Expect to see

    html <key>AppIDName</key> <string>Xcode iOS Wildcard App ID</string>

    • If NOT, double check (C.2.5) Download kobiton.mobileprovision Provisioning Profile file in Setup Mac machine


Issue - "Trust This Computer" dialog on iOS devices

  1. Identify problem

    • Desktop App shows error message re: Trust


    • Double check in Xcode

      • Open Xcode > Window > Devices


    • Select the failure device, expect to see yellow triangle and warning labels


  2. Action

    • Follow the guideline in ios handle trust this computer in above section.

Issue - "Software Update" dialog on iOS 10+

  1. Identify problem

    • Desktop App shows message saying Initializing forever


  2. Action

    • Follow the guideline in iOS handle software update in above section

Issue - Error in Kobiton log shows "Cannot launch webkit proxy".

  1. Identify problem

    • Enable UI Automation on Developer mode is turned off in your device
  2. Action

    • Turn Enable UI Automation radio on: Settings > Developer > Enable UI Automation radio


Issue - Error in Kobiton log shows:

[MJSONWP] Encountered internal error running command: Error: xcodebuild failed with code 65 [XCUITest] Error: Could not navigate to webview; there are none!

  1. Identify problem

    • Web Inspector from Safari browser is turned off
  2. Action

    • Turn Web Inspector radio on: Safari > Advanced > Web Inspector radio


Issue - Error in Kobiton log shows:

Cannot launch webkit proxy OR [MJSONWP] Encountered internal error running command: Error: xcodebuild failed with code 65 [XCUITest] Error: Could not navigate to webview; there are none! OR 2017-06-01T04:12:54.994Z appium-79de3c497b9f174288a68019040ae4aa25907b44 stdout: [iOS] Attempted to get a list of webview contexts but could not connect to ios-webkit-debug-proxy. If you expect to find webviews, please ensure that the proxy is running and accessible [debug] [iOS] No web frames found. 2017-06-01T04:12:54.995Z appium-79de3c497b9f174288a68019040ae4aa25907b44 stdout: [iOS] Could not find any webviews yet, refreshing/retrying

  1. Identify problem

    • The device hasn't been configured properly.
  2. Action

    • Follow steps at Setup iOS device to apply necessary Settings on iOS device and replug it again.

Issue - Error in Terminal shows:

xcodebuild: command not found xcode-select: error: tool 'xcodebuild' requires Xcode, but active developer directory '/Library/Developer/CommandLineTools' is a command line ...

  1. Identify problem

    • Xcode hasn't been configured properly
  2. Action

Issue - Xcode or MacOSX doesn't recognize iOS devices

  1. Identify problem

    • Either their iTunes app is old or customer is using low quality USB cable.
  2. Action

    • Action 1:

      • Install the latest iTunes app version Apple site

      • Replug the device

    • Action 2:

      • Try with better cable

Issue - unable to register iOS device for use in Apple Developer: user encounters a restart loop on the device (fails to initialize), or see the following error:


  1. Identify problem

    • WWDR certificate (Worldwide Developer Relations - G3 (Expiring 02/20/2030 00:00:00 UTC)) is not in the correct location, or is not installed. Newly generated signing certificates will require a new version of the WWDR certificate to be installed.
  2. Action

    • Download the correct WWDR certificate from this address:

    • Add the certificate to the system keychain on the Mac Mini on which your Kobiton platform instance is running

For Unknown issues (None of above problem is found) on iOS devices

Please do the steps below for fixing

  1. Unplug devices
  2. Restart devices
  3. Plug devices again
  4. Plug / unplug a few times (2-3) to see Trust dialog -> Hit Trust if exists
  5. Turn on developer mode

  6. Enable UI Automation (Settings > Developer > Enable UI Automation)

  7. Turn on: Web Inspector (Settings > Safari > Advanced > Web Inspector)
Was this article helpful?
0 out of 1 found this helpful