<a href=http://www.t-plan.com>T-Plan Home</a>
 T-Plan Robot Enterprise Doc Collection
 20/12/13

T-Plan Robot Enterprise iOS 6 Server

Contents:
1. Overview
2. T-Plan Server Setup
3. T-Plan Server Re-Signing Process

1. Overview

The T-Plan iOS 6 Server enables testing of iOS applications on iOS version 5 & 6, using the iOS Mirror connection.

From the point of T-Plan Robot Enterprise, iOS 5 & 6 applications with the T-Plan Server, can be automated the same way as iOS 7 applications with the iOS Plugin.

2. T-Plan Server Setup

The T-Plan Server is being distributed as an "Ad Hoc" iOS application (.ipa) signed by the T-Plan certificate. To use the server within your organization you will have to re-sign it with your own company certificate, and create a provisioning profile with the list of devices allowed to run the server. This is a one time process and the re-signed application, and the profile, may be then freely distributed to your testers.

The T-Plan Server application and the provisioning profile can be installed onto the device from a Mac OS X 10.7+ or a MS Windows machine. An alternative installation of the profile is to mail it to the device as an email attachment and tap it in the mail client.

Note: If you have already been sent a "Mobile Provision (.mobileprovision)" profile file, then please ignore the T-Plan Server Re-Signing Process above, and continue with the instructions below.

Installation from Mac OS X

Drag the server and profile to iTunes
  1. Reselect the device under the DEVICES section in the left tree view.
  2. Switch to the Apps tab.
  3. Click the Install button next to the T-Plan Server application. The label will change to "Will Install".
  4. Select Applyto install and start the server on the device.
Installation thru iTunes

Installation From MS Windows

The server and the profile may be installed using iTunes for Windows. The process is same as the Mac OS one above. The only difference is that you have to drag the files to the Apps folder under the LIBRARY section of the left menu.

Another option is the iPhone Configuration Utility:

  1.  Select the device under the DEVICES section.
  2. Click Add on the tool bar. Select the "Mobile Provision (.mobileprovision)" item in the "Files of type" drop down at the bottom of the file selector. Then select the downloaded provisioning profile.
  3. Switch to the Provisioning Profiles tab.
  4. Click the Install button next to the profile.
Provisioning profile installation on Windows

3. T-Plan Server Re-signing Process

Requirements:

  1. Start Xcode and select Xcode->Preferences in the menu.
  2. Switch to the Downloads tab.
  3. Select Install next to the Command Line Tools package.
Xcode CLI Tools Installation

Re-signing Process

Step 1: Register the test devices

        NOTE: This step is required only if the test iOS device(s) haven't been registered yet.

  1. Sign in to the Apple Developer Center using your Apple ID.
  2. Select the Devices link under the Member Center->Certificates, Identifiers & Profiles section of the Apple Developer Center.
  3. Register the device(s) that you plan to run the T-Plan Server on. You will need the device UDID (Unique Device Identification Number). One of the many ways to get it is to connect the device over the USB cable to the Mac and use iTunes:
    1. Start iTunes and select the device under the DEVICES section in the left tree view.
    2. Switch to the Summary tab.
    3. Click the Serial Number field. It will change to Identifier (UDID) and display the UDID.
    4. Right click the number and select Copy Identifier (UDID).
Finding the UDID in iTunes
  1. Alternative way to get the number is to install an iOS application providing the UDID, such as Emonster's UDID+.
  2. Once you have the UDID click the "+" button under the Devices section of the portal and complete the device registration.

Step 2: Create the provisioning profile

  1. Navigate to the Provisioning Profiles section.
  2. Click the "+" button to create a new profile:
    1. Select the "Ad Hoc" profile type.
    2. Select the Xcode iOS Wildcard App ID.
    3. Select the appropriate distribution certificate.
    4. Select the devices you wish to allow to run the server on. You must add at least one device.
    5. Provide the profile name, for example "T-Plan Server" and select Generate.
    6. Select Download to download the "T-Plan Server.mobileprovision" file to your local file system.

Step 3: Get the certificate

  1. Go to Member Center->Certificates, Identifiers & Profiles and select the Certificates link in the iOS Apps group.
  2. Download the iOS (iPhone) distribution certificate.
  3. Open the certificate from Downloads or Finder. This will import it into your key chain. Then look at the certificate under the My Certificates screen of the Keychain Access window and jot down the name. It should look like "iPhone Distribution: <name>".
Keychain Access

Step 4: Re-Sign the application

NOTE: This step can be alternatively performed using other applications/scripts allowing to re-sign an .ipa file, such as iResign, AppResigner or the ota-tools. Another option is to call the codesign utility manually from the command line (see here). The script we provide is usually the fastest option.

  1. Create an empty folder and copy the provisioning profile into it.
  2. Download the T-Plan server ZIP file and extract it to the folder. The download link will be provided by the T-Plan support. The archive will contain the server application (.ipa) and the signing script (resign.sh).
  3. Open a terminal window (Applications->Utilities->Terminal) and switch to the folder.
  4. Execute the resign.sh script with the certificate name specified as its argument:
chmod a+x resign.sh; ./resign.sh "iPhone Distribution: Company XYZ"
The script will create a new re-signed .ipa file with the "Resigned-" prefix.

TROUBLESHOOTING:

The script reports "no identity found"

The script reports "object file format unrecognized, invalid, or unsuitable"

xcode-select --print-path
To set the active Xcode installation execute:

xcode-select --switch <path>