Home

iPhone Developer Program User Guide

1. 1 Create and Download an Ad hoc Distribution Provisioning Profile in the Provisioning gt Distribution tab as described in the Creating and Downloading a Distribution Provisioning Profile for Ad hoc Distribution section above 2 Open the project and select File gt New File gt iPhone OS gt Code Signing gt Entitlements Choose a template for your new file a iPhone OS Cocoa Touch Classes Code Signing Resource Rules Settings User Interfaces WA macosx AppleScript Cand C Carbon Description Default code signing entitlements file Cocoa Interface Builder SDK Pure Java Pure Python Ruby Sync Services Cancel Previous New Entitlements File Name Entitlements plist Location Desktop HelloWorld Add to Project HelloWorld 4 Targets HelloWorld 2008 Apple Inc All rights reserved Apple Confidential iPhone Developer Program User Guide 46 4 Select the new EntitIments plist file and uncheck the get task allow property Save the Entitlements plist file a Q String Matching Groups amp Files b CAC A Code 0 v ES HelloWorld E Entitlements plist B ReadMe txt gt Classes gt 0 Other Sources gt Resources gt Frameworks _ Products A HelloWorld app g Entitlements plist v Targets gt wy HelloWorld gt 4 Executables Entitlements plist OKey o Oe te gt 8 Errors and Warnings v Ro
2. It is critical that you save your private key somewhere safe in the event that you need to develop on multiple computers or decide to reinstall your system OS Without your private key you will be unable to sign binaries in Xcode and test your application on any Apple device When a CSR is generated the Keychain Access application creates a private key on your login keychain This private key is tied to your user account and cannot be reproduced if lost due to an OS reinstall If you plan to do development and testing work on multiple systems you will need to import your private key onto all of the systems you ll be doing work on 1 To export your private key and certificate for safe keeping and for enabling development on multiple systems open up the Keychain Access Application and select the Keys category 2 Control Click on the private key associated with your iPhone Development Certificate and click Export Items in the menu The private key is identified by the iPhone Developer lt First Name gt lt Last Name gt public certificate that is paired with it 3 Save your key in the Personal Information Exchange p12 file format 4 You will be prompted to create a password which is used when you attempt to import this key on another computer 5 You can now transfer this p12 file between systems Double click on the p12 to install it on a system You will be prompted for the password you entered in Step 4 0 00O Keychain
3. armv6 2008 Apple Inc All rights reserved Apple Confidential iPhone Developer Program User Guide 38 3 At the Project level delete the code signing identity in the build pane and set the provisioning profile the the default setting Ensure the Configuration in this window is set to Distribution Comments Configuration Q Search in Build Settings show AllSetings 1 Setting Value z Architectures Additional SDKs Architectures Standard iPhone OS armv6 Base SDK Device iPhone OS 2 0 Build Active Architecture Only o Valid Architectures armv6 Build Locations Build Products Path build Intermediate Build Files Path build Per configuration Build Products Path build Distribution iphoneos Per configuration Intermediate Build Files Path build HelloWorld build Distribution iphoneos Precompiled Headers Cache Path var folders aa aadQd XtEu4g2 73LZjidk TM C Build Options Build Variants normal Debug Information Format DWARF with dSYM File Enable OpenMP Support am Generate Profiling Code B Precompiled Header Uses Files From Build Di M Scan All Source Files for Includes o Code Signing Code Signing Entitlements Y Code Signing Identity Any iPhone OS Device Y Code Signing Provisioning Profile Any iPhone OS Device Default Provisioning Profile for Code Signing Identity Code Signing Resource Rules Path iphoneos2 0 ResourceRules plist Other Code Signing Flags VCompiler Version
4. gt _ My iPhone If you are experiencing problems with your iPhone you can restore gt SHARED its original settings by clicking Restore ao gt PLAYLISTS Options Automatically sync when this iPhone is connected M Sync only checked songs and videos J Manually manage music and videos Capacity Ba n 7 08 GB Video Photos Other E Free Space 64 MB 155 5 MB 598 9 MB 5 08 GB me ae 2008 Apple Inc All rights reserved Apple Confidential iPhone Developer Program User Guide 11 Adding Devices Upon receiving a UDID Team Admins should navigate to the Devices section of the Program Portal and click Add Admins will enter a Device Name as well as the UDID and click Submit E Developer Connection a ADC Member Site Contact Us Dev Centers WWDC ADC on iTunes Information iPhone Developer Program Welcome Pat Lee Lag out Program Portal Exit Program Portal Home Team Manage History Certificates Eee OO App IDs You can add up to 100 device s Enter a name for each device and its ID Finding the Device ID Provisioning Device Name Device ID 40 hex characters Distribution My Development iPod touch 54fa5f4b42c67 1a04e24e19d6f42acd20fe22adf Visit the Apple Store online 1 800 MY APPLE find a retail location or find a reseller Contact Us News amp Feeds Copyright 2008 Apple Inc All rights reserved Terms of Use Privacy Policy Removing Devices from your Development Te
5. ADC on iTunes Information iPhone Developer Program SI aon Program Portal Exit Program Portal Home Team Development Distribution History How To Certificates ee r Create iPhone Development Provisioning Profile Devices App IDs Generate provisioning profiles here To learn more visit the How To section Provisioning Distribution Profile Name My Development Provisioning Profile Certificates M Pat Lee App ID My Application Suite App ID z Devices M My Development iPod touch Cancel Submit online A d a retail id a reseller Contact Us News amp Feeds j Terms of Use Privacy Policy 2008 Apple Inc All rights reserved Apple Confidential iPhone Developer Program User Guide 17 Installing a Development Provisioning Profile All Team Agents Admins and Members can download a Development Provisioning Profile from the Provisioning section of the Portal after it has been created Only those developers whose Apple device IDs and iPhone Development Certificates are included in the provisioning profile will be able to install and test applications on their device 1 In the Provisioning section of the Program Portal click the download button next to the desired provisioning profile 2 Drag the downloaded file into the Organizer window within Xcode or onto the Xcode application icon in the dock This will automatically install the mobileprovision file and create the proper d
6. Access TA Click to lock the login keychain Q Keychains login Eric Kelley nd private key RSA 2048 bit G System e Any D System Roots Kind Date Modified Expires Keychain Eric Kelley private key Copy Eric Kelley Delete Eric Kelley Export Eric Kelley Category All Items Get Info gt Z Passwords Create a Certificate With Eric Kelley E Certificates Request a Certificate From a Certificate Authority With Eric Kelley J My Certificates Create a Certificate Authority With Eric Kelley Keys Secure Notes 2008 Apple Inc All rights reserved Apple Confidential iPhone Developer Program User Guide 9 Assigning Apple Devices to your Team In order to debug your OS X iPhone application on an Apple device a Team Agent or Team Admin must first enter the Unique Device Identifier UDID for each iPhone and iPod touch into the Program Portal The UDID is a 40 hex character string that is tied to a single device similar to a serial number These UDIDs are included in the provisioning profiles created later You can input up to 100 devices on your development team Locating a Unique Device ID with Xcode To find out your device s UDID simply connect your device to your Mac and open Xcode In Xcode navigate to the Window drop down menu and select Organizer The 40 hex character string in the Identifier field is your device s UDID Team Members should send th
7. Apple Confidential lt No selected symbol gt Code 29K Y voidjapplicationDidFinishLaunching UlApplication japplication My YiewController alloc initWithNibName He f Add the view controller s view as a subyview of the window UI iew controllers iew myViewController view iPhone Developer Program User Guide 22 Distribution The distribution area of the iPhone Developer Program Portal is where you will prepare and learn how to submit your iPhone and or iPod touch application for delivery via the App Store or for Ad Hoc distribution Only Team Agents are authorized to prepare and submit applications for distribution The iPhone Developer Program offers two ways for you to Distribute your application either through the App Store utilizing an iTunes Connect account created just for you or through the Ad Hoc Distribution method Whichever method you choose to distribute an application Team Agents will need to complete the following Create and Download an iPhone Distribution Certificate Create and Download a Distribution Provisioning Profile Build your final application in Xcode Preparing your Application for Distribution Prior to distributing your application there are several steps you will need to complete Obtaining your iPhone Distribution Certificate In order to distribute your OS X iPhone application the Team Agent is required by Apple to create an iPhone Distribution Certificate On
8. C C Compiler Version VY Deployment Additional Strip Flags SS 2008 Apple Inc All rights reserved Apple Confidential iPhone Developer Program User Guide 39 4 In the Build Settings Inspector at the Target level enter the code signing identity iPhone Distribution COMPANYNAME This will be the exact same string as found in the common name of your iPhone Distribution Certificate In the diagrams below Apple Inc is the example COMPANYNAME Make sure the Configuration is set to Distribution in the Build Settings Inspector as well les Properties Comments Configuration Q Search in Build Settings Show Setting Architectures Additional SDKs Architectures Standard iPhone OS armv6 Base SDK Device iPhone OS 2 0 Build Active Architecture Only O Valid Architectures armv6 Build Locations Build Products Path build Intermediate Build Files Path build Per configuration Build Products Path build Distribution iphoneos Per configuration Intermediate Build Files Path build HelloWorld build Distribution iphoneos Precompiled Headers Cache Path var folders aa aadQd XtEu4g2 73LZjidk TM C Build Options Build Variants normal Debug Information Format DWARF with dSYM File Enable OpenMP Support B Generate Profiling Code D Precompiled Header Uses Files From Build Di M Scan All Source Files for Includes 0o Code Signing Code Signing Entitlements Y Code Signing Identity Y Code Signing Provisioni
9. Info window select the Build tab and enter iPhone Developer YourFirstName YourLastName in the Code Signing Identity gt Any iPhone OS field setting This is the also the Common Name of your iPhone Development Certificate 2008 Apple Inc All rights reserved Apple Confidential iPhone Developer Program User Guide 19 Code Signing Identity sdk iphoneos iPhone Developer Pat Lee VArchitectures Additional SDKs Architectures Base SDK Build Active Archit Valid Architectures Build Locations Build Products Path Intermediate Build File Per configuration Build Products Pz puild Debug iphoneg Per configuration Intermediate Build Files Path build HelloWorld build Debug iphoneos Precompiled Headers Cache Path jvar folders aa aadQd XtEu4g2 73LZjidk TM Caches com apple Xcode 502 5 Build Options Build Variants normal Debug Information Format DWARF with dSYM File Enable OpenMP Support Generate Profiling Code Precompiled Header Uses Files From Build Di Scan All Source Files for Includes VCode Signing Code Signing Entitlements Y Code Signing Identity Any iPhone OS Device iPhone Developer Pat Lee wY Code Signing Provisioning Profile Any iPhone OS Device My Development Provisioning Profile Code Signing Resource Rules Path iphoneos2 0 ResourceRules plist Other Code Signing Flags VCompiler Version C C Compiler Version Deployment Additional Strip Flags Alternate Install Group nitin Alternate Insta
10. Y My Development Provisioning Profile Code Signing Resource Rules Path Other Code Signing Flags _ Compiler Version C C Compiler Version Deployment Additional Strip Flags Alternate Install Group nitin Alternate Install Owner nitin Alternate Install Permissions u w go w a rX Alternate Permissions Files Deployment Location o Deployment Postprocessing o Deployment Target Mac OS X 10 5 2008 Apple Inc All rights reserved Apple Confidential iPhone Developer Program User Guide 21 5 Back in the Project Window select Device iPhone OS 2 0 Project Setting from the Device Debug drop down menu in the upper left hand corner m HelloWorldAppDelegate m HelloWorld Simulator iPhone OS 2 0 Debug Release V A HelloWorld ich igate h gate m E dridAppDelegate m 1 4 swlontrol ler h HelloWorld My Development iPod touch Y armv6 E Project Symbols m a gt jj Implementation Files gt NIB Files 6 Click Build and Go to install the ap on Hel LoWor Ld4ppDe legate indow ViewController ff Set up the view control ler MyViewController a ViewController self my iewController a iewControl ler faviewController release window addSubview control lers iew window makeKeyAnd isible plication on your Apple device wil Carrier gt 6 29 PM a Hello World Change Greeting 2008 Apple Inc All rights reserved
11. allows Xcode to sign your OS X iPhone application binary The digital certificates you request and download are electronic documents that associate your digital identity with other information including your name email address or business An iPhone Development Certificate is restricted to application development only and is valid for a limited amount of time The Apple Certification Authority can also invalidate revoke a certificate before it expires Generating a Certificate Signing Request To request an iPhone Development Certificate you first need to generate a Certificate Signing Request CSR utilizing the Keychain Access application in Mac OS X Leopard The creation of a CSR will prompt Keychain Access to simultaneously generate your public and private key pair establishing your iPhone Developer identity Your private key is stored in the login Keychain by default and can be viewed in the Keychain Access application under the Keys category To generate a CSR 1 In your Applications folder open the Utilities folder and launch Keychain Access 2 Choose Keychain Access gt Certificate Assistant gt Request a Certificate from a Certificate Authority Note If you have a private key highlighted in the Keychain during this process the resulting Certificate Request will not be accepted by the Program Portal Confirm that you are selecting Request a Certificate From a Certificate Authority and not selecting Request a Ce
12. approximately 5 minutes Close any prompts that iTunes may present during the restore process 2008 Apple Inc All rights reserved Apple Confidential iPhone Developer Program User Guide 14 a00 Organizer Y PROJECTS amp SOURCES Summary v DEVICES Phone Device Name Device Capacity 0 00GB Serial Number n a Identifier 4180923749e0b247b3c379b29e5038c55d0d517e Software Version n a Restoring image 9 complete 7 After the device reboots Xcode again displays the New Device Detected dialog Click Use for Development 8 To complete the OS X iPhone installation launch iTunes and set up the device Set Up Your iPod Name Automatically sync songs to my iPod iTunes can automatically sync your iPod to mirror its music library and playlists each time you connect it to this Mac J Automatically add photos to this iPod iTunes will first sync all of your music to your iPod and then use the remaining space for photos If all of your photos will not fit they will be copied in the order specified in the Photos pane of iPod preferences Done 2008 Apple Inc All rights reserved Apple Confidential KR WN gt iPhone Developer Program User Guide 15 Creating your App ID 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 and Distribution Provisioning Profiles In order
13. build a new application and refer to the Distributing Multiple Applications section above 2008 Apple Inc All rights reserved Apple Confidential iPhone Developer Program User Guide 48 Glossary Below are a list of commonly used terms in the iPhone Developer Program App ID A unique digital fingerprint that OS X iPhone uses to grant your application access to a portion of the Keychain and one part of a Development and Distribution Provisioning Profile Apple device An iPhone or iPod touch Development Team A Development team is a either a single person enrolled in the Individual Program or a Team Agent and group of Team Admins and Team Members in the Standard Program iPhone A combination mobile phone multimedia player and wireless Internet device from Apple Inc iPhone Development Certificate An electronic document that associates a digital identity with other information including a name email address or business An iPhone Development Certificate is restricted to application development only and is valid for a limited amount of time iPhone Distribution Certificate An electronic document that associates a digital identity with other information including a name email address or business An iPhone Distribution Certificate is restricted to application distribution only and is valid for a limited amount of time iPod touch A portable multimedia player and wireless Internet device from Apple Inc iTunes Con
14. collect all the information about your application that will be displayed on the App Store Some data that you will want to gather are Application Name Must conform to guidelines for using Apple trademarks and copyrights e Application Description up to 4000 characters e Device type s the Application can be run on iPhone and or iPod touch e Unique Stock Keeping Unit SKU for each major version of your application e Primary Category e Secondary Category Optional e Game Rating Optional e Unique Version e Application copyright holder e Support URL for the Company e Support Email Address for use by Apple only e End User License Agreement Optional If a EULA is not provided standard iTunes App Store EULA will be applied e Territories application to be distributed in e Application Availability Date e Application Price e Localization desired English Dutch French German Italian Spanish Japanese 2008 Apple Inc All rights reserved Apple Confidential iPhone Developer Program User Guide 43 Preparing your Application Artwork You have the ability to provide several pieces of artwork that will be visible to customers visiting the App Store Some of the assets you may wish to submit with your application are iPhone iPod touch Home Screen Icon Your application binary must contain a flattened square image icon that is 57x57 pixels This icon is what will be displayed on the iPod touch or iPhone home
15. popup Add Groups amp Files Open With Finder v FS HelloWorld E ReadMe txt gt i Classes gt Other Sources gt Resources gt Frameworks w Products HelloWorld app Reveal in Finder Open in Separate Editor Add to Bookmarks Get Info Rename Touch v Targets gt Ay HelloWorld gt 4 Executables gt 8 Errors and Warnings Y Q Find Results gt Qf Bookmarks gt E SCM E Project Symbols gt jj Implementation Files gt NIB Files Untouch Delete Group Preferences No Editor 2008 Apple Inc All rights reserved Apple Confidential iPhone Developer Program User Guide 34 10 To verify your application was built successfully Control Click on the application bundle in Finder and select Show Package Contents Ensure a CodeSignature folder and an embedded mobileprovision file exist in the package If these files are not present Clean all Xcode builds relaunch Xcode and return to Step 1 11 Use the compress option in Finder to create a zip file containing your application C Distribution iphoneos 00 ale 22 Eom Qe gt DEVICES gt Background png C Distribution iphoneos 2 HelloWorld gt SHARED C build HelloWorld build HelloWorld app dSyM Open EE Classes Show Pack Content gt SEARCH FOR HelloWorld_Prefix pch F HelloWorld xcodeproj 7 HelloWorld xib E icon png Info plist main m MainWindow xib ReadMe
16. the provisioning profile was successfully called 2008 Apple Inc All rights reserved Apple Confidential iPhone Developer Program User Guide 41 9 Confirm that the destination path at the very end of the build message is the app you are building For example ProcessingProductPackaging Volumes Data user Library MobileDevice Provisioning Profiles My_Distribution_Provisioning_Profile mobileprovision Volumes Data user projects Distribution iphoneos HelloWorld app embedded mobileprovision cd Volumes Data user projects HelloWorld lt com apple compilers product pkg utility gt Volumes Data user Library MobileDevice Provisioning Profiles 972DCBC8 5FB7 4970 B079 6A9141738355 mobileprovision o Volumes Data user projects Distribution iphoneos HelloWorld app embedded mobileprovision 10 Search for the term CodeSign this will take you to the line in the build log that confirms your application was signed by your iPhone Distribution Certificate 11 For Ad Hoc distribution share your App bundles and iPhone Distribution Provisioning Profile with the owners of the devices specified in the provisioning profile Recipients of the app and mobileprovision files can drag them onto iTunes 7 7 and sync their devices to install 2008 Apple Inc All rights reserved Apple Confidential iPhone Developer Program User Guide 42 Submitting your application via iTunes Connect iTunes Connect is a suite of web based tools cre
17. the tools needed to create debug and optimize Mac OS X and OS X iPhone applications 2008 Apple Inc All rights reserved Apple Confidential
18. to install your application on an OS X iPhone based device you will need to create an App ID n Each App ID consists of a universally unique 10 character Bundle Seed ID prefix generated by Apple and a Bundle Identifier suffix that is determined by a Team Admin If you plan to develop and distribute more than one application the Bundle Identifier needs to be an asterisk at this time Generating an App ID Team Agents or Team Admins should navigate to the App ID section of the Program Portal Click Add ID Enter a common name for your App ID This is a name for easy reference and identification within the Program Portal Enter an asterisk character in the Bundle Identifier free form text field to create your wildcard App ID to be used for all of your applications Click Submit At this time the 10 character Bundle Seed ID is generated and concatenated with the Bundle Identifier you entered This resulting string is your App ID Developer Con nection a ADC Member Site Contact Us Dev Centers ADC on iTunes Information iPhone Developer Program Welcome Pat Lee Log out Program Portal Exit Program Portal Team Manage Certificates ee App iD Devices In order to install your application on an iPhone OS device you need to create an App ID and include it in a Provisioning Profile Each App ID consists of a ten character Bundle Seed ID prefix generated by Apple and a Bundle Identi
19. wish to run your application code Each Development Provisioning Profile will contain a set of iPhone Development Certificates Unique Device Identifiers and an App ID Devices specified within the provisioning profile can be used for testing only by those individuals whose iPhone Development Certificates are included in the profile A single device can contain multiple provisioning profiles Creating a Development Provisioning Profile 1 In the Provisioning section of the Portal Team Admins should click Add on the Development tab 2 Enter a name for the provisioning profile 3 Specify which devices will be associated with the provisioning profile You must specify a device in order for that device to utilize the provisioning profile You can install a provisioning profile on any of your devices however if a device s UDID is not included in the provisioning profile the device cannot run that profile 4 Specify which iPhone Development Certificates will be associated with the provisioning profile You must specify an iPhone Development Certificate in order for the application code signed with that same certificate to run on the device 5 Specify a single App ID for the Development Provisioning Profile Each Development Provisioning Profile can specify only ONE App ID Use the App ID containing the wildcard asterisk character to build all of your applications E Developer Connection a ADC Member Site Contact Us Dev Centers WWDC
20. Certificate Authority Hide Keychain Access Request a Certificate From a Certificate Authority Hide Others Set the default Certificate Authority S ee Evaluate Thawte Personal Freemail Issuing CA Services Quit Keychain Access 3 In the User Email Address field enter your email address Please ensure that the email address entered matches the information that was submitted when you registered as an iPhone Developer 2008 Apple Inc All rights reserved Apple Confidential iPhone Developer Program User Guide 23 4 In the Common Name field enter your Company Organization Department name Please ensure that the name entered matches the information that was submitted when you registered as an iPhone Developer 5 No CA Email Address is required 6 Select the Saved to Disk radio button and if present select Let me specify key pair information and click Continue Certificate Information Enter information for the certificate you are requesting Click Continue to request a certificate from the CA User Email Address TeamAgent MyCompany com X Common Name Company Division Name CA Email Address Request is Emailed to the CA Saved to disk v Let me specify key pair information 2008 Apple Inc All rights reserved Apple Confidential iPhone Developer Program User Guide 24 7 If Let me specify key pair was selected specify a file name and click Save In the foll
21. Phone Distribution Provisioning Profile Devices App IDs Generate provisioning profiles here To learn more visit the How To section Provisioning Distribution Distribution Method App Store O Ad Hoc Profile Name My Distribution Provisioning Profile Distribution Certificate My Company Inc App ID My Application Suite App ID Visit the Apple Store online 1 800 MY APPLE find a retail location or find a reseller Contact Us News amp Feeds Copyright 2008 Apple Inc All rights reserved Terms of Use Privacy Policy 2008 Apple Inc All rights reserved Apple Confidential Oo CON WDM BWN gt iPhone Developer Program User Guide 28 Creating and Downloading a Distribution Provisioning Profile for Ad Hoc Distribution To successfully build your application in Xcode for Ad Hoc release you will need to create and download an Ad Hoc Distribution Provisioning Profile Team Agents should navigate to the Provisioning section of the Program Portal Select the Ad Hoc radio button Enter the name for your Ad Hoc Distribution Provisioning Profile Confirm your iPhone Distribution Certificate has been created and is displayed Select the wildcard App ID to build all of your applications with the Distribution Provisioning Profile Select up to 100 UDIDs which you wish to run your application on Click Submit Click on the name of the Distribution Provisioning Profile to download the mobi
22. Portal will reject the CSR 4 Upon submission Team Admins will be notified via email of the certificate request 5 Once your CSR is approved or rejected by a Team Admin you will be notified via email of the change in your certificate status 2008 Apple Inc All rights reserved Apple Confidential iPhone Developer Program User Guide 6 ADC Member Site Contact Us Developer Connection Dev Centers WWDC ADConiTunes Information iPhone Developer Program MIAS F Uy ent Program Portal Exit Program Portal Development Distribution History The Development Certificate is used to sign a provisioning profile and associate a developer to a registered device Each member of a team may have only one active Development Certificate To learn more visit the How To section Provisioning Distribution How to create a development certificate 1 Generate a Certificate Signing Request CSR with a public key a In your Applications folder open the Utilities folder and launch Keychain Access a Choose Keychain Access gt Certificate Assistant gt Request a Certificate from a Certificate Authority In the Certificate Information window enter or select the following information In the User Email Address field enter your email address In the Common Name field enter your name In the Request is group select the Saved to disk option Click Continue The Certificate Assistant saves a Certificate Signing Request CSR file to your Deskto
23. Store online 1 800 MY APPLE find a retail location or find a reseller Contact Us News amp Feeds Copyright 2008 Apple Inc All rights reserved Terms of Use Privacy Policy Downloading and Installing Development Certificates In the Certificates gt Distribution section of the Portal control click the WWDR Intermediate Certificate link and select Saved Linked File to Downloads to initiate download of the certificate 2 On your local machine double click the WWDR Intermediate certificate to launch Keychain Access and install 3 Upon CSR approval Team Members and Team Admins can download their certificates via the Certificates section of the Program Portal Click Download next to the certificate name to download your iPhone Development Certificate to your local machine 4 On your local machine double click the downloaded cer file to launch Keychain Access and install your certificate Team Members can only download their own iPhone Development Certificates Team Admins have the authority to download the public certificates of all of their Team Members Apple never receives the private key for a CSR The private keys are not available to anyone except the original key pair creator and are stored in the system keychain of that Team Member 2008 Apple Inc All rights reserved Apple Confidential iPhone Developer Program User Guide 8 Saving your Private Key and Transferring to other Systems
24. am 1 To remove a device from your development team navigate to the Devices area of the Program Portal and click the Remove link to the right of the desired device Removing a device from your development team will invalidate provisioning profiles containing that device Affected provisioning profiles will need to be modified in order be downloaded again Editing Devices on your Development Team To edit a device on your development team navigate to the Devices area of the Program Portal and click the Modify link to the right of the desired device You may change the device name without affecting any existing provisioning profile s associated with the device However if you change the device ID you will invalidate any existing provisioning profile s associated with the device Affected provisioning profiles will need to be modified in order be downloaded again 2008 Apple Inc All rights reserved Apple Confidential iPhone Developer Program User Guide 12 Installing OS X iPhone To run your code on an Apple device you will need to install OS X iPhone onto each development device and restore each device to a development state Note Once a pre release version of OS X iPhone is installed on the device you cannot restore the device to an earlier version of OS X iPhone The device may only be used for development and testing purposes until that version of OS X iPhone is publicly released Please DO NOT install the iPho
25. ated for developers to submit and manage their applications for sale via the App Store In iTunes Connect you will be able to check the status of your contract manage users submit your binary metadata and assets Team Agents will find a link to iTunes Connect in the Distribution section of the Program Portal Clicking this link will take you directly to the login page of iTunes Connect Enter the same ApplelD and password you use to log in to the iPhone Developer Program Portal to access iTunes Connect Prior to uploading your application to iTunes Connect you will be asked to review iTunes Distribution Terms amp Conditions as well as gather metadata pertinent to your application Distribution Terms amp Conditions Before beginning the application submission process it is critical that you read and review the distribution Terms and Conditions If your company has a legal department it is recommended that you provide this document to them for review If you plan to sell your application you need to have your paid commercial agreement in place so that it can be posted to the App Store If not your application will not be posted to the App Store until your commercial agreement is signed If your application is free you ve already entered into the freeware distribution agreement by being accepted into the iPhone Developer Program Gathering your Application Metadata Prior to submitting your application it will be helpful for you to
26. ed Headers Cache Path var folders aa aadQd XtEu4g2 73LZjidk TM C Build Options Build Variants normal Debug Information Format DWARF with dSYM File Enable OpenMP Support Hg Generate Profiling Code Precompiled Header Uses Files From Build Di Scan All Source Files for Includes Code Signing Code Signing Entitlements v Code Signing Identity Any iPhone OS Device iPhone Distribution Apple Inc Y Code Signing Provisioning Profile lt Default Provisioning Profile for Code Signing Identity i Code Signing Resource Rules Path Other Code Signing Flags Compiler Version C C Compiler Version GCC System Version 4 0 Deployment Additional Strip Flags bl B Based On Nothing D ogogo After setting all the projects up correctly with the Code Signing Identity and Provisioning Profile set only at the target level do the following each time you build to ensure a successful build process Open the Project Select the Target and open the Build Settings Inspector Confirm you are in the Distribution Configuration Delete the Code Signing Identity iPhone Distribution COMPANYNAME In the Xcode Build Menu select Clean all Targets Re enter the code signing identity iPhone Distribution COMPANYNAME in the Target Build Settings Inspector Build your Project Open the Build Log detail view Search and Confirm the presence of the word embedded this will take you to the line in the build log that shows
27. ediate Build Files Path build HelloWorld build Release iph gt Implementation Files Precompiled Headers Cache Path var folders W0 W0OwilARG2Kf4ZT Build Options Build Variants normal Debug Information Format DWARF with dSYM File Enable OpenMP Support Generate Profiling Code o Precompiled Header Uses Files From Build Di M Scan All Source Files for Includes O Y Code Signing Y Code Signing Identity Any iPhone OS Device iPhone Distribution Apple Inc Y Code Signing Provisioning Profile Any iPhone OS Device WWDR Ad Hoc Distribution Profile 1 Code Signing Resource Rules Path iphoneos2 0 ResourceRules plist v Based On Nothing a 2008 Apple Inc All rights reserved Apple Confidential iPhone Developer Program User Guide 47 6 Build your application in Xcode using the build process described in the Building your Application with Xcode for Distribution section 7 To share your application provide both the compiled application binary AND the Ad Hoc Distribution Provisioning profile to the owners of the devices specified in the Ad Hoc Distribution Provisioning Profile 8 Recipients of the app bundle and mobileprovision file can drag both files onto the iTunes icon in the dock and sync their device to install Both the application and the Ad Hoc Distribution Provisioning Profile will be installed on the device 9 If you have multiple applications to build make sure to relaunch Xcode each time you
28. f the Keychain application The Private Key is housed on the system that originally created the certificate request for the iPhone Distribution Certificate 0 00O Keychain Access E Click to lock the login keychain Q Keychains cf login G System _ System Roots Name Kin Date Modified Expires Keychain v Worldwide Developer Relations private key login iPhone Distribution Apple Inc certificate Dec 19 20 login Category All Items Passwords Certificates My Certificates Keys Secure Notes Smara 5 1l item yy 2008 Apple Inc All rights reserved Apple Confidential iPhone Developer Program User Guide 36 For each project do the following once 1 In the Project Info window duplicate the Release configuration and title it Distribution m General Build Configurations Comments oe Edit configuration list Debug Release Distribution Duplicate Rename Delete Command line builds use 4 2008 Apple Inc All rights reserved Apple Confidential iPhone Developer Program User Guide 37 2 Set the Active SDK to Device and the Active Configuration to Distribution Active SDK v Device iPhone OS 2 0 Project Setting Code a joj Simulator iPhone OS 2 0 fo Active Configuration Debug Release Y Distribution Active Target V A HelloWorld Active Executable HelloWorld My iPhone Active Architecture
29. fier suffix that is Provisioning determined by a Team Admin Distribution If you are creating a suite of applications that share the same Keychain access e g sharing passwords between applications create a single App ID for the entire suite by utilizing a trailing asterisk as a wildcard character e g com domainname or ERE During the application build process Xcode will append any CF Bundle ID you specify in your Xcode project to the App ID in your provisioning profile View the Development Overview of the iPhone Developer Program Portal for detailed information regarding App IDs You no longer need to enter your App ID into your Xcode project Xcode will incorporate the App ID automatically App ID Name App ID Bundle Seed ID Bundle Identifier My Application Suite App ID HHHHHHHHHH Visit the Apple Store online 1 800 MY APPLE find a retail location or find a reseller Contact Us News amp Feeds Copyright 2008 Apple Inc All rights reserved Terms of Use Privacy Policy 2008 Apple Inc All rights reserved Apple Confidential iPhone Developer Program User Guide 16 Creating and Downloading Development Provisioning Profiles A Provisioning Profile is a collection of digital entities that uniquely ties developers and devices to an authorized iPhone Development Team and enables a device to be used for testing A Development Provisioning Profile must be installed on each device on which you
30. file and associate a developer to a registered device Each team may have only one active Distribution Certificate To learn more visit the How To section How to create a Distribution certificate 1 Generate a Certificate Signing Request CSR with a public key a In your Applications folder open the Utilities folder and launch Keychain Access a Choose Keychain Access gt Certificate Assistant gt Request a Certificate from a Certificate Authority a Inthe Certificate Information window enter or select the following information a Inthe User Email Address field enter your email address In the Common Name field enter your name In the Request is group select the Saved to disk option Click Continue The Certificate Assistant saves a Certificate Signing Request CSR file to your Desktop The public private key pair will be generated when you create the Certificate Signing Request CSR if you use the Key Chain Assistant to create the CSR 2 Submit the CSR through the Program Portal to the Admin for approval a Click the Distribution tab a On your local system open the CSR file using TextEdit and copy the entire contents including the BEGIN and END tags Copy all of the contents of the CSR a Click Submit 3 You will be notified by email when your CSR has been approved or rejected kSsSwNxhPwgm da elTuS9ZxW3GwqNFAjm LLAGMBAAGGADANBgkghkiG9wOBAQUF AAOCAQEAfyEvSOrBrfXR9wv 8WL4XWEL6qtorg9y7 o XHOjxDODUZRdX jFJrw 9xGE pUv20
31. he App Store you first need to create and download an App Store Distribution Provisioning Profile These are different than the Development Provisioning Profiles that were used earlier in that Apple will only accept applications if they are built with an App Store Distribution Provisioning Profile Note App Store provisioning profiles do not allow for a distribution built application to be installed on an Apple device To install your distribution ready application on a device you must create an Ad Hoc provisioning profile Team Agents should navigate to the Provisioning section of the Program Portal and select the Distribution tab and click Add Profile Select the App Store radio button Enter the name for your Distribution Provisioning Profile Confirm your iPhone Distribution Certificate has been created and is displayed Select your wildcard App ID to build all of your applications with your single Distribution Provisioning Profile Click Submit Click on the name of the Distribution Provisioning Profile to download the mobileprovision file Drag the mobileprovision onto the Xcode or iTunes 7 7 icon in the dock to install Developer Connection a ADC Member Site Contact Us Dev Centers WWDC ADC on iTunes Information iPhone Developer Program Welcome Pat Lee Log out Program Portal Exit Program Portal Home Team Development Distribution History Certificates i Pee i Create i
32. iPhone Developer Program Standard Program Portal User Guide for OS X iPhone 2 0 iPhone Developer Program User Guide Welcome 3 Getting Started Development 4 Setting up your iPhone Development Team if applicable Obtaining your iPhone Development Certificate Assigning Apple Devices to your Team Installing OS X iPhone Creating your App ID Creating and Downloading Development Provisioning Profiles Running your Development Application on a Provisioned Device Distribution 24 Preparing your Application for Distribution Submitting your application via iTunes Connect Distributing your application with Ad Hoc Distribution Glossary 50 iPhone Developer Program User Guide 1 Welcome Getting Started Welcome to the iPhone Developer Program your destination for all the resources you need to develop test and distribute your OS X iPhone applications The iPhone Dev Center and Program Portal are designed to walk you through each step necessary to get your application from code to customer In order to install and test your application on an Apple device you ll need to complete the following tasks in the Program Portal e Set up your Development Team for those enrolled as a Company e Designate Apple Devices for your Development Team e Request and Authorize iPhone Development Certificates e Create a unique App ID for your Application e Create and Download a Development Provisioning Profile When you are ready to distrib
33. iler Version My Distribution Provisioning Profile iphoneos2 0 ResourceRules plist C C Compiler Version VWNenlowment GCC System Version 4 0 Based On Nothing 2008 Apple Inc All rights reserved Apple Confidential iPhone Developer Program User Guide 32 6 In both the Top Level Project Info window and the Target Info window change the Code Signing Provisioning Profile setting to the desired Distribution Provisioning Profile If no Distribution Provisioning Profile is selectable make sure your Configuration is set to Distribution your Active SDK is set to Device iPhone OS 2 0 and your Distribution Provisioning Profile is installed in Library MobileDevice Provisioning Profile Relaunch Xcode and resume General Build Rules Properties Comments Configuration Qv Search in Build Settings Show Setting Architectures Additional SDKs Architectures Standard iPhone OS armv6 Base SDK Device iPhone OS 2 0 Build Active Architecture Only o Valid Architectures armv6 Build Locations Build Products Path build Intermediate Build Files Path build Per configuration Build Products Path build Distribution iphoneos Per configuration Intermediate Build Files Path build HelloWorld build Distribution iphoneos Precompiled Headers Cache Path var folders aa aadQd XtEu4g2 73LZjidk TM Ca Build Options Build Variants normal Debug Information Format DWARF with dSYM File Enable OpenMP Support Generate Prof
34. iling Code Precompiled Header Uses Files From Build Di Scan All Source Files for Includes Code Signing Code Signing Entitlements Y Code Signing Identity Any iPhone OS Device Y Code Signing Provisioning Profile iPhone Distribution My Company Code Signing Resource Rules Path _ iphoneos2 0 ResourceRules plist Other Code Signing Flags V Compiler Version C C Compiler Version GCC System Version 4 0 VY Nenlovment Based On Nothing Default Provisioning Profile for Code Signing Identity 2008 Apple Inc All rights reserved Apple Confidential iPhone Developer Program User Guide 33 7 In the project window select the Distribution Active Configuration from the overview popup and set the Active SDK to Device iPhone OS 2 0 Q String Matching BA Code a Active SDK Device iPhone OS 2 0 Project Setting Simulator iPhone OS 2 0 Active Configuration Debug Release Y Distribution agaagaeo Active Target v A HelloWorld Active Executable vy HelloWorld My Development iPod touch Active Architecture v armv6 AROM QACAA 4 Implementation Files gt G NIB Files No Editor 8 Click Build Note Your binary must contain a flattened square image icon that is 57x57 pixels This icon is displayed on the iPhone or iPod touch home screen 9 Highlight the app located within the Products sub folder and select Reveal in Finder from the Action
35. irectory Alternatively you can drag the mobileprovision file onto the iTunes 77 icon in the dock or copy the file to home Library MobileDevice Provisioning Profiles If the directory does not exist you will need to create it 0 e 00 Organizer V PROJECTS amp SOURCES Summary Console Crash Logs Screenshot Y DEVICES Name My Development iPod touch Capacity 14 64GB Serial Number 9E80112QW4T Identifier 54faSf4b42c671a04e24e19d6f42acd20fe22adf Software Version 2 0 5A274d Restore iPod Provisioning M My Provisioning Profile Applications e 00 C Provisioning Profiles Lal oo imi oC gt DEVICES Desktop gt 9 Application Support E Devices D Documents gt Assistants E Profiles gt Downloads E Audio Y PLACES Library J Autosave Information E Software Images gt Desktop Movies Caches Music E Calendars A Applications i Pictures ColorPickers S Documents Public E Compositions Sites 0 Favorites gt SEARCH FOR E FontCollections E Fonts i iMovie E Input Methods E Internet Plug ins 9 Keyboard Layouts E Keychains E Logs CJ MobileDevice PreferencePanes E Preferences E Printers E Screen Savers r MyDevProvisioningProfile mobileprovision gt SHARED v yy Y Frv TT VE VOVT EVV VF OP PP E Sounds E Voices II Il Il Il 1 item 37 42 GB available 4 TV VV FF 2008 Apple Inc All rights reserved Ap
36. is string to their Team Admins for input into the Program Portal e080 Organizer A HA ww i823 Ay v Build Clean Run Action b v PROJECTS amp SOURCES Summary Console Crash Logs Screenshot Y DEVICES iPod touch E iPhone Name iPod touch Capacity 14 64GB Serial Number 9E80112QW4T Identifier 54faSf4b42c67 1a04e24e19d6f42acd20fe22adf Software Version 2 0 5A274d Restore iPod Provisioning Applications 2008 Apple Inc All rights reserved Apple Confidential iPhone Developer Program User Guide 10 Locating a Unique Device ID with iTunes 7 7 Alternatively you can also find out your device s UDID using iTunes 77 or later To do this connect your device to your Mac and launch iTunes In iTunes select your device in the Devices section and navigate to the Summary tab Click on the Serial Number label to reveal the Identifier field and the 40 character UDID 000 iTunes crm CHD Summary Info Ringtones Music Photos Podcasts Video Applications iPhone Name My iPhone Applications Capacity 7 08 GB MP Radio Software Version 2 0 amp Ringtones Identifier 10da809d01d77e2bd3a24d2d4066e7caea765mt4 STORE Phone Number 1 415 555 5555 A iTunes Store xe Purchased Purchased on Apple TV Version Purchased on My iPhone Your iPhone software is up to date iTunes will automatically check rrr HECK Puate TONES for an update again on 7 2 08 _ E
37. kYL8Sam2HD84 8fVijc5j CwZ Xn80y98NOWyuFuQgrkuhyOwWCV 1 7W7nzHWIJBO90jxS lwDxCj 7OETK3CAVgyqghFQ8X6 RUGNBtYsHwycQUjjtsL2V8 6rijpq2l0 1TC3ppQAz4Md3C8Wn7YCegOdp2SRyTE4SwGmjMALnfhR7vm7rWR9sXxXL PwAy5 3tk7NHISdp5 MI6CECIvFb 9txSAg 2 DgPWvOUT oBICSRUYWWVU8cGapWicfp pZel Y4xNyPKXxwWZ4n Sn9W7VESyxg END CERTIFICATE REQUEST Visit the Apple Store online 1 800 MY APPLE find a retail location or find a reseller Contact Us News amp Feeds Copyright 2008 Apple Inc All rights reserved Terms of Use Privacy Policy 2008 Apple Inc All rights reserved Apple Confidential iPhone Developer Program User Guide 26 Downloading and Installing iPhone Distribution Certificates In the Certificates gt Distribution section of the Portal Control Click the WWDR Intermediate Certificate link and select Saved Linked File to Downloads to initiate download of the certificate After downloading double click the certificate to launch Keychain Access and install 2 In the same area of the Program Portal click on the name of the iPhone Distribution Certificate to download 3 On your local machine double click the downloaded cer file to launch Keychain Access and install your certificate Saving your Private Key and Transferring to Other Systems It is critical that you save your private key somewhere safe in the event that you need to build your application on multiple Macs or decide to reinstall your system OS Wi
38. leprovision file Drag the mobileprovision onto the Xcode or iTunes 7 7 icon in the dock to install Developer Connection ADC Member Site Contact Us Dev Centers WWDC ADC on iTunes Information iPhone Developer Program Welcome Pat Lee Log out Program Portal Exit Program Portal Team Development Distribution History See Create iPhone Distribution Provisioning Profile Devices App IDs Generate provisioning profiles here To learn more visit the How To section Provisioning Distribution Distribution Method O App Store Ad Hoc Profile Name My Ad Hoc Provisioning Profile Distribution Certificate My Company Inc App ID Devices optional Select up to 100 devices for distributing the final application the final application will run only on these selected devices Select All v Jasmin iPhone M Kellys iPhone C My Development iPod touch Mi Paul iPod touch Visit the Apple Store online 1 800 MY APPLE find a retail location or find a reseller Contact Us News amp Feeds Copyright 2008 Apple Inc All rights reserved Terms of Use Privacy Policy 2008 Apple Inc All rights reserved Apple Confidential iPhone Developer Program User Guide 29 Building your Application with Xcode for Distribution 1 Launch Xcode and open your project 2 If not already completed drag the Distribution Provisioning Profile downloaded from the Program Portal onto the Xcode or iTunes 7 7 icon in the dock o
39. ll Owner nitin Alternate Install Permissions u w go w a rX Alternate Permissions Files Deployment Location E Deployment Postprocessing o Deployment Target Mac OS X 10 5 2008 Apple Inc All rights reserved Apple Confidential iPhone Developer Program User Guide 20 4 Select your Development Provisioning Profile from the Code Signing Provisioning Profile setting Configurations Comments Configuration Qv Search in Build Settings Show Setting Value Architectures Additional SDKs Architectures Standard iPhone OS armv6 Base SDK Device iPhone OS 2 0 Build Active Architecture Only vi Valid Architectures armv6 Build Locations Build Products Path build Intermediate Build Files Path build Per configuration Build Products Path build Debug iphoneos Per configuration Intermediate Build Files Path build HelloWorld build Debug iphoneos Precompiled Headers Cache Path var folders aa aadQd XtEu4g2 73LZjidk TM Caches com apple Xcode 502 S Build Options Build Variants normal Debug Information Format DWARF with dSYM File Enable OpenMP Support Generate Profiling Code Precompiled Header Uses Files From Build Di Scan All Source Files for Includes Code Signing Code Signing Entitlements Code Signing Identity Default Provisioning Profile for Code Signing Identity Any iPhone OS Device Y Code Signing Provisioning Profile iPhone Developer Pat Lee Any iPhone OS Device
40. ly the Team Agent for your team will be able to create this certificate and only this certificate will enable application submission Generating a Certificate Signing Request To request an iPhone Distribution Certificate you first need to generate a Certificate Signing Request CSR utilizing the Keychain Access application in Mac OS X Leopard The creation of a CSR will prompt Keychain Access to simultaneously generate your public and private key pair establishing your iPhone Distribution identity Your private key is stored in the login Keychain by default and can be viewed in the Keychain Access application under the Keys category To generate a CSR 1 In your Applications folder open the Utilities folder and launch Keychain Access 2 Choose Keychain Access gt Certificate Assistant gt Request a Certificate from a Certificate Authority Note If you have a private key highlighted in the Keychain during this process the resulting Certificate Request will not be accepted by the Program Portal Confirm that you are selecting Request a Certificate From a Certificate Authority and not selecting Request a Certificate From a Certificate Authority with lt Private Key gt OTS File Edit View Window Help About Keychain Access Preferences Keychain First Aid Certificate Assistant Open Kerberos Ticket Viewer Create a Certificate Create a Certificate Authority Create a Certificate For Someone Else as a
41. ne OS before registering device UDIDs as installation on non registered devices will render them inoperable 1 Download the OS X iPhone Disk Image dmg from the iPhone Dev Center for the Apple device you are using 2 Connect your device to your Mac close iTunes and launch Xcode 3 Once the device is detected by Xcode select Use for Development when prompted gt New Device Detected iA A new device was connected Device Name iPod Serial Number 9E80112QW4T Would you like to use this device for development EEE Ignore Use for Development 4 In Xcode Navigate to Window gt Organizer There you should see your device and current software version 5 In the Software Version drop down menu select Other Version and navigate in Finder to the OS X iPhone 2 0 ipsw file downloaded from the iPhone Dev Center Click Restore iPod 2008 Apple Inc All rights reserved Apple Confidential AL v PROJECTS amp SOURCES v DEVICES My Development iPod touch 3 Provisioning Applications iPhone Developer Program User Guide 13 Summary Console Crash Logs Screenshot Name My Development iPod touch Capacity 14 64GB Serial Number 9E80112QW4T Identifier 54fa5f4b42c671a04e24e19d6f42acd20fe22adf Software Versior 2 0 5A274d Restore iPoc 1 1 4 4A102 2 0 5A240d Other Version 6 In Xcode the restore proceeds This process should NOT be interrupted it will take
42. nect A suite of web based tools created for developers to submit and manage their applications for sale via the App Store OS X iPhone OS X iPhone comprises the operating system and technologies that you use to run applications natively on iPhone and iPod touch devices Although it shares a common heritage and many underlying technologies with Mac OS X iPhone OS was designed to meet the needs of a mobile environment where user s needs are slightly different Provisioning Profile A set of entities and entitlements allowing applications to be installed and run on an Apple device Team Agent The original person accepted into the iPhone Developer Program for all membership types The Team Agent has access to all functionality in the iPhone Developer Program Portal and is the sole person capable of Distributing an application Team Admin A person on an iPhone Development Team designated by the Team Agent or another Team Admin who has the capability to approve iPhone Development Certificate requests invite Team Members add Apple devices and create App IDs and Development Provisioning Profiles Team Member A person on an iPhone Development Team who can request iPhone Development Certificates and install OS X iPhone applications on an Apple device Unique Device Identifier UDID A 40 character string used to identify a specific Apple device Xcode Apple s premiere development environment for Mac OS X and OS X iPhone and includes all
43. ng Profile Any iPhone OS Device Default Provisioning Profile for Code Signing Identity Code Signing Resource Rules Path iphoneos2 0 ResourceRules plist Other Code Signing Flags VCompiler Version C C Compiler Version GCC System Version 4 0 Deployment Additional Strip Flags Based On Nothing Value Ea X kd Tibak iPhone Distribution Apple Inc Chon dent Issued by Apple Worldwide Developer Relations Certification af Authority Expires Friday December 19 2008 2 03 44 PM PT This certificate is valid gt Trust gt Details 2008 Apple Inc All rights reserved Apple Confidential iPhone Developer Program User Guide 40 5 Select your iPhone Distribution Profile which includes the wildcard App ID from the Code Signing Provisioning Profile drop CON DOWN BP WN down menu a O Target HelloWorld Info General Build Rules Properties Comments Configuration Distribution H Qy Search in Build Settings Show All Settings H Setting Value Architectures Additional SDKs Architectures Standard iPhone OS armv6 Base SDK Device iPhone OS 2 0 Build Active Architecture Only o Valid Architectures armv6 Build Locations Build Products Path build Intermediate Build Files Path build Per configuration Build Products Path build Distribution iphoneos Per configuration Intermediate Build Files Path build HelloWorld build Distribution iphoneos Precompil
44. om the CA User Email Address PatLee mac com Common Name CA Email Address Request is Emailed to the CA Saved to disk v Let me specify key pair information Continue 7 If Let me specify key pair was selected specify a file name and click Save In the following screen select 2048 bits for the Key Size and RSA for the Algorithm Click Continue AOO Certificate Assistant Key Pair Information Specify the key size and algorithm used to create your key pair The key pair is made up of your private and public keys The private key is the secret part of the key pair and should be kept secret The public key is made publicly available as part of the digital certificate Key Size 2048 bits 3 Algorithm RSA HH Learn More Continue 8 The Certificate Assistant will create a CSR file on your desktop Submitting a Certificate Signing Request for Approval 1 After creating a CSR log in to the iPhone Developer Program Portal and navigate to Certificates gt Development and click Add Certificate 2 On your local system open the saved CSR file using a text editor and copy the entire contents including the BEGIN and END tags 3 Paste the entire contents of the CSR into the blank text field and click Submit Note If the Key Size was not set to 2048 bits during the CSR creation process the
45. ormation iPhone Developer Program Welcome Pat Lee Log out Program Portal Home Team Certificates Devices App IDs Provisioning Distribution Exit Program Portal Manage Invitations Tech Support Agreements Invite New Team Members Invite new people to join your team Click Send and email invitations will be sent to the people you specified To invite more than one person click the to create multiple invitations First Name Last Name Email Jonah Kelley JKelley foo com Michelle Tam MTam fao com Canc Visit the Apple Store online 1 800 MY APPLE find a retail location or find a reseller Contact Us News amp Feeds Copyright 2008 Apple Inc All rights reserved Terms of Use Privacy Policy If you need to designate a new Team Agent please contact the ADC Support Team 2008 Apple Inc All rights reserved Apple Confidential iPhone Developer Program User Guide 4 Obtaining your iPhone Development Certificate In the Certificates section of the iPhone Developer Program Portal you can request individual iPhone Development Certificates All iPhone applications must be signed by a valid certificate before they can be run on an Apple device In order to sign applications for testing purposes Team Members need an iPhone Development Certificate A digital identity is an electronic means of identification consisting of a secret private key and a shared public key This private key
46. ot Dictionary Y Q Find Results get task allow Boolean 0 gt f Bookmarks gt E SCM Project Symbols gt i Implementation Files gt NIB Files 5 Select the Target and open the Build settings inspector In the Code Signing Entitlements build setting type in the filename of the new Entitlements plist file including the extension There is no need to specify a path unless you have put the Entitlements plist file somewhere other than the top level of the project foko ReadMe txt HelloWorld Device Release Devica I Release z L lt A J V ED Build aaan anno Tasks info unta amp Files be e ae E ReadMe txt General Build Properties Comments gt m Classes gt Jj Other Sources Q Search in Build Settings gt Resources gt Frameworks 0 Products Setting Value A HelloWorld app V Architectures B Entitlements plist Additional SDKs v Targets Architectures Standard iPhone OS armv6 gt A HelloWorld Base SDK Device iPhone OS 2 0 gt lt 4 Executables Build Active Architecture Only O gt 8 Errors and Warnings Valid Architectures armv6 v Q Find Results Build Locations gt Q Bookmarks Build gt td SCM Intermediate Build Files Path build 5 Per configuration Build Products Path build Release iphoneos w Peqject ee i Per configuration Interm
47. owing screen select 2048 bits for the Key Size and RSA for the Algorithm Click Continue Key Pair Information Specify the key size and algorithm used to create your key pair The key pair is made up of your private and public keys The private key is the secret part of the key pair and should be kept secret The public key is made publicly available as part of the digital certificate Key Size 2048 bits H Algorithm RSA H 8 The Certificate Assistant will create a CSR file on your desktop 2008 Apple Inc All rights reserved Apple Confidential iPhone Developer Program User Guide 25 Submitting a Certificate Signing Request for Approval 1 After creating a CSR log in to the iPhone Developer Program Portal and navigate to Certificates gt Distribution and click the Add Certificate button 2 On your local system open the saved CSR file using a text editor and copy the entire contents including the BEGIN and END tags 3 Paste the entire contents of the CSR into the blank text field and click Submit 4 Approve your iPhone Distribution Certificate Developer Connection ADC Member Site Contact Us Dev Centers WWDC ADC on iTunes Information iPhone Developer Program E Per or toy oot Program Portal Provisioning Distribution Exit Program Portal Development Distribution History The Distribution Certificate is used to sign a provisioning pro
48. p The public private key pair will be generated when you create the Certificate Signing Request CSR if you use the Key Chain Assistant to create the CSR 2 Submit the CSR through the Program Portal to the Admin for approval a Click the Development tab a On your local system open the CSR file using TextEdit and copy the entire contents including the BEGIN and END tags a Copy all of the contents of the CSR a Click Submit 3 You will be notified by email when your CSR has been approved or rejected BEGIN CERTIFICATE REQUEST MICdjCCAV4CAQAWMTEQMA4GA 1 UEAWWHUGFOIExIZTEdMBsGCSaGSIb3 DQEJARYO UGFOTGVIQG LhYy5jb20wggEiMA0GCSqGSib3 DQEBAQUAA4IBDwAwggEKAoIBAQC OSt 89rMd sWagcpH4ZicKgqmbo twr0g 8qrODYSCk 17u8D60PE7zjpCi sfmm3s8P HpWXIkiQG5 MELJo LkAjCDIsYVtLFwCOZSOFemDYAWB75 O6gGApSSfzXG8qk7hEe Cecfl929xz5teT4FebX LUNZMiBeeKns CSVJHUD 1tlZul EcoWO0c DpHSufWYMiB bSco7 16EznVnvFoQxTagnB7 D6Q6HMPK22 u00wUleTScm LPwYOYncAlYGeQOZbIC romZNup2liZMsPAwTfpgTow4hSxVYxbcavYoC TIckiNWnhfkKBQL RrJ9VYIUNL 8DnYzJjpMFS1 qMtSDDvAgMBAAGGADANBgkghkiG9wOBAQUFAAOCAQEAdr0A7R x Visit the Apple Store online 1 800 MY APPLE find a retail location or find a reseller Contact Us News amp Feeds Copyright 2008 Apple Inc All rights reserved Terms of Use Privacy Policy Approving Certificate Signing Requests Team Agents and Team Admins have the authority and responsibility to approve or reject all iPhone Development Certificate requests In orde
49. ple Confidential iPhone Developer Program User Guide 18 Running your Development Application on a Provisioned Device Now that you have an approved iPhone Development Certificate an assigned Apple device and a properly installed Development Provisioning Profile Xcode can now build your application and install it on your development device If you have a single iPhone Development Certificate and iPhone Development Provisioning Profile you don t need to change any settings in Xcode to start running your applications Step by step instructions are 1 Launch Xcode and open your project e080 HelloWorld Device Debug y r a a ea T Em Q7 String Match Overview Action Build Build and Go Tasks Info Editor Search Groups amp Files File Name Code A E E background png v ReadMe txt Button png aw gt Classes Default png a gt _ Other Sources Foundation framework E i fall Resources A HelloWorld app gt __ Frameworks a HelloWorld xib wv b fal Products a HelloWorld_Prefix pch v Targets H HelloWorldAppDelegate h gt Ay HelloWorld m HelloWorldAppDelegate m 29K Wy gt 4 Executables j gt 8 Errors and Warnings v Find Results gt LJ Bookmarks gt E3 SCM E Project Symbols gt a Implementation Files gt a NIB Files Debugging terminated Succeeded 2 Highlight the top level of your project and select the Info icon from the top menu bar 3 In the Project
50. r drag into home Library MobileDevice Provisioning Profiles directory 3 Open the Xcode project and Duplicate the Release configuration in the Configurations pane of the project s Info panel Rename this new configuration Distribution a oy A HelloWorld p Device Debug y v aw V Q String Matching X X Overview Action Build Build and Go Tasks Info Editor Search Groups amp Files II File Name 4 4 Code A v HelloWorld Background png v 5 ReadMe txt Default png E gt Classes Foundation framework E gt Other Sources A Helpman me A ject p ial Resources ale ao Project HelloWorld Info gt lanl FTES u HE General Build Configurations Comments gt Products H H So Se Se ee vy Targets iM d Edit configuration list gt wy HelloWorld Ic Debug gt 4 Executables m gt 8 Errors and Warnings v Q Find Results DEMPUNON gt LJ Bookmarks A gt E SCM Project Symbols gt amp Implementation Files gt NIB Files A Duplicate Rename Delete Command line builds use Release H 2008 Apple Inc All rights reserved Apple Confidential iPhone Developer Program User Guide 30 4 In both the Top Level Project Info window and the Target Info window select the Build tab and set the Configuration to Distribution All Configurations Active Distribu
51. r to approve reject Team Members requests all Team Admins should first submit their own CSR for approval 1 After submitting a CSR for approval Team Admins will be directed to the Development tab of the Certificates section Here CSRs can be approved or rejected by clicking the corresponding action next to each request 2 Once a CSR is approved or rejected the requesting Team Member is notified via email of the change in their certificate status Each iPhone Development Certificate is available to both the Team Member who submitted the CSR for approval and to the Team Admin s 2008 Apple Inc All rights reserved Apple Confidential iPhone Developer Program User Guide 7 Developer Connection ADC Member Site Contact Us Dev Centers WWDC ADC on iTunes Information iPhone Developer Program a Par ee ung cet Program Portal Exit Program Portal Development Distribution History Add Certificate App IDs This is a list of your current certificates which are assigned to members of your team To download a Certificate click the team member s name Provisioning Distribution In addition to your development certificate you will also need to download the WWDR Intermediate Certificate After downloading double click each certificate to launch Keychain Access Then click OK for each certificate Name Expiration Date Provisioning Profiles Status Actions a Pat Lee Pending Reject Approval Visit the Apple
52. rtificate From a Certificate Authority with lt Private Key gt COTS eS File Edit View Window Help About Keychain Access Preferences Keychain First Aid Certificate Assistant Open Kerberos Ticket Viewer Create a Certificate Create a Certificate Authority Services Create a Certificate For Someone Else as a Certificate Authority Hide Keychain Access Request a Certificate From a Certificate Authority Hide Others Set the default Certificate Authority Evaluate Thawte Personal Freemail Issuing CA Quit Keychain Access 3 In the User Email Address field enter your email address Please ensure that the email address entered matches the information that was submitted when you registered as an iPhone Developer 4 In the Common Name field enter your name Please ensure that the name entered matches the information that was submitted when you registered as an iPhone Developer 5 No CA Certificate Authority Email Address is required The Required message will be removed after completing the following step 2008 Apple Inc All rights reserved Apple Confidential iPhone Developer Program User Guide 5 6 Select the Saved to Disk radio button and if prompted select Let me specify key pair information and click Continue Certificate Assistant Certificate Information Enter information for the certificate you are requesting Click Continue to request a certificate fr
53. screen Te Large Application Icon This will be used to feature your application on the App Storefront To be featured prominently on the App Store we recommend you provide an attractive original icon that meets the following requirements 512 x 512 pixels flattened square image 72 DPI jpg jpeg or tiff format 2008 Apple Inc All rights reserved Apple Confidential iPhone Developer Program User Guide 44 Primary Screenshot The primary screenshot will be used as the main screenshot visible on your application product page on the App Store and the one that will also be displayed on the device For best results don t include the iPhone status bar in your screenshots and follow these requirements 320x460 portrait without status bar minimum 480x300 landscape without status bar minimum 320x480 portrait full screen Uploading your Application After completing the above steps iTunes will present an upload mechanism for you to submit your zip file to Apple 2008 Apple Inc All rights reserved Apple Confidential iPhone Developer Program User Guide 45 Distributing your application with Ad Hoc Distribution In addition to distributing applications through the App Store iPhone Developers enrolled in the Standard program have the opportunity to distribute their application outside of the App Store on up to 100 different devices To distribute your application for Ad Hoc Distribution
54. stribution Certificate and create Development and Distribution Provisioning Profiles The Team Agent is the primary contact for the Development Team and is responsible for accepting all iPhone Developer Program agreements e Team Admin Team Admins can invite new Team Admins and Team Members approve digital certificate requests enter devices into the Program Portal and create Development Provisioning Profiles All teams with multiple members require a minimum of two Team Admins including the Team Agent There is no maximum for the number of Team Admins that can be on a team with multiple members e Team Member Team Members can request digital certificates and download Development Provisioning Profiles All three types of members have the ability to test applications on Apple devices 2008 Apple Inc All rights reserved Apple Confidential iPhone Developer Program User Guide 3 Adding Team Admins and Team Members Team Agents and Team Admins can add new Team Members who can have either an Admin or Member role by navigating to the Invitations tab in the Team section of the Program Portal Click Add to invite new people to join your team After hitting Send the Program Portal will generate and deliver an email to the invitee Team Admins will be notified via a separate email when an invitation has been accepted Developer Connection ADC Member Site Contact Us Dev Centers WWDC ADC on iTunes Inf
55. thout your private key you cannot sign binaries in Xcode and there you will be unable to upload your application to the App Store or install your application on any Apple device When a CSR is generated the Keychain Access application creates a private key on your login keychain This private key is tied to your user account and cannot be reproduced if lost due to an OS reinstall If you plan to do development and testing work on multiple systems you will need to import your private key onto all of the systems you ll be doing work on To export your private key and certificate for safe keeping open up the Keychain Access Application and select the Keys category Highlight the private key associated with your iPhone Distribution Certificate and select Export Items from the File menu Save your key in the Personal Information Exchange p12 file format You will be prompted to create a password which will be used when you attempt to import this key on another computer You can now transfer this p12 file between systems Double click on the p12 to install on a system You will be prompted for the password you first entered above 2008 Apple Inc All rights reserved Apple Confidential CON DW MN BW NHN iPhone Developer Program User Guide 27 Creating and Downloading a Distribution Provisioning Profile for App Store Distribution To successfully build your application with Xcode for distribution via t
56. tion Configurations Comments Debug Release V Distribution Configurati Shov Qv Search in Build Settings Edit Configurations Setting Architectures Additional SDKs Value _ Architectures Standard iPhone OS armv6 Base SDK Device iPhone OS 2 0 Build Active Architecture Only Valid Architectures armv6 Build Locations Build Products Path build Intermediate Build Files Path build Per configuration Build Products Path build Distribution iphoneos Per configuration Intermediate Build Files Path build HelloWorld build Distribution iphoneos Precompiled Headers Cache Path var folders aa aadQd XtEu4g2 73LZjidk TM Ca Build Options Build Variants normal Debug Information Format DWARF with dSYM File Enable OpenMP Support Generate Profiling Code Precompiled Header Uses Files From Build Di Scan All Source Files for Includes V Code Signing Code Signing Entitlements Y Code Signing Identity O O M B Any iPhone OS Device iPhone Distribution My Company Y Code Signing Provisioning Profile Any iPhone OS Device My Distribution Provisioning Profile Code Signing Resource Rules Path iphoneos2 0 ResourceRules plist Other Code Signing Flags Compiler Version C C Compiler Version GCC 4 0 Nenlowment Based On Nothing rise 2008 Apple Inc All rights reserved Apple Confidential iPhone De
57. txt Move to Trash Get Info Compress HelloWorld Duplicate Make Alias Quick Look HelloWorld Copy HelloWorld Label x BSB SE More b Il Ja 2008 Apple Inc All rights reserved Apple Confidential iPhone Developer Program User Guide 35 Building Multiple Apps for Distribution and Validating Your Distribution Builds If you wish to build and distribute multiple applications it is necessary that you create a wildcard App ID in the Program Portal with only an asterisk in the Bundle Identifier field This wildcard App ID must be included in a single Distribution Provisioning Profile that will be used to build all of your applications All Distribution Methods Delete any existing Distribution Provisioning Profiles from your Mac in Library MobileDevice Provisions and Library MobileDevice Provisioning Profiles and close Xcode Create a wildcard App ID in the iPhone Developer Program Portal Simply place an asterisk in the Bundle Identifier field of the App ID to create a wildcard App ID Create an iPhone Distribution Provisioning Profile in the Program Portal incorporating the wildcard App ID created above 4 Drag your new iPhone Distribution Provisioning Profile onto the Xcode or iTunes 77 icon in your dock to install it Confirm that both the Private Key the corresponds to your iPhone Distribution Certificate AND the public iPhone Distribution Certificate are located in the Keys category o
58. ute your application your Team Agent will need to complete the following additional tasks in the Portal e Create and Download an iPhone Distribution Certificate e Create and Download a Distribution Provisioning Profile e Build your application with Xcode e Submit your application for Distribution The user guide contains detailed information regarding each of the above steps 2008 Apple Inc All rights reserved Apple Confidential iPhone Developer Program User Guide 2 Development The following topics will inform you about the required steps for installing your code on an Apple device iPhone or iPod touch for development and debugging purposes Setting up your iPhone Development Team if applicable If you have enrolled your company in the iPhone Developer Program you first need to set up your iPhone Development Team in the Team section of the Program Portal If you have enrolled as an Individual in the iPhone Developer Program you are designated the Team Agent and therefore have access to all Program Portal capabilities You can not add any additional team members Team Member Roles and Responsibilities A development team consists of individuals with the following roles Team Agent The Team Agent the original enrollee accepted into the iPhone Developer Program can invite Team Admins and Team Members approve digital certificate requests enter devices into the Program Portal create App IDs obtain an iPhone Di
59. veloper Program User Guide 31 5 In both the Top Level Project Info window and the Target Info window change the Code Signing Identity setting from iPhone Developer to iPhone Distribution YourcompanyName This will be the exact string in the Common Name field of your iPhone Distribution Certificate Rules Properties Comments Configuration Distribution Wee Qv Search in Build Settings Show All Settings ry Setting Architectures Value Additional SDKs Architectures Base SDK Build Active Architecture Only Valid Architectures Build Locations Standard iPhone OS armv6 Device iPhone OS 2 0 O armv6 Build Products Path Intermediate Build Files Path Per configuration Build Products Path Per configuration Intermediate Build Files Path Precompiled Headers Cache Path Build Options build build build Distribution iphoneos build HelloWorld build Distribution iphoneos var folders aa aadQd XtEu4g2 73LZjidk TM Ca Build Variants Debug Information Format Enable OpenMP Support Generate Profiling Code Precompiled Header Uses Files From Build Di Scan All Source Files for Includes V Code Signing normal DWARF with dSYM File O O v O Code Signing Entitlements Y Code Signing Identity Any iPhone OS Device iPhone Distribution My Company Y Code Signing Provisioning Profile Any iPhone OS Device Code Signing Resource Rules Path Other Code Signing Flags Comp

iPhone Developer Program User Guide

Contents

Download Pdf Manuals

Related Search

Related Contents