iOS device configuration for the Seneca iOS developer

This post has information that will enable you to set up and configure your iOS device, so that you can install and run your apps on the device.

This document was most recently updated in November 2013. It is intended for students in the Mobile App Development – iOS (DPS923 / MAP523) course.

Overview documents:

For Xcode 4 (iOS 6) (for most students in this course) – App Distribution Guide – HTMLPDF

For Xcode 5 (iOS 7) – App Distribution Guide – HTMLPDF

This document will be updated soon for the Fall 2013 semester. Please be patient!

.

Introductory info

As a student in Seneca’s Mobile App Development – iOS course, you are a member of Apple’s iOS Developer University Program. This no-cost membership enables you to access content in the iOS Dev Center, and install the apps that you create on devices (iPhone, iPod touch, iPad).

Your professor is the “administrator” of the program.

This post has step-by-step information on the process. Here are the steps that you will follow:

  1. Register as an Apple developer
  2. Reply to your professor’s request for the email address you used when you registered as an Apple developer
  3. Respond to Apple’s invitation to join the iOS Developer University Program
  4. Configure a device with iTunes
  5. Locate the unique device ID, and send it to your professor
  6. Obtain the digital assets that you need (certificates, provisioning profiles)
  7. Test your work
  8. Save/retain your Developer Profile assets

.

You should quickly read/skim through the rest of this post before you begin the procedure.

You will need the following assets to complete the process:

  1. An iOS device (iPhone, iPod touch, iPad), and its USB attachment cable
  2. Xcode on a Mac
  3. A web browser

.

Steps 1, 2, and 3 – Register, reply, respond

Register as an Apple developer, using the info in this document:

Register as an Apple developer, and writing software for iOS

Then, send your Apple ID to your professor by email.

Your professor will cause the Apple Developer University Program to send you an invitation to join. Reply to accept the invitation.

.

Steps 4 – Configure a device with iTunes

As mentioned above, you can use an iPhone, iPod Touch, or iPad. For the Fall 2013 semester, it must run (a version of) iOS 6 or later.

You can use your own device, or you can borrow an iPod touch from the College, and use it until the end of the Fall 2013 semester.

If you use your own device, it is probably already configured in iTunes. That’s a good start.

If you borrow a device from the College, then read the following section.

If you have more than one device, and wish to use them for development, that is permitted.

.

Configure a “loaner” iPod touch

If you borrow a device from the College, follow the instructions in this section to configure it.

First, you must fill out and sign a loan agreement, which you can obtain from your professor.

A loaner iPod touch has the most recent version of iOS that’s supported on the device. Its battery will likely not be fully-charged. It comes with a USB cable, and a quick start guide/pamphlet (which you should read).

When you power on the unit, you are prompted to connect it to a computer that’s running iTunes. You can use a Windows PC or a Mac to do this, without affecting the ability to use it with Xcode on the Mac. iTunes requires you to create an iTunes Store account. There is no cost to create and maintain an iTunes store account, but you must provide credit card information in the event that you purchase content (music, video, etc.) from the iTunes Store.

If you are new to an iOS device, you are encouraged to add music, apps, and photos to the device. You can also configure and use its Mail.app, as well as Contacts.app, and Calendar.app. Each of these apps will work with existing providers (but not all features are supported with all providers).

.

Step 5 – locate the unique device ID, and email it to your professor

In Xcode, open the Organizer (on the Window menu), and select Devices at the top of the window. Plug in your device. After a few seconds, your device will appear. Select and copy the 40-character “Identifier” string, also known as the unique device ID (UDID).

Paste the result into an email message to your professor. Include the device type (e.g. iPhone 5, iPod touch 4th generation, iPad 3). Your professor (as the iOS Developer University Program admin) will add your device to the list.

If you have more than one device, then do this Step 5 for each device that you wish to use for development.

.

Step 6 – obtain the digital assets that you need

You must have a development (developer) certificate to enable your apps to be installed on a device. In addition, you must have the “team” developer certificate, which identifies you as a member of the Apple Developer University Program for this school.

Next, you must have two provisioning profiles. These are digital entities that enables a developer to install apps on devices. There’s a general provisioning profile for the team, and another for this semester’s version of the course.

.

Xcode 4 has a feature in the “Organizer” window which is intended to make the remaining steps as automatic as possible.

However, it appears that it will not work for us, because we are in the no-fee iOS Developer University Program. Therefore, we must perform some of the steps ourselves by using the following procedure.

There are two versions of the procedure. If you have your own Mac, then you must use the “I have my own Mac” procedure. If you are using a College Mac, then you must use the “I am using a College Mac” procedure.

“I have my own Mac” procedure

Follow the procedure shown below, all steps. However, you do not have to complete steps 1 through 18 in one continuous session.

“I am using a College Mac” procedure

If you are using a College Mac, then you must plan to do the procedure when your professor is available, AND during one continuous session, uninterrupted, on a specific Mac.

