This Document Was Most Recently Updated in January 2013
Total Page:16
File Type:pdf, Size:1020Kb
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 January 2013. It is intended for students in the Apple App Dev CIS280 course (This semester it is CIS290 but in the catalog it is CIS280) Introductory info As a student in CIS280, 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 Many students have already completed these steps, in response to the topics covered in this document: Getting Started . Steps 4 – Configure a device with iTunes As mentioned above, you can use an iPhone, iPod Touch, or iPad. For the Winter 2013 semester, it must run (a version of) iOS 6 or later. if you use your own device, it is probably already configured in iTunes. That’s a good start. [iTunes Optional] If you have more than one device, and wish to use them for development, that is permitted. Step 5 – locate the unique device ID, and email it to your professor Go to http://whatsmyudid.com and submit in Week 1 folder. 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 a provisioning profile. 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. 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 1-15 at your leisure. “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 > All items. 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” KeyChains then “Certificate” Category. 5. Drag (which copies) the “WWDR intermediate certificate” into the “Certificate” Category. 6. Back in the iOS Provisioning Portal, click the Request Certificate to create a development certificate and follow instructions. Certificate Information • User Email Address: [Your Apple Dev ID] • Common Name: First and Last Name all one word, lower case • CA Email Address: [email protected] • Select “Saved to Disk” (Desktop) Click Choose File button to upload CSR (Certificate Signed Request) 7. After you submit your request, notify your professor, who will “approve” the request [Come to my desk or Email Me if at home]. You must wait until I tell you to continue to step 8 8. Return to the iOS Provisioning Portal. Click again on the Certificates link, to refresh it. 9. You will now see your development certificate, ready to download. Do that now. It will download to your Download folder on the Mac. 10. Drag the certificate into the Keychain Access panel / list. The keychain list will now show four new items (two certificates, and two keys). 11. In the iOS Provisioning Profile, click the Provisioning link in the left- side navigator. A list of Provisioning Profiles appears. 12. Download your profile: The “rvccis280_[yourfirstinitallastname]1! profile and iOS Team Provisioning Profile:rvc. Some of you have a 2 at the end of your profile because you submitted 2 UDID’s. ALMOST DONE! •At this point in time, you are almost done with the iOS Provisioning Portal. •Start Xcode. Open Window > Organizer window, and select the Devices function > My Mac. You will need to click enable developer button if it is first time accessing XCode. •Plug in your device to the MAC. Wait until it shows up on the Window > 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-colored dot, which means that it’s ready for the next set of steps. 13. In the Organizer, in the left-side navigator, under the upper-left LIBRARY heading, select Provisioning Profiles. 14. Drag “rvccis280_[yourfirstinitallastname]1.mobileprovision! and iOS Team Provisioning Profile:rvc into Provisioning Profiles. 15. 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 Window > Organizer window. 2. In the left-side navigator, Select LIBRARY > Provisioning Profiles and select rvccis280_[yourfirstinitallastname]1 3. At the bottom of the left-side panel, click the “Export” arrow 4. Follow the procedure, which creates a file. Save this file 5. Do 2-4 again with profile iOS Team Provisioning Profile: rvc 6. Keep file safe and secure. 7. 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. Using a different Mac? 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 above procedure. 3. Do the normal tasks (i.e. scheme select and Run) to install your app on your device. Summary 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. .