Show: Object Pascal C++
Display Preferences

Provisioning

From Appmethod Topics
Jump to: navigation, search

Go Up to Compiler-Related Project Options

Go Up to Tools Options Dialog Box


Tools > Options > Environment Options > Provisioning

Project > Options > Provisioning

Use this dialog box to specify your provisioning profile for a Mac OS X, iOS Device, or Android application.

If you want to submit your Mac OS X application to the Mac App Store, Apple requires a provisioning profile for sandboxing your applications; you do not need a provisioning profile otherwise. You do need a provisioning profile for iOS regardless of the selected platform configuration (Debug, Ad hoc or Application Store). To create signed Android applications that you can install on Android devices where USB debugging is disabled or upload to an application store, you need a keystore file.

Before you can specify your provisioning profile for Mac OS X or iOS applications, you need to obtain your developer and distribution certificates from Apple. For more information, see:

Requirements for Multi-Device Applications

Certificate Names

In some of the fields in the Provisioning page for Mac OS X and iOS you need to enter a certificate name. To find your certificate name, open Keychain Access on the Mac, and double-click My Certificates. You must provide the name of the certificate as seen in the list in Keychain Access, or alternatively only a part (substring) of the certificate name that is enough to distinguish that certificate from other installed certificates (also on the list).

For example, Keychain Access might display:

Mac Developer: <myname> (<code>)

In this case, you can supply "Mac Developer: <myname> (<code>)" in the Mac Developer Profile field, although entering the "<code>" is enough. Alternatively, you can enter just "Mac Developer" if this was the only certificate you had installed for Mac development.

You might have two certificates with the same name if you install certificates for ad hoc distribution and submission to the App Store from the same development team. In this case, you cannot unambiguously define which one of those certificates Appmethod should use, so you must remove the certificate that you do not want to use from the Keychain Access list. For more information, see The Specified Certificate Name Is Ambiguous.

Mobile Provisioning Profile

For iOS applications targeting iOS Device (either the Ad hoc or Application Store platform configuration), you need to specify the path to your Mobile Provisioning Profile file on the Mac.

Finding the Profile in Xcode 4

To find the path to your Mobile Provisioning Profile file in Xcode 4:

  1. Open Xcode on the Mac, and enter the Organizer.
  2. On the left-hand sidebar, select Provisioning Profiles.
  3. On the main view, right-click the target profile, and choose Reveal Profile in Finder. Finder opens with your profile file selected.

Finding the Profile in Xcode 5

Finding this path in Xcode 5 is not so straightforward. You can use, for this purpose, the Apple iPhone Configuration Utility.

To install the iPhone Configuration Utility:

  1. Download the application from http://support.apple.com
    Note: System requirements: Mac OS X 10.6 and later versions.
  2. Double-click the dmg file to uncompress the file.
  3. Double-click the pkg file to start the installation.
  4. The iPhone Configuration Utility wizard guides you through the installation process.
    Note: You need to close Xcode and iTunes to continue the process.

To find the path to your Mobile Provisioning Profile file using the iPhone Configuration Utility:

  1. Open the iPhone Configuration Utility.
  2. On the left-hand sidebar, select Provisioning Profiles.
  3. On the central information window, select the profile for which you want to know the Profile Identifier.
  4. The Profile Identifier appears on the Provisioning Profile pane.

IPhoneConfigurationUtility.png

The path to your profile file must look like /Users/<your user>/Library/MobileDevice/Provisioning Profiles/<filename>.mobileprovision.

The <filename> to include in the path to your profile corresponds to the Profile Identifier. For example, according to the information in the screenshot above:

/Users/<your user>/Library/MobileDevice/Provisioning Profiles/87EE9F70-205D-4768-B10D-3ADC0BBBEC0B.mobileprovision.

Entitlements

For a sandboxed Mac OS X application, you need to set the specific entitlements (access privileges).

Open the Entitlement List page by selecting Project > Options > Entitlement List.

Project Options

These options are available for the current project, by selecting Project > Options > Provisioning.

Options Description

Target, Apply, Save

See Target Options.

Common items

See Common Items on Project Options Pages.

Provisioning Options

Item Description

Build Type

A platform configuration to define its provisioning data. The rest of the fields in the Provisioning page change depending on the selected platform configuration.

For Mac OS X applications, the platform configuration should be OS X - Application Store.

For iOS mobile applications, choose one of the following platform configurations:

  • iOS Device - Debug. Platform configuration to run your application on a device plugged into your Mac. Used during development and debugging.
  • iOS Device - Ad hoc. Platform configuration for testing or informal distribution, with a limited number of devices that can run it.
  • iOS Device - Application Store. Platform configuration to build your application for distribution on the App Store.

For Android applications, the platform configuration should be Android - Application Store.

OS X - Application Store

Item Description

Mac Developer Profile

Enter the name of your 3rd Party Mac Developer Application certificate. This certificate is required for the IDE to code sign your application and for acceptance in the Mac App Store. For more information, see Certificate Names.

3rd Party Installer Profile

Enter the name of your 3rd Party Mac Developer Installer certificate. This certificate represents you as a third party installer, and is required for the IDE to build your Mac OS X application and for acceptance in the Mac App Store. For more information, see Certificate Names.

Note: The Mac AppLoader requires an installer certificate regardless of whether your project contains an installer or not.

iOS Device - Debug

Item Description

Developer Certificate

Enter the name of your iOS developer certificate. For information, see Certificate Names.

iOS Device - Ad hoc

Item Description

Distribution Certificate

Enter the name of your iOS distribution certificate. For information, see Certificate Names.

Mobile Provisioning Profile

Enter the complete path to your distribution profile file. For more information, see Mobile Provisioning Profile.

iOS Device - Application Store

Item Description

Distribution Certificate

Enter the name of your iOS distribution certificate. For more information, see Certificate Names.

Mobile Provisioning Profile

Enter the complete path to your distribution profile file. For more information, see Mobile Provisioning Profile.

Developer Program ID

Enter your developer program ID (or Team ID). You can click Load ID to get the default ID from your Mac, or enter a custom ID manually.

Read the Apple documentation for further information.

Android - Application Store

Item Description

File

The path to the keystore file that contains your signing certificates.

Password

The password of the keystore file.

New Keystore

Opens the Create a new Keystore/Alias wizard to create a new keystore file.

Change Password

Opens a dialog to change the password of your keystore file.

Get Certificates

Retrieves the list of certificates from your keystore file, and populates the Alias in Keystore combo box with that list.

Alias in Keystore

The alias of the certificate from your keystore file to sign.

Alias password

The password of the selected certificate.

Creation date

The date when the selected certificate was created.

Valid since

The date when the selected certificate started being valid, and the date when the certificate expires.

Add Alias

Opens the Create a new Keystore/Alias wizard to add a new certificate to your keystore file.

Change Password

Opens a dialog to change the password of the selected certificate.

Delete Alias

Removes the selected certificate from your keystore file.

Alias Info

Opens a dialog with detailed information about the selected certificate.

Reset All

Empties the keystore (File, Password) and certificate (Alias in Keystore, Alias password) fields.

See Also

Personal tools
In other languages