ios Ad Hoc Provisioning Quick Guide Applies to: Applications developed for all kinds of ios devices (iphone, ipad, ipod). For more information, visit the Mobile homepage. Summary This article is a quick step-by-step guide to the provisioning of applications for ios devices using Apple Provisioning Portal. It is focused on Ad Hoc distribution, which means the distribution to a closed group of known devices instead of publishing the application via itunes. Author: Christian Klöppel Company: CSC Deutschland Solutions GmbH Created on: 10. May 2011 Author Bio Christian Klöppel is Head of the Mobile Business Center of Excellence at CSC in Germany. Together with a team of dedicated experts, he s focusing on mobilization of enterprise applications (Mobile Strategy, Mobile Application Development, Mobile Security & Mobile Device Management). Christian is part of CSC since 1997. He did development, architecture and project management for a couple of years before he started engaging in mobile business & applications since summer 2010. 2011 SAP AG 1
Table of Contents Introduction... 3 Prerequisites... 3 Process Overview... 3 Assumptions... 3 Apple Provisioning Portal Steps... 3 Obtaining your Development and/or Distribution Certificate... 3 Registering Targeted Devices... 4 Creating the App ID... 4 Generating the Provisioning Profile... 5 Generating and Distributing the App... 7 Creating the Distributable IPA file... 7 Distribution of your App... 7 Related Content... 8 Disclaimer and Liability Notice... 9 2011 SAP AG 2
Introduction This article shows how to generate distributable IPA-Files, containing the app itself and the necessary provisioning profiles for Ad-hoc distribution and deployment to a closed group of known devices, identified by UDID. Prerequisites A Mac Apple s XCode 4 development environment & ios SDK An Apple Developer Certificate (as member of Apple s ios Developer Program) The UDIDs of the devices, the application should be deployed to Process Overview After registering at Apple s Developer Program, you need to obtain a Developer License, register the devices for deployment, create an App ID for your application and create Provisioning Profiles for development and/or distribution. After that, the application will be packaged within an IPA file along with the corresponding Developer Certificate and Provisioning Profiles. Assumptions It is assumed that you have already prepared the basic fundamentals of this process, such as Registered at Apple s Developer Program XCode installed A ready-to-deploy application Apple Provisioning Portal Steps Obtaining your Development and/or Distribution Certificate Your personal certificates are available at Apple s Provisioning Portal (part of the Member Center): 1. Launch your browser and go to http://developer.apple.com 2. Got to Member Center, using the link in the upper right navigation area 3. Log in using your Apple Development Program credentials 4. Chose ios Provisioning Portal on the main navigation page 5. Hit Certificates in the left navigation pane Note: You should find your personal certificates on the "Development and Distribution tabs. If not, you have to obtain these certificates first. Please follow the instructions on the How To tab to do so. If both certificates Development and Distribution are available, go ahead following these steps: 6. Download both certificates to your computer 2011 SAP AG 3
7. Double-click each of certificate files to add them to your keychain management application. The result should look like this: 8. You re done! Registering Targeted Devices This section shows how to register the devices the application should be deployed to: 1. Within Apple s Provisioning Portal, hit Devices on the left navigation pane 2. Click Add Devices on the upper right area of the page 3. Enter a descriptive Device Name and the corresponding 40-character UDID for each device. You can add multiple devices using the + button at the end of the line. Note: The UDID of a device can be found using itunes with the device connected. Open the devices Main Page in itunes and click on the Serial Number. The display will switch between Serial Number and UDID. 4. When done, click Submit to get back to the list of registered devices. 5. You re done! Creating the App ID The App ID is a unique identifier for each application you re developing. Here s how to create it: 1. Within Apple s Provisioning Portal, hit App IDs on the left navigation pane 2. Click New App ID on the upper right area of the page 3. Enter a speaking description for your app. I would suggest using your app s identifier/project name. Look at your project summary in XCode to find this (in this case, we would take UAMmobile ): 4. Leave Bundle Seed ID set to Generate New 2011 SAP AG 4
5. Fill in the complete Bundle Identifier: 6. Hit Submit to get back to the list of all your App IDs 7. You re Done! Generating the Provisioning Profile After you have your certificates installed, your devices registered and the App ID created, we ll go on generating the Provisioning Profile. We will focus the generation of a Distribution Profile, but generation of a Development Profile works similar. Please follow these steps: 1. Within Apple s Provisioning Portal, hit Provisioning on the left navigation pane 2. Open the Distribution tab 3. Click New Profile on the upper right area of the page 4. Select Ad Hoc for Distribution Method, since the application should be distributed and deployed to a closed group of known devices instead of publishing it on the itunes App Store 5. Enter a speaking Profile Name, i.e. your project name in combination with _Distribution to separate it from a possible development profile for the same application 6. Select the App ID your created during the steps above 7. Select the devices the app should be provisioned for 8. Hit Submit to save and get back to the list of all profiles 2011 SAP AG 5
9. It will take a few seconds until the profile will be ready and available for download, so just reload the page to check the status 10. Once the profile is ready, download it to your computer 11. Open XCode 12. Go to Window -> Organizer 13. Click on Devices in the upper middle icon bar 14. Hit Provisioning Profiles on the left navigation pane 15. Open Finder and drag&drop the newly created Provisioning Profile onto the right area of the page. The result should look like this: 16. You re done! 2011 SAP AG 6
Generating and Distributing the App Creating the Distributable IPA file We now have everything ready and in place to generate the final IPA application archive for distribution: 1. Within XCode, select the ios Device Scheme: 2. Select Product -> Archive in the menu bar. XCode will start the compilation of your App. If successful, the Organizer will open showing your application archives: 3. Select the archive just created and click Share 4. Leave the Contents set to ios App Store Package (.ipa) 5. Chose the appropriate iphone Distribution Identity. This should be a combination of your personal Distribution Certificate and the App s Provisioning Profile for Distribution 6. Hit Next 7. You will be asked how your IPA file should be named and where it should be saved. 8. You re done! Distribution of your App You can now send the IPA file to the owners of the devices provisioned during our process. To install the app, they simply have to 1. Start itunes on the local computer 2. Connect their device using the USB iconnector cable 3. Drag &Drop the IPA file on itunes (it should recognize this as an application and put it in the Apps - section automatically) 4. Start the device synchronization 5. Finished! 2011 SAP AG 7
Related Content Apple s Program User Guide for ios Development Apple s ios Dev Center For more information, visit the Mobile homepage. 2011 SAP AG 8
Disclaimer and Liability Notice This document may discuss sample coding or other information that does not include SAP official interfaces and therefore is not supported by SAP. Changes made based on this information are not supported and can be overwritten during an upgrade. SAP will not be held liable for any damages caused by using or misusing the information, code or methods suggested in this document, and anyone using these methods does so at his/her own risk. SAP offers no guarantees and assumes no responsibility or liability of any type with respect to the content of this technical article or code sample, including any liability resulting from incompatibility between the content within this document and the materials and services offered by SAP. You agree that you will not hold, or seek to hold, SAP responsible or liable with respect to the content of this document. 2011 SAP AG 9