Skip to content

KOB-50814 update the add iOS devices guide #380

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
tungmhoang wants to merge 5 commits into
base: main
Choose a base branch
from
Open

KOB-50814 update the add iOS devices guide #380

Show file tree
Hide file tree
Changes from 4 commits
Commits
Show all changes
5 commits
Select commit Hold shift + click to select a range
5c07d89
KOB-50814 update the add iOS devices guide regarding establishing tru…
tungmhoang Aug 12, 2025
cb3ad08
KOB-50814 address coderabbit feedbacks
tungmhoang Aug 12, 2025
5b6bd7e
KOB-50814 address coderabbit nitpick comments
tungmhoang Aug 12, 2025
a54f2d3
KOB-50814 fix spacing
tungmhoang Aug 13, 2025
2a534ef
KOB-50814 addressed feedbacks
tungmhoang Aug 20, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Binary file added ...-lab-management/images/device-lab-management-add-ios-screen-changes-to-blue.PNG
View file
Open in desktop
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified ...ges/device-lab-management-ios-add-ios-localhost-system-ios-device-available.PNG
View file
Open in desktop
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified ...anagement/images/device-lab-management-ios-add-ios-standard-lightning-trust.PNG
View file
Open in desktop
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
72 changes: 47 additions & 25 deletions docs/modules/device-lab-management/pages/ios-devices/add-ios-device.adoc
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -28,12 +28,12 @@ See below for an example of the SuperSync15 with the Host port visible.
image::device-lab-management:device-lab-management-add-android-supersync15.PNG[width=600, alt="SuperSync15 with the Host port visible"]

