Copied to clipboard

iOS setup and troubleshooting

Setup

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

Disable passcode

Note

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.

    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

Install Kobiton's certificate for Network Traffic Capturing

  • Open Safari on your mobile device
  • Enter URL: https://s3.amazonaws.com/kobiton-us-east/downloads/ca-certificate-rsa.cer

    IMG_0001.jpg

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

    IMG_0002.jpg

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

    IMG_0003.jpg

  • Select 'Install' from Warning window

    IMG_0004.jpg

  • Keep choosing 'Install'

    IMG_0005.jpg

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

    IMG_0006.jpg

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

  • Go to Settings, select 'General'

    IMG_0007.jpg

  • Select 'About'

    IMG_0008.jpg

  • Select 'Certificate Trust Settings'

    IMG_0009.jpg

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

    IMG_0010.jpg

  • Click 'Continue' to confirm in enabling Root Certificate

    IMG_0011.jpg

  • Kobiton's certificate is now enabled

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

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

    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 label 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 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)

Feedback

SELECTED

Tip

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

COMMENT

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