MY ACCOUNT / MY ORGANIZATON
Troubleshooting
BEST PRACTICES

iOS Certificates & Provisioning Profiles

You need to have your iOS Certificates and Provisioning Profiles ready to be able to build and deploy your applications to Apple Appstore.

You can obtain your developer certificates and provisioning profiles from Apple developer portal: https://developer.apple.com/support/code-signing/

iOS Certificate files

Certificate files can be in .p12 file format. There are 2 main types of iOS certificates:

  • Apple Development: Used for development and testing.

  • Apple Distribution: Used for submitting applications to the App Store, Ad Hoc or Enterprise distribution.

iOS Provisioning profiles

Provisioning profiles can be in .mobileprovision file format. There are 4 main types of iOS certificates:

  • Apple App Development: Used to install development applications on test devices.

  • Ad Hoc: Used for installing an application on a limited number of registered devices.

  • App Store: Used for submitting applications to the Apple App Store.

  • In-House: Used for in-house application distribution (this profile type is only available with the Apple Enterprise program)

To generate or upload your iOS certificate, select iOS Certificates from the signing module.

All types of iOS certificates are supported, including development, ad hoc, in-house or App Store distribution.

Click on "Add New" button to upload or create your iOS Certificate.

You can either upload your readily available certificate bundle (P12) along with the bundle password or create a certificate signing request (CSR) to generate a new certificate from the Apple Developer portal and then upload the certificate (CER) to create a certificate bundle (P12). No Mac device needed.

1. Generate Or Upload iOS Certificates

To generate your iOS certificates, simply fill in your details and Appcircle will provide a CSR (certificate signing request) which you can use on Apple Developer Portal to generate your signing certificate.

  • Download your CSR file

  • Upload it to the Apple Developer Portal for certificate creation

  • Download your generated CER file from the Apple Developer portal

  • Upload the CER file to the signing identities module by clicking on the upload button next to the CSR file.

  • Your CSR will now be converted to a P12 file as a iOS signing certificate. (Please note that the P12 file comes with an empty password.)

To upload your iOS certificate, select "Upload Certificate Bundle (.p12)" button and upload your pre-obtained iOS certificate file.

You can see a list of your created or uploaded certificates. Each certificate will display the certificate name, certificate type (development, ad-hoc, in-house or app store distribution) along with expiration dates.

2. Upload iOS Provisioning Profiles

Simply upload your provisioning profiles obtained from the Apple Developer portal.

Provisioning profile and certificate matching will be done automatically. You can also have multiple provisioning profiles to use in different applications with different Apple developer accounts.

You can list and manage your provisioning profiles here. If there is a matching certificate, profile will show a green check mark to indicate that. If not, you will see a red cross mark indicating there's no certificate matching to the provisioning profile.

You can also see matching application ID and expiration date of the profiles here.

3. Assign signing identities in the Build module for distribution

For both iOS or Android build projects, you need to assign your signing identities to your build profile for distribution. The distribution-ready binaries will be signed with the selected signing identities both in manual and automatic distribution cases.