[#network-requirements-wifi-pairing]
== Connect the Mac mini host and the iOS 17.0 to 17.3.1 devices to a network that supports mDNS and Wi-Fi pairing
== Connect the Mac mini host and devices to a network that supports mDNS and Wi-Fi pairing

[IMPORTANT]
This section is only required for *iOS/iPadOS 17.0 to 17.3.1* devices with *Lightning mode* configuration.

Prepare a network that satisfy the following requirements:
Prepare a network that satisfies the following requirements:

* _mDNS UDP Messages_: The devices will broadcast mDNS UDP messages that the Mac mini must be capable of receiving. This communication is facilitated via the UDP port 5353.

Expand Down Expand Up @@ -80,17 +80,22 @@ The steps to establish trust pairing vary between iOS 16 and below and iOS 17 an
[NOTE]
The steps in this section apply to both Standard and Lightning mode.

Check the device screen. Tap **Trust** on the Trust this computer popup:
The device needs to be trusted by the system it is plugged into:

* For Lightning mode, that is the GEM (Dell server).
* For Standard mode, that is the Mac mini host.

After plugging the device to the appropriate system, check the device screen. Tap *Trust* on the *Trust this computer* popup:

image::device-lab-management:device-lab-management-ios-add-ios-trust-this-computer-trust.PNG[width=300,alt="Trust this computer popup, clicking Trust"]

Open **Finder** in the Mac mini host, select the connected device name, and choose **Trust**.
Open *Finder* in the Mac mini host, select the connected device name, and choose *Trust*. If the device appears in Finder but there is no _Trust_ button, skip this step.

image::device-lab-management:device-lab-management-ios-add-ios-trust-iphone-trust.PNG[width=600,alt="Trust this iphone window, clicking Trust"]

Unplug the device, then plug it in again. Wait until the device screen changes to the below before continuing (NOTE: there will also be an *automation running* overlay above the device screen):
Unplug the device, then plug it in again. Wait until the device screen changes as shown below before continuing. There will also be an *automation running* overlay above the device screen.

image::device-lab-management:device-lab-management-add-android-screen-changes-to-blue.PNG[width=300, alt="device screen changes and shows Kobiton name and logo"]
image::device-lab-management:device-lab-management-add-ios-screen-changes-to-blue.PNG[width=300, alt="device screen changes and shows Kobiton name and logo"]

Comment on lines +83 to 99
Copy link

@coderabbitai coderabbitai bot Aug 20, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ Potential issue

Standardize trust wording, capitalization, and platform phrasing (iOS 16 and below)

  • “plugging the device to” → “into”.
  • Use “Trust This Computer” consistently and call it a “prompt”.
  • “Open Finder in the Mac mini host” → “on the Mac mini host”.
  • Alt text: “iphone” → “iPhone”; “popup” → “prompt”.
-After plugging the device to the appropriate system, check the device screen. Tap *Trust* on the *Trust this computer* popup:
+After plugging the device into the appropriate system, check the device screen. Tap *Trust* on the *Trust This Computer* prompt:

-image::device-lab-management:device-lab-management-ios-add-ios-trust-this-computer-trust.PNG[width=300,alt="Trust this computer popup, clicking Trust"]
+image::device-lab-management:device-lab-management-ios-add-ios-trust-this-computer-trust.PNG[width=300,alt="Trust This Computer prompt, tapping Trust"]

-Open *Finder* in the Mac mini host, select the connected device name, and choose *Trust*. If the device appears in Finder but there is no _Trust_ button, skip this step.
+Open *Finder* on the Mac mini host, select the connected device name, and choose *Trust*. If the device appears in Finder but there is no *Trust* button, skip this step.

-image::device-lab-management:device-lab-management-ios-add-ios-trust-iphone-trust.PNG[width=600,alt="Trust this iphone window, clicking Trust"]
+image::device-lab-management:device-lab-management-ios-add-ios-trust-iphone-trust.PNG[width=600,alt="Trust this iPhone prompt, tapping Trust"]
📝 Committable suggestion

‼️ IMPORTANT
Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation. Thoroughly test & benchmark the code to ensure it meets the requirements.

Suggested change
The device needs to be trusted by the system it is plugged into:
* For Lightning mode, that is the GEM (Dell server).
* For Standard mode, that is the Mac mini host.
After plugging the device to the appropriate system, check the device screen. Tap *Trust* on the *Trust this computer* popup:
image::device-lab-management:device-lab-management-ios-add-ios-trust-this-computer-trust.PNG[width=300,alt="Trust this computer popup, clicking Trust"]
Open **Finder** in the Mac mini host, select the connected device name, and choose **Trust**.
Open *Finder* in the Mac mini host, select the connected device name, and choose *Trust*. If the device appears in Finder but there is no _Trust_ button, skip this step.
image::device-lab-management:device-lab-management-ios-add-ios-trust-iphone-trust.PNG[width=600,alt="Trust this iphone window, clicking Trust"]
Unplug the device, then plug it in again. Wait until the device screen changes to the below before continuing (NOTE: there will also be an *automation running* overlay above the device screen):
Unplug the device, then plug it in again. Wait until the device screen changes as shown below before continuing. There will also be an *automation running* overlay above the device screen.
image::device-lab-management:device-lab-management-add-android-screen-changes-to-blue.PNG[width=300, alt="device screen changes and shows Kobiton name and logo"]
image::device-lab-management:device-lab-management-add-ios-screen-changes-to-blue.PNG[width=300, alt="device screen changes and shows Kobiton name and logo"]
The device needs to be trusted by the system it is plugged into:
* For Lightning mode, that is the GEM (Dell server).
* For Standard mode, that is the Mac mini host.
After plugging the device into the appropriate system, check the device screen. Tap *Trust* on the *Trust This Computer* prompt:
image::device-lab-management:device-lab-management-ios-add-ios-trust-this-computer-trust.PNG[width=300,alt="Trust This Computer prompt, tapping Trust"]
Open *Finder* on the Mac mini host, select the connected device name, and choose *Trust*. If the device appears in Finder but there is no *Trust* button, skip this step.
image::device-lab-management:device-lab-management-ios-add-ios-trust-iphone-trust.PNG[width=600,alt="Trust this iPhone prompt, tapping Trust"]
Unplug the device, then plug it in again. Wait until the device screen changes as shown below before continuing. There will also be an *automation running* overlay above the device screen.
image::device-lab-management:device-lab-management-add-ios-screen-changes-to-blue.PNG[width=300,alt="device screen changes and shows Kobiton name and logo"]
🤖 Prompt for AI Agents 
In docs/modules/device-lab-management/pages/ios-devices/add-ios-device.adoc
around lines 83-99, standardize wording and capitalization: change “plugging the
device to” to “plugging the device into”; use “Trust This Computer” consistently
and refer to it as the “prompt” (replace “popup” with “prompt” and any lowercase
variants with the exact capitalization “Trust This Computer”); change “Open
Finder in the Mac mini host” to “Open Finder on the Mac mini host”; update alt
text to use “iPhone” (capitalized) and “prompt” instead of “popup”; ensure the
phrase “Trust” button/selection uses consistent capitalization and that any
parenthetical note about iOS 16 and below remains accurate.

=== iOS 17 and above

Expand All @@ -114,49 +119,66 @@ Standard Mode::
+
--

Open Xcode on the Mac mini host, then navigate to **Window → Devices and Simulators**. Do this before continuing to the next step.
The device needs to be trusted by the Mac mini host it is plugged into.

The Trust *this computer* prompt on the device screen appears, tap **Trust**.
After plugging the device into the Mac mini host, open *Xcode* then navigate to *Window → Devices and Simulators*. Do this before continuing to the next step.

image::device-lab-management:device-lab-management-ios-add-ios-standard-lightning-trust.PNG[width=300,alt="Standard Mode. Trust This Computer popup, clicking Trust"]
When the *Trust this computer* prompt on the device screen appears, tap *Trust*. If the prompt reappears, tap *Trust* again until there is no more prompt.
Copy link
Contributor

@erincbailey erincbailey Oct 3, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Update end - "until there are no more prompts."


The Trust *this computer* prompts will reappear, tap **Trust** again. This time there should be no more **Trust** prompts.
image::device-lab-management:device-lab-management-ios-add-ios-standard-lightning-trust.PNG[width=300,alt="Standard Mode. Trust This Computer popup, clicking Trust"]

--

Lightning mode::
Lightning mode - iOS 17.0 to 17.3.1::
+
--

*For iOS 17.0 to 17.3.1 only*: connect the devices and the Mac mini host to a network that xref:#network-requirements-wifi-pairing[satisfies the requirements].
The device needs to be trusted by both of the following:

Open Xcode on the Mac mini host, then navigate to **Window → Devices and Simulators**. Do this before continuing to the next step.
* The Mac mini host that is paired with the GEM (Dell server)
Copy link
Contributor

@erincbailey erincbailey Aug 20, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Chris said that for a GEM system, plugging the device into the Mac and accepting trust prompts there has no effect. You only need to trust with the GEM. Is that just for core devices above iOS 17.4?

Copy link
Collaborator Author

@tungmhoang tungmhoang Aug 20, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

For iOS 17.0 to 17.3.1 (without CoreDevice), the only way to have the second trust prompt show up is to connect the device to the Mac mini with Xcode opened. Connecting it to the GEM with Xcode opened on the Mac does not display the second trust prompt.
The second trust prompt, when not trusted, will make the device offline.
It's been a while since I performed this process, but things may change with the latest deviceConnect versions. I will have to re-verify on that.

Copy link
Contributor

@erincbailey erincbailey Oct 3, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Did you reverify?

Copy link
Collaborator Author

@tungmhoang tungmhoang Nov 6, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

already did. It's the same behaviour as before.

* The GEM it is plugged into.

Make sure you connect the device **to the Mac mini host** first.
Connect the devices and the Mac mini host to a network that xref:#network-requirements-wifi-pairing[satisfies the requirements].

The Trust *this computer* prompt on the device screen appears, tap **Trust**.
Make sure you connect the device *to the Mac mini host* first.

Open Xcode on the Mac mini host, then navigate to *Window → Devices and Simulators*. Do this before continuing to the next step.

When the *Trust this computer* prompt on the device screen appears, tap *Trust*. If the prompt reappears, tap *Trust* until there is no more prompt.
Copy link
Contributor

@erincbailey erincbailey Oct 3, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

"until there are no more prompts."


image::device-lab-management:device-lab-management-ios-add-ios-standard-lightning-trust.PNG[width=300,alt="Lightning Mode. Trust This Computer popup, clicking Trust"]

In the Mac mini host’s screen, under the **Devices** tab of the **Devices and Simulators** screen, the iOS 17 devices should show up with a yellow warning message like the one below:
In the Mac mini host’s screen, under the *Devices* tab of the *Devices and Simulators* screen, the iOS 17 devices should show up with a yellow warning message like the one below:

image::device-lab-management:device-lab-management-ios-add-ios-device-and-simulator.PNG[width=600,alt="iOS 17 in Devices and Simulators"]

Unplug the device from the Mac mini host and plug it into the Cambrionix hub connected to the GEM.
Wait for the debug symbol transfer to finish, then unplug the device from the Mac mini host and plug it into the Cambrionix hub connected to the GEM.

The *Trust this computer* prompts will reappear, tap **Trust** again. This time there should be no more **Trust** prompts.
The *Trust this computer* prompt will appear again to establish trust pairing with the GEM. Tap *Trust*.

In Xcode’s Devices and Simulators, the iOS 17 devices will now have a globe icon next to it like below:
In Xcode’s _Devices and Simulators_, the iOS 17 devices will now have a globe icon next to it like below:

image::device-lab-management:device-lab-management-ios-add-ios-xcode-device-and-simulator.PNG[width=300,alt="Devices, iphone is connected notification"]

--

Lightning mode - iOS 17.4 and above::
+
--

The device needs to be trusted by the GEM (Dell server) it is plugged into.

After plugging the device into the Cambrionix hub connected to the GEM, the *Trust This Computer* prompt appears. Tap *Trust*.

image::device-lab-management:device-lab-management-ios-add-ios-standard-lightning-trust.PNG[width=300,alt="Lightning Mode. Trust This Computer popup, tapping Trust"]

--

====

Wait until the device screen changes to the below before continuing. There will also be an *automation running* overlay above the device screen (not shown in screenshot).

image::device-lab-management:device-lab-management-add-android-screen-changes-to-blue.PNG[width=300, alt="device screen changes and shows Kobiton name and logo"]
image::device-lab-management:device-lab-management-add-ios-screen-changes-to-blue.PNG[width=300, alt="device screen changes and shows Kobiton name and logo"]

[#preload-ddi-air-gapped]
=== Preload DDI for air-gapped Mac mini hosts
Expand All @@ -178,9 +200,9 @@ Unplug the iOS 17 device from the air-gapped Mac (Standard mode) or the GEM (Lig

Open Xcode.

Tap Trust in the **Trust this computer** popup on the iOS 17 device. The **Trust this computer** prompts will reappear, tap **Trust** again. After this, there should be no more **Trust** prompts.
Tap Trust in the *Trust this computer* popup on the iOS 17 device. The *Trust this computer* prompts will reappear, tap *Trust* again. After this, there should be no more *Trust* prompts.
Copy link
Contributor

@erincbailey erincbailey Aug 20, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

should this say iOS 17 here? It will be dated. Can you just say iOS device?


In the Xcode menu bar, select **Window → Devices and Simulators**. Select the iOS 17 device under the **Devices** tab.
In the Xcode menu bar, select *Window → Devices and Simulators*. Select the iOS 17 device under the *Devices* tab.
Copy link
Contributor

@erincbailey erincbailey Aug 20, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

same comment about iOS 17 - can you just say iOS 17 device


The `Copying shared cache symbols...` message appears. Wait for this process to complete and the message to clear.

Expand All @@ -207,14 +229,14 @@ Repeat the above process for all air-gapped Mac mini hosts with iOS/iPadOS 17 an
Continue with connecting iOS 17 and above devices to the air-gapped Mac mini hosts or the GEM.

[IMPORTANT]
Apple has not published whether the personalized DDI will expire or how long it will last in an air-gapped environment.If connection errors occur and other troubleshooting steps do not resolve the issue, the personalized DDI may be expired, and you will need to repeat this process.
Apple has not published whether the personalized DDI will expire or how long it will last in an air-gapped environment. If connection errors occur and other troubleshooting steps do not resolve the issue, the personalized DDI may be expired, and you will need to repeat this process.

[#_verify_device_is_available_in_kobiton]
== Verify device is available in Kobiton

Open Chrome on the Mac mini, then open *localhost* and log in.

Navigate to **Devices**.The connected device displays as **Available**.
Navigate to *Devices*. The connected device displays as *Available*.

image::device-lab-management:device-lab-management-ios-add-ios-localhost-system-ios-device-available.PNG[width=600,alt="Verifying device is avaiable on Kobiton"]
Comment on lines +239 to 241
Copy link

@coderabbitai coderabbitai bot Aug 20, 2025 •
edited
Loading

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ Potential issue

Fix misspelling in image alt text (“avaiable” → “available”)

Typo in user-facing documentation.

-image::device-lab-management:device-lab-management-ios-add-ios-localhost-system-ios-device-available.PNG[width=600,alt="Verifying device is avaiable on Kobiton"]
+image::device-lab-management:device-lab-management-ios-add-ios-localhost-system-ios-device-available.PNG[width=600,alt="Verifying device is available on Kobiton"]
📝 Committable suggestion

‼️ IMPORTANT
Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation. Thoroughly test & benchmark the code to ensure it meets the requirements.

Suggested change
Navigate to *Devices*. The connected device displays as *Available*.
image::device-lab-management:device-lab-management-ios-add-ios-localhost-system-ios-device-available.PNG[width=600,alt="Verifying device is avaiable on Kobiton"]
Navigate to *Devices*. The connected device displays as *Available*.
image::device-lab-management:device-lab-management-ios-add-ios-localhost-system-ios-device-available.PNG[width=600,alt="Verifying device is available on Kobiton"]
🤖 Prompt for AI Agents 
In docs/modules/device-lab-management/pages/ios-devices/add-ios-device.adoc
around lines 239 to 241, the image alt text contains a typo ("avaiable"); update
the alt attribute in the image macro from alt="Verifying device is avaiable on
Kobiton" to alt="Verifying device is available on Kobiton" so the user-facing
documentation reads correctly.

Copy link
Contributor

@erincbailey erincbailey Oct 3, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

make this change

Copy link

@coderabbitai coderabbitai bot Oct 3, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@erincbailey, great! The typo fix will improve the documentation's professionalism. The change from "avaiable" to "available" in the image alt text is straightforward and will ensure the accessibility text is correct for screen readers and other assistive technologies. 👍

If you found this review helpful, would you consider giving us a shout-out on X?

Thank you for using CodeRabbit!


Expand All @@ -232,7 +254,7 @@ If you see the *deviceControl* warning or the error under the device's name with

Still in Chrome, open the Kobiton web portal and log in using an account with *ADMIN* role.

Select the profile picture and choose **Settings**, then choose **Device Management**.
Select the profile picture and choose *Settings*, then choose *Device Management*.

In the search bar, enter the device’s UDID and select Enter to filter.

Expand Down
Loading