iOS Mobile Device Connection Options on Windows

The following instructions describe the certificate, provisioning profile, and developer disk options that you need to create and use an iOS Mobile Device connection in an Eggplant Functional instance running on Microsoft Windows.

Developer Certificate options

There are three methods you can use to provide the Developer Certificate data:

1. Provide the path to the directory where you saved the Developer Certificate file and password.
2. Provide the Thumbprint (visible when you double-click the certificate in the Certificate Store in Windows > Details and scroll until you find Thumbprint). In this case, you do not need to provide password.
3. Provide the subject (visible when you double-click certificate in the Certificate Store on Windows > Details, scroll until you find subject, and use the CN value). In this case, you do not need a password.

info

Options 2 & 3 require that you add the Developer Certificate to the Certificate Store on Windows as follows:

1. Navigate to the location where you have the webdriveragent.p12 and double-click it. You will see an import pop-up.
2. Proceed through the import steps, clicking Next until the import completes.
3. Navigate to Manage User Certificates > Certificates – Current User > Personal > Certificates and verify that your certificate is available.

Provisioning Profile options

There are three methods you can use to provide the Provisioning Profile data:

1. Provide the path to the directory where you saved the Provisioning Profile file.

2. Provide the name of your profile. You can find the name by opening the Provisioning Profile file in a text editor locating the value of the Name <key/>. Use the <string> value. For example:

   <key>Name</key>
   <string>ThisValue</string>

3. Provide the UUID of your profile. You can find the name by opening the Provisioning Profile with a text editor and locating the value of the UUID <key>. Use the <string> value. For example:

   <key>UUID</key>
   <string>d3fd9d56-1171-4afb-a61f-3bb47efdeaa1</string>

info

Option 2 & 3 require that you add the Provisioning Profile to the default location as follows:

Copy your webdriveragent.mobileprovision file to C:\Users\user-name\AppData\Local\Eggplant\ProvisioningProfiles folder.

Developer Disk

info

• This section is for devices for iOS 16 and earlier. For iOS 17.4 and later devices, the developer disks are mounted automatically, this requires internet connection. Eggplant Gateway automatically fetches the personalized developer disk. See next section for more details.

To establish an iOS Mobile Device connection, Eggplant Functional must be able to access your developer disks.

When you are running Eggplant Functional on Windows, you must copy the appropriate Developer Disks for the platform that you intend to test from a Mac system onto your Windows system.

Take note of the location where you saved the files. This is the path you specify for Developer Disks when you create the Mobile Device-type connection to connect to your mobile device.

Developer Disk for iOS 17.4 and newer

Starting with iOS 17.4 Eggplant Gateway automatically fetches the personalized developer disks.

Server and ports required for the handshake are:

Hosts	Port	Protocol
albert.apple.com	443	TCP
gs.apple.com	443	TCP

More details can be found here.