Progress will discontinue Telerik Platform on May 10th, 2018. Learn more

Create and Install Certificate and Provisioning Profile for iOS Development

This tutorial is intended for beginner AppBuilder users who need to create a cryptographic identity for iOS development for the first time. You will learn:

  • The benefits and the limitations of using a cryptographic identity and provisioning profile for development
  • How to create a certificate for development
  • How to create a provisioning profile for development
  • How to create a cryptographic identity for development in AppBuilder

This tutorial is applicable to:

  • The in-browser client
  • The classic Windows desktop client
  • The extension for Visual Studio
  • The command-line interface

To build and run your apps on an iOS device without the Cordova developer app, you need a pair of matching cryptographic identity and provisioning profile. A cryptographic identity matches a provisioning profile, if both include the same Apple-signed certificate.

A pair of matching cryptographic identity and provisioning profile for development provides the following benefits.

  • You can build and run your app on selected devices
  • Your apps are enabled for debugging on device

A pair of matching cryptographic identity and provisioning profile for development has the following limitations.

  • You cannot publish your app in the App Store
  • You can build and run your app on a limited number of predefined devices only

Prerequisites

To complete this tutorial, you need to be enrolled in the Apple Developer Program. To be able to create a new certificate for development, you must not have any certificates for iOS App Development created with your account. You need to be logged in the iOS Dev Center.

Step 1: Create a cryptographic identity

The cryptographic identity is a pair of matching public key certificate and private key. In AppBuilder, you can create a cryptographic identity or import an existing one. To create a new cryptographic identity, you need to complete a certificate signing request for an Apple-signed certificate.

Alternatively, if you want to use an existing cryptographic identity that you created earlier, you can import it.

Start by running AppBuilder to create a certificate signing request. Make sure you have stored the CSR file on your disk.

Next, create a certificate for development in the iOS Dev Center. Make sure you have downloaded the CER file on your disk.

Last, complete the certificate signing request in AppBuilder by uploading the CER file for your certificate. Your new cryptographic identity is added to the list.

You cannot upload your CER file if you do not have a matching pending certificate signing request in AppBuilder.

Step 2: Obtain a provisioning profile

The provisioning profile is stored as a mobileprovision file. This file contains information about the identity of the app author, the identity of the app and its distribution purpose.

You can obtain a provisioning profile by exporting an existing one or by creating a new one.

To create a development provisioning profile, you need a registered iOS App ID, one or more development certificates and one or more iOS devices registered to your Apple developer account.

Start by registering an App ID for your app. If you want to use an already registered App ID that you want to use, skip this step.

Not to be confused with the Telerik Platform App ID which is the unique identifier for your app in the Telerik Platform. For more information about the Telerik Platform App ID, see App Settings.

For development, you might want to use a wildcard App ID. If your provisioning profile includes a wildcard App ID, you can use it across multiple apps. You can also use a wildcard App ID across multiple provisioning profiles. For more information about App IDs, see Code Signing Glossary.

Next, register the devices which you want to use for development. When you build an app and code sign it with a development cryptographic identity and provisioning profile, you can run it only on registered devices included in the provisioning profile. If your devices for testing are already registered in the iOS Dev Center, you can skip this step.

Last, create a development provisioning profile and download the mobileprovision file on your disk.

Step 3: Add the provisioning profile in AppBuilder

If you are an classic Windows desktop client user, run classic Windows desktop client, open your app and in the title bar, click your user name and select Options. In the Mobile tab, expand iOS, select Mobile Provisions, click Import and select the mobileprovision file from your disk.

If you are an in-browser client user, run in-browser client, open your app, click the cogwheel icon and select Options. Select iOSProvisioning Profiles, click Import and select the mobileprovision file from your disk.

If you are an extension for Visual Studio user, run Microsoft Visual Studio, open your app and in the main menu bar, click AppBuilderOptions. In the Mobile tab, expand iOS, select Mobile Provisions, click Import and select the mobileprovision file from your disk.

If you are an command-line interface user, in the command prompt, run the following command.

appbuilder provision import <File Path>

Where <File Path> is the complete file path to the mobileprovision file for your provisioning profile.

Next Steps

After configuring your pair of matching cryptographic identity and provisioning profile, you can build and run your app on an iOS device.

See Also

Start a free trial Request a demo
Contact us: +1-888-365-2779
sales@telerik.com
Copyright © 2016-2017, Progress Software Corporation and/or its subsidiaries or affiliates. All rights reserved.