LiveCode LessonsHow To - LiveCode Mobile Tasks iOS TasksHow do I Create a Distribution Profile for iOS?

How do I Create a Distribution Profile for iOS?

This lesson describes how to set up a distribution profile that can be used for applications built with LiveCode. It is assumed that you have signed up to the iOS Apple Developer Program. Screen captures are provided.

Introduction

A distribution profile is required if want to release your iOS application through the online Apple store.

The information discussed here is reduced and is also covered on the apple iOS Provisioning Portal website. You can access that additional information by logging into the iOS provisioning portal that is accessible from: https://developer.apple.com/. Select the Member Center and use your login credentials to log into your account. Depending if you are a developer for Mac apps and/or iOS apps your login screen may differ. You may have to follow a link to the iOS Dev Center. Then follow the link to the iOS Provisioning Portal. The iOS Provisioning Portal provides you with a link to Distribution. Select the Prepare App tab and select the highlighted headings in order to expand the steps provided by Apple.

Generating a Certificate Signing Request

Generating a Certificate Signing Request

The first step in setting up a distribution profile is to create a certificate signing request. You can do this on your Mac. Launch the Keychain Access.app that is stored in Applications/Utilities. Then execute the following steps in your Keychain Access application:

1. Select Preferences > Certificates and ensure that Online Certificates Status

Protocol (OSCP) and Certificate Revocation List (CRL) are set to Off.

2. Select Keychain Access > Certificate Assistant > Request a Certificate From a

Certificate Authority... and ensure that you do not have any of your certificates

highlighted, otherwise the Provisioning Portal will not accept your certificate request.

3. Enter your valid e-mail address in the User Email Address field. Ensure that the e-mail

address is the same as the one you used when you registered as an iOS Developer.

4. Enter your name in the Common Name field. Ensure that the name you enter is the

same as the one you used when you registered as an iOS Developer.

5. A CA Email Address is not required.

6. Select the Save to disk radio button and tick Let me specify key pair information,

if it is present.

7. Press Continue.

8. A dialog appears that allows you to specify where you would like the certificate signing

request to be stored. Specify a location and select Save.

9. Press Continue.

10. The certificate is then generated and written to the file you specified under step 8.

Submitting a Certificate Signing Request

After you have generated a certificate signing request, you need to submit your certificate for approval. Log into the iOS Provisioning Portal that is accessible from: https://developer.apple.com/account/ios/certificate/certificateList.action.

This link takes you directly to the Certificates, Identifiers & Profiles section of your iOs developer account. Select the "Production" tab and follow these steps:

1. Select the Add Certificate button.

2. Select "App Store and Ad Hoc" as type then press continue

3. On next screen press "Continue"

4. On next screen select "Choose File" and select the certificate you created in previous step and then press "Generate"

Downloading and Installing a Distribution Certificate

Remain on the same page as the one you were on when you submitted the certificate signing request, then follow these steps to download and install the certificate:

5. Download Generated certificate by clicking the "Download" button.

6. Double click the downloaded certificate to install (alternatively drag to the keychain utility)

Backing up your Certificates

Backing up your Certificates

It is important that you backup the keys you created. This allows you to develop on multiple Macs or reinstall the keys after unexpected data loss. You can export your private keys and certificates through the Keychain Access application:

1. Open the application Keychain Access.app that is stored in Applications/Utilities.

2. Select Keys.

3. Highlight the private key associated with the distribution certificate.

4. Select File > Export Items.

5. A window opens that allows you to specify where you would like to save your certificate.

6. Select Personal Information Exchange (.p12) as file format.

7. Select the file name.

8. Select Save.

9. You are prompted for passwords that allow you to access the key in the future

Downloading the Distribution Profile

Downloading the Distribution Profile

This is the final stage and will create the distribution provisioning profile you need to use when building your iOS standalone. Start by selecting the "Distribution" tab from "Provisioning Profiles"-

1. Select New Profile (+)

2. Select App Store as the Distribution Method.

3. Enter the Profile name.

4. Ensure that your Distribution Certificate has been created and is displayed correctly.

5. Select the appropriate App ID for your applicatoin

6. Select Generate.

7. Select the Download button from next to the Distribution Provisioning Profile you created.

This allows you to download the .mobileprovision file.

8. Double click the .mobileprovision install the Distribution Provisioning Profile on your computer.

You are now ready to move on to lesson: How do I set up an App for Submission to iTunes Connect?

Video Lesson Showing the above

Video Lesson Showing the above

We have recently create a tutorial video showing a step-by-step guide of the above

https://www.youtube.com/watch?v=Lyn_K_GUKUs&list=UUrP9IskEPHuirOh0KyKjvMA

11 Comments

moonshdw8

I'm nto sure why this post isn't being commented on by more people. It's Fantastic! This is the only place I've found step by step instructions so clearly laid out.
Thank for the great post!

Jan

If I have the certificates downloaded and then want to create the key how do you link the two things together? or do I have to revoke it and start fresh. I did not create the original certificate, my developer did.

Hanson Schmidt-Cornelius

Hi Jan,

if your developer created the certificate, then he should also have the keys. You could ask him for the keys. Step: "Backing up your Certificates" provides the information you need for backing the keys up.

Kind Regards,

Hanson

Vin

I've got the distribution certificate but there are no keys associated with it. Without those keys the Organizer is complaining about linkage. What to do?

Hanson Schmidt-Cornelius

Hi Vin,

your keys are generated using the Keychain Access Utility on your Mac. If you have a distribution certificate then the keys to generate it would have been created too. The iOS Developers portal provides more details and up to date information on this topic than is captured in this lesson.

Kind Regards,

Hanson

Tim

So this explains how to set up distribution through iTunes. Is there a way to distribute apps made with LiveCode to iOS users without using iTunes? For example, if a client wants an app to be used only internally by their team, and not be available to the public. Is this possible?

Thanks in advance!
Tim

Hanson Schmidt-Cornelius

Hi Tim,

yes, it is possible. Your client can register as an iOS developer and create a team provisioning profile that has a number of devices associated with it. Instructions on how to do so are provided in the iOS Provisioning Portal. The lesson "How do I Become an iOS developer": http://lessons.runrev.com/s/lessons/m/4069/l/23275 should be a starting point, but you will have to delve into the documentation from Apple.

Kind Regards,

Hanson

kamles

nice tutorial

David R

very clear instructions for this process, which is not the case on the myriad of sites claiming to cover this topic ! Thank you.

gpawlak

Very nice tutorial. Thanks

Durga Annadurai

very neat and clear explanation

Add your comment

E-Mail me when someone replies to this comment