The process is interactive, and machine-dependent. You will need your professor’s response to some of your actions, before you are able to continue the procedure. After you successfully complete the procedure, then you will be able to create a portable “developer profile”, which will enable you to work with devices on any Mac.

Before starting the procedure, make sure that your professor is available, and you use the same Mac for the entire procedure. Then:

Then:

  1. Login to the Apple iOS Developer web site, and navigate to the Member Center.
  2. In the Member Center, select the iOS Provisioning Portal. Select the Certificates link in the left-side navigator.
  3. Download the “WWDR intermediate certificate”. Save it to a folder somewhere (on the desktop?).
  4. Start a Mac OS program called Keychain Access. When it loads, click the “login” link in the left-side navigator. The right-side panel / list will probably be empty.
  5. Drag (which copies) the “WWDR intermediate certificate” into the panel / list.
  6. Back in the iOS Provisioning Portal, click the link to create a development certificate.
  7. Read the instructions. Then, follow them. (You will use Keychain Access to create a request for a certificate.)
  8. After you submit your request, notify your professor, who will “approve” the request.
  9. Return to the iOS Provisioning Portal. Click again on the Certificates link, to refresh it.
  10. You will now see your development certificate, ready to download. Do that, and (as above) save it to a folder somewhere.
  11. Drag the certificate into the Keychain Access panel / list. The list will now show four items (two certificates, and two keys).
  12. In the iOS Provisioning Profile, click the Provisioning link in the left-side navigator. A list of Provisioning Profiles appears.
  13. Download two profiles: The “iOS Team Provisioning Profile”, and the “DPS913 APD601 Winter 2012” profile with the highest version (e.g. v02) number.

.

At this point in time, you are almost done with the iOS Provisioning Portal.

Start Xcode. Open the Organizer window, and select the Devices function.

Plug in your device. Wait until it shows up on the Organizer’s left-side navigator, then select it. Organizer will inspect the device, and perform other inventory tasks. Eventually, Organizer will mark your device with a green-coloured dot, which means that it’s ready for the next set of steps.

  1. In Organizer, in the left-side navigator, under the upper-left LIBRARY heading, select Provisioning Profiles.
  2. At the bottom of the right-side panel, you will see an “Import” function. Click it.
  3. Import the “iOS Team Provisioning Profile” item.
  4. After this completes, click Import again, and import the “DPS913 APD601 Winter 2012” item.
  5. Click the “Refresh” button at the bottom of the right-side panel. You may be asked to login to the iOS Provisioning Profile (the Apple Developer / Member Center web site). After doing so, you may or may not see a warning message, which you can ignore.

.

The procedure should be complete. However, before continuing, test it.

.

Step 7 – test your work

In Xcode, open a project. (Open a project that you know will run on your device.)

After the project loads, in the upper-left scheme selector, choose your device (i.e. don’t choose the simulator). Run the program (Command+R). Xcode will compile your program (as it usually does), and then attempt to load it (copy it) to your device. If it is successful, great, you’re almost done. If not, you will have to troubleshoot.

.

Step 8 – export and carry your Developer Profile assets

The last task is to save your developer profile, so that you can keep it with you (maybe on a USB memory stick), and use it in the future on ANY Mac. Here are the steps:

  1. In Xcode, show the Organizer window.
  2. In the left-side navigator, under the upper-left LIBRARY heading, select Developer Profile.
  3. At the bottom of the right-side panel, you will see an “Export” function. Click it.
  4. Follow the procedure, which creates a file. Save this file, keep it safe and secure. Email it to yourself. Copy it to one or more USB keys and/or storage media. You will need this file in the future, whenever you want to install an app on your device, from any Mac.

Note: If you are using your own Mac, you should still save your developer profile. That gives you the option (in the future) of using a different Mac, and importing your developer profile to that Mac.

.

Use a different Mac, and install an app on your device

In the future, on a different Mac, here’s what you will do to be able to install an app on your device:

  1. In Xcode, show the Organizer window, and the Developer Profile content.
  2. At the bottom of the right-side panel, click the “Import” function, and follow its procedure.
  3. Do the normal tasks (i.e. scheme select and Run) to install your app on your device.

.

Summary

This post described the procedure to configure an iOS device for development.

Additional detailed (and complete) information is in this Apple document:

iOS App Development Workflow Guide

If you have problems, make sure that you have followed the procedure, and that you have success at each step in the procedure. If you see an error message, carefully read it, and perform the suggested action(s). You may also simply have to try again, because there may be a network latency delay or connectivity problem.

.


.

.

.

  1. No comments yet.
  1. No trackbacks yet.

Leave a Reply

Fill in your details below or click an icon to log in:

WordPress.com Logo

You are commenting using your WordPress.com account. Log Out / Change )

Twitter picture

You are commenting using your Twitter account. Log Out / Change )

Facebook photo

You are commenting using your Facebook account. Log Out / Change )

Google+ photo

You are commenting using your Google+ account. Log Out / Change )

Connecting to %s

%d bloggers like this: