How to Provision an IPA File for TestGrid iOS Devices

Overview

To install and execute an iOS application on TestGrid devices, the application's IPA file must be provisioned with the UDID of the target TestGrid device. This guide explains how to obtain the device UDID from TestGrid, register the device in the Apple Developer Portal, update the provisioning profile, and generate a new IPA file that can be installed on TestGrid devices.

Prerequisites

Before you begin, ensure you have:

• Access to the TestGrid portal.

• Access to an Apple Developer account.

• Appropriate permissions to manage certificates, devices, and provisioning profiles.

• Access to the application's source code and Xcode project.

• An existing Apple Development or Distribution certificate.

• A provisioning profile associated with the application.

Part 1: Obtain the Device UDID from TestGrid

Step 1: Log in to TestGrid

1. Sign in to the TestGrid portal.

2. Navigate to Real Device Cloud from the left navigation menu.

Step 2: Open Device Information

1. Locate the iOS device on which you want to install the IPA.

2. Click the Info (i) button next to the device.

Step 3: Note the Device UDID

1. Review the device information panel.

2. Copy the following details:

   • Device Name

   • UDID

3. Save these details for use in the Apple Developer Portal.

Part 2: Register the Device in Apple Developer Portal

Step 4: Open Apple Developer Portal

1. Navigate to:

   https://developer.apple.com

2. Sign in using your Apple Developer account.

Step 5: Open Device Management

1. Navigate to Certificates, Identifiers & Profiles.

2. Select Devices from the left menu.

Step 6: Register the TestGrid Device

1. Click the + button.

2. Select Register Device.

3. Enter:

   • Device Name

   • UDID collected from TestGrid

4. Click Continue.

5. Click Register to complete device registration.

Part 3: Update the Provisioning Profile

Step 7: Open Provisioning Profiles

1. Navigate to Profiles within the Apple Developer Portal.

Step 8: Edit the Existing Provisioning Profile

1. Locate the provisioning profile associated with your application.

2. Click Edit.

Step 9: Select the App ID

1. Verify that the correct App ID is selected for the application.

Step 10: Add the TestGrid Device

1. From the device list, select:

   • The newly registered TestGrid device, or

   • All devices, if required.

2. Continue to the next step.

Step 11: Generate the Updated Profile

1. Click Generate.

2. Download the updated provisioning profile to your system.

Part 4: Generate a New IPA File

Step 12: Import the Updated Provisioning Profile

1. Open the downloaded provisioning profile.

2. Import it into Xcode.

Step 13: Configure Code Signing

1. Open the application project in Xcode.

2. Select the project from the left navigation panel.

3. Open Build Settings.

4. Search for Code Sign.

5. Configure both Debug and Release profiles to use the updated provisioning profile.

Step 14: Build and Archive the Application

1. From the Xcode menu, select:

   Product → Archive

2. Generate a new application archive.

3. Export the archive as a new IPA file.

Outcome

Upon completion of this guide, you will have:

• Retrieved the UDID of the target TestGrid device.

• Registered the device in the Apple Developer Portal.

• Updated the application's provisioning profile.

• Generated a new IPA file signed with the updated provisioning profile.

• Prepared the application for installation and execution on TestGrid iOS devices.