1. Kobiton
  2. Device Lab Management
  3. Kobiton Desktop

iOS Setup and Troubleshooting

Setup

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

    ios-auto-update.png

  • 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.

    ios-auto-update-itunes.jpg

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

ios-delete-patch.jpg

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.

    passcode.png

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.

    ios-settings-dev-uiautomation.jpg

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

    ios-settings-safari-advance-webinspector.jpg

FAQ and Troubleshooting

FAQ

  1. Handle software update dialog on iOS devices

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

    software-update-01.png

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

    software-update-02.png

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

    software-update-03.png

  2. Handle trust this computer dialog on iOS devices

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

      trust-this-computer.png

    • 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

Troubleshooting

Issue - "Trust This Computer" dialog on iOS devices

  1. Identify problem

    • Desktop App shows error message re: Trust

    cannot-connect-problem.png

    • Double check in Xcode

      • Open Xcode > Window > Devices

      observe-in-Xcode.png

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

    observe-in-Xcode-2.png

  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

    initializing-problem.png

  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

    ios-settings-dev-uiautomation.jpg

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

    ios-settings-safari-advance-webinspector.jpg

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:

mceclip0.png

  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: https://www.apple.com/certificateauthority/

    • 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