Copied to clipboard

iOS setup and troubleshooting


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

Disable passcode


If the passcode is unavailable from Settings, please skip this step. In other words, the default profile set as Kobition 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.


Install Kobiton's certificate for Network Traffic Capturing

  • Open Safari on your mobile device
  • Enter URL:


  • A message box will appear to ask for your confirmation, click 'Allow'


  • Click 'Install' from Install Profile window, at this step the certificate is not verified yet (observe the status located under section)


  • Select 'Install' from Warning window


  • Keep choosing 'Install'


  • 'Verified' status located under section, indicates that the profile is successfully installed.


  • Change the trust settings of the certificate on iOS 11.x

  • Go to Settings, select 'General'


  • Select 'About'


  • Select 'Certificate Trust Settings'


  • Enable full trust for root certificates by switching the Toggle Button located on '' taskbar


  • Click 'Continue' to confirm in enabling Root Certificate


  • Kobiton's certificate is now enabled


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

        <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 label saying about Trust issue


    • 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 label 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
[MJSONWP] Encountered internal error running command: Error: xcodebuild failed with code 65
[XCUITest] Error: Could not navigate to webview; there are none!
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 configurated 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 regconize 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

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)




You can select a specific word, line of text, or one or more paragraphs to comment.


Please give us some feedback !
Thank you!
  • We are listening,
  • we will do our best to fix this soon