Feed on

iPhone Setup

I’ve recently mentioned the procedure of application uploading and launching on the device. I find this topic worthy of separate post. I involuntarily associate it with a puzzle of especially exotic kind. And what is much more interesting is that there are at least some members of my team who completely agree with me. So.. Let’s get started.

This guide is for launching your application on the iPhone or iPod Touch device. All steps from this guide divided into two groups on the following criteria: steps marked with letter A are performed by team administrators and those marked with C must be complied by your customers (or someone else to whom you would like to provide an opportunity to launch your applications on device during beta period).

I’m not going to describe here the meaning of all terms, software and other stuff. This is just step-by-spep guide for people who has direct access to the platform and is responsible to resolve such troubles.

1.A Add team member.

Follow Program Portal -> Team -> Manage -> Add to add new team member (full name and email address fields are required).

2.C Accept an invitation.

An invitation is being normally sent to your customer via email specified by admin during making request. Check your email and follow provided link to accept an invitation. Just press Submit button on the resulting page to complete invitation procedure.

3.C Request certificate.

Follow Program Portal -> Certificates and perform all required actions to request certificate. You should also notify your admin after you are done with this step to avoid delays.

4.A Approve certificate.

Follow Program Portal -> Certificates and approve new team member’s certificate.

5.C Download certificate.

Follow Program Portal -> Certificates to download certificate once it has issued status.

6.C Firmware upgrade.

You can download firmware for both iPhone and iPod touch from within you approved member’s account. Follow complete Apple guidelines on firmware upgrade (Program Portal -> Development -> Installing OS X iPhone).

7.C Send your device id to program administrator.

You are not able to register your device yourself because the limitation applied each account during beta period (only 5 devices are allowed to be attached to an account at the moment).

Connect your upgraded device and follow XCode -> Window -> Organizer to copy your unique device id. Email it to your admin. You should also specify the name of your device.

8.A Register customer’s device.

Follow Program Portal -> Devices -> Add to register customer’s device.

9.A Add customer’s device and account to corresponding provisioning profile.

You should also specify App Id you want to attach to this profile. You are allowed to associate each provisioning profile with one of your App Ids.

An App ID is a unique digital fingerprint that OS X iPhone uses to grant your application access to a portion of the Keychain and is one part of your Development Provisioning Profile. In order to install your application on an OS X iPhone based device, you will need to create an App ID for each application you are developing.

10.C Download and install provisioning profile.

Follow Program Portal -> Provisioning and download profile (the one with your device and certificate attached to). After you are done, copy profile to “/home/<user>/Library/MobileDevice/Provisons”. You’ll probably have to create these directories.

11.C Connect your device.

12.C Check whether the provisioning profile you’ve downloaded is correctly installed.

Launch XCode and open Organizer window. You’ll probably need to enable the profile you’ve just downloaded (see Provisioning section).

13.C Add application you want to launch to the device.

XCode Organizer

Press «+» button at Applications section to upload application to the device.

And now I’m going to describe the purpose of various most important steps.

  • Achieving certificate. This step is required to have possibility to build your application for device. The certificate is being used on the stage of signing the code.
  • Upgrading firmware. This step is required because significant changes can be found even between adjacent versions (beta’s) of iPhone SDK. And it is principally impossible to launch you app under 1.x firmware.
  • App signing. This stage is actual only for developers. Customers should not carry about it. Application identifier is being created using administrative account and the project must be correctly configured to be launched on the device with correct provisioning profile installed.
  • Provisioning profile. The profile unites information about set of devices, development certificates and application id. As it follows from the definition it is required to launch the application on the device.

And.. If just anything of this guide appears useful it means that I’m right and Apple has thought up a new quest.