Code sign for iOS

Article
03/22/2024

In this article, you'll learn about how to code sign for iOS. You need to sign your app for iOS if you selected iOS as one of the platforms while creating and building your wrap project.

Important

Using Xcode to digitally sign your wrapped mobile apps for iOS is not supported. Follow the instructions below to sign your wrapped mobile app packages for iOS correctly.

Prerequisites

You need the following information to get started:

App ID
Device UDIDs (only for testing and development purpose)

You also need a macOS device to code sign for iOS.

Prepare your Mac

Set up your Mac with the following configuration.

Install Xcode. More information: Xcode
Install PowerShell for macOS. More information: Installing PowerShell on macOS
Enroll in Apple Developer Program
To distribute your apps within the organization, you need to sign up for Apple Enterprise Developer Program.

Create App ID

Sign in to your developer account by going to https://developer.apple.com and selecting the Account tab.
Go to Certificates, IDs & Profiles > Identifiers.
Select + to create a new identifier.
Select App IDs, and then select Continue.
Select the type as App, and then select Continue.
Register an App ID:
1. Description - Name of your app.
2. Bundle ID - select Explicit Bundle ID.
3. Enter the bundle ID that you used while creating the wrap project. More information: Bundle ID
4. Enable the following capabilities:
  - Associated Domains
  - iCloud
  - NFC Tag Reading
  - Push Notifications
5. Select Continue.
Review, and register the App ID.

Create a distribution certificate

To create a distribution certificate, create a new certificate signing request first.

Create Certificate Signing Request (CSR)

On your Mac, go to the Applications folder > Utilities > open Keychain Access.
Select Keychain Access > Certificate Assistant > Request a Certificate from a Certificate Authority.
Fill out the Certificate Information as explained below, and then select Continue.
1. In the User Email Address field, enter your Apple ID email address to identify with this certificate.
2. In the Common Name field, enter your name.
3. In the Request group, select Saved to disk.
4. Save the file to your Mac.

Create the distribution certificate

Sign in to your developer account at https://developer.apple.com by selecting the Account tab.
Go to Certificates, IDs & Profiles > Certificates.
1. Select + to create a new certificate.
2. Select App Store and Ad Hoc > Continue.
  
  Note
  
  If you have an Enterprise Developer Account then you'll have the option to create an Enterprise Distribution certificate.
Upload the Certificate Signing Request (CSR) file that was generated in the previous steps.
Select Continue, and download the certificate to your Mac.
Double-click the downloaded .cer file to install to Keychain Access.
Take a note of the Name of the certificate (usually like iPhone Distribution: Name (Team ID)). This value is the code signing identity that needs to be provided for signing.

Add all the devices where the IPA needs to be installed

Note

This step is only necessary if you're distributing to app to external users. It's not required if the app is only for internal users.

Sign in to your developer account at https://developer.apple.com by selecting the Account tab.
Go to Certificates, IDs & Profiles > Devices.
Select + to register one or more devices.
Enter the Device Name and Device ID (UDID).
Select Save.

Tip

You can also register multiple devices together by uploading a list of UDID's.

Create an iOS Provisioning Profile

Sign in to your developer account by going to https://developer.apple.com and selecting the Account tab.
Go to Certificates, IDs & Profiles > Profiles.
Select + to create a new profile.
Select Ad Hoc > Continue.

Note

For production testing and development purpose, use App Store distribution method.
Select App ID that you created earlier, and then select Continue.
Select the certificate that you created earlier, and then select Continue.
Select all the test devices where you want to install your app, and then select Continue.
Review and name the provisioning profile. Note down the name of the provisioning profile.
Generate and download the profile to your Mac.
Double-click to open the downloaded file (*.mobileprovision) to register it with Xcode.

Sign the iOS Archive

Download and unzip the iOS-Archive.zip file from App Center. This creates a folder named after the Bundle ID. In the example below, the Bundle ID is com.single.wrap.
If signing with enterprise certificate, open the file Distribution-exportOptions.plist with Xcode and change the value for the method field inside the file to enterprise.