NOTE: this tutorial only covers how to configure your project in order to package the application as an IPA. It does not cover how to create or migrate a project with or without 3rd party libraries.
NOTE: You will need an Apple Developer or Enterprise account to prepare an .IPA to be distributed.
Creating the Basic Application
- Choose a template for your new project. For this sample application, we will be creating a Single View Application.
- Enter your product name, company identifier, and other configuration options. The product name and company identifier will be combined to generate the Bundle Identifier. This will be used later to determine which provisioning profiles can be used when building and sharing the application.
- In the file list on the left side of the window, select your project and your target. On the Summary tab, notice the Bundle Identifer has been generated based on the values entered in step 2.
- Scroll down and expand the Entitlements section in the Summary tab. In previous versions of Xcode, you were required to create an Entitlements file and create a get-task-allow key. This is no longer necessary. Unless your application requires special permissions surrounding iCloud or Keychain Access, you are not required to create this file. Leave the Enable Entitlements checkbox unchecked.
- Go to the Build Settings tab and scroll down to the Code Signing section. For the two default build configurations (Debug and Release), select your Development Provisioning Profile for Debug and your Ad Hoc Provisioning Profile for Release. Leave Code Signing Entitlements blank.
- In the dropdown in the top left, select Edit Scheme. You will notice that the default build configurations have already been configured based on the build action being performed. If you are performing a Run action (Product -> Run) to test your application on the iOS Simulator or on your device, your app will be built using the Debug configuration, which in turn signs your app with the Development Provisioning Profile. If you are performing an Archive action (Product -> Archive), your app will be built with the Release configuration, which in turn signs your app with your Distribution Provisioning Profile (either Ad Hoc or App Store).
The easiest way to generate an IPA, which can be uploaded to TestFlight, is to archive your applications and share it from the Xcode Organizer.
Generate the IPA
- Change the build target from iPad/iPhone Simulator to iOS Device.
- Under the Product menu, select Archive. This will build your application and code sign it using the Distribution (Ad Hoc or App Store) profile setup in step 5 of the “Creating the Basic Application” section. Once the build has completed the Organizer window will appear. If it does not, open it using CMD-Shift–2 or Window -> Organizer. If you see a message popup saying “codesign wants to sign using key ”privateKey“ in your keychain.”, select Allow or Always Allow.
- Go to the Archives tab in Organizer and select your application, if it was not automatically selected, and choose the archive you wish to share.
- Click the Distribute button. In the next window select “Save for Enterprise or Ad-Hoc Deployment”, and click Next.
- In the Code Signing Identity drop down, select the same Distribution Provisioning Profile specified in the Release configuration from step 5 of the “Creating the Basic Application” section, and click Next. NOTE: When generating an IPA for distribution on TestFlight, you should always use an Ad Hoc Distribution Provisioning Profile for both the Archive and Distribute options.
- Select where you would like to save your IPA and upload to TestFlight.
Entitlements allow you to specify specific capabilities or security permissions for your application, such as configuring iCloud. Every application has a default set of values for certain entitlements. By enabling entitlements you are overwriting those default values. In previous versions of Xcode, the most common entitlement set was setting get-task-allow to false. This caused an enormous amount of confusion. In Xcode 4.3 this entitlement is automatically set based on whether the app was built using a Development or Distribution Provisioning Profile. To setup specific entitlements for your application:
- Create your application using the same basic setups in the “Creating the Basic Application” section.
- Go to the Summary tab for your Target. Check the Enable Entitlements checkbox. This will create a .entitlements file and add it to your project.
- You can setup specific iCloud entitlements and Keychain Access Groups for your application as needed.
Commonly Asked QuestionsQ: Why must I use the same provisioning profile when archiving and generating my IPA?
A: When your application is compiled, information from the provisioning profile used to codesign your application is embedded in the application executable. When you generate your IPA, your application is codesigned again and the provisioning profile used to codesign is added to the IPA as the embedded.mobileprovision file. If there is a mismatch in certain pieces of information between the profile info in the executable and the profile info in the embedded.mobileprovision, this can cause the install to fail.