iosserver

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.

  • For testing on iOS version 7 & higher use the iOS7 Plugin.
  • This will give you control over the whole device OS.

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

  1. Connect the device over the USB cable to the Mac.
  2. Drag the profile (.mobileprovision) and the T-Plan Server app (.ipa) to the iTunes icon in the dock.
  3. Open iTunes.
  4. Select the device under the DEVICES section in the left tree view and click the Sync button at the bottom right corner. This will install the profile on the device. To verify it tap the Settings icon in the iOS home screen and navigate to General->Profiles.
  5. To install the server from 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 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. Install the iPhone Configuration Utility for Windows ("the Utility")
  2. Connect the device over USB and start the Utility
  3. Install the provisioning profile (.mobileprovision):
    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.
  4. Install the server app (.ipa) in the similar manner:
    1. Click Add again. Select the "Mobile Application (.ipa)" item in the "Files of type" drop down. Then select the server .ipa file.
    2. Switch to the Applications tab.
    3. Click the Install button next to the server application.
  5. Tap the T-Plan Server application on the device to start it.

3. T-Plan Server Re-signing Process

Requirements:

  • Mac OS X 10.7 (Mountain Lion) or later.
  • An Apple Developer Account.
  • Xcode installed (v4.x or higher recommended) with the Command Line Tools package. To install the tools:
  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.

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).
  4. Alternative way to get the number is to install an iOS application providing the UDID, such as Emonster's UDID+.
  5. 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. Switch 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>".

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"
  5. The script will create a new re-signed .ipa file with the "Resigned-" prefix.

TROUBLESHOOTING:

The script reports "no identity found"

  • You have provided a wrong certificate name or the certificate is not installed. Revisit Step 3.

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

  • The server application was compiled against Xcode 4.6.2 while your one is much older. Upgrade Xcode and retry.
  • If you already have the latest Xcode and you keep seeing this message it is possible that there are more Xcode installations on your computer and the latest one is not set as the active one. To verify the current setting execute:

xcode-select --print-path

  • To set the active Xcode installation execute:

xcode-select --switch <path>