Skip to content
Docs

iOS

Taurify produces iOS application archives (.ipa files) that can be uploaded to the App Store or debugging app bundles that can used to test locally on physical devices.

Codesign

Code signing on iOS requires enrolling to the Apple Developer program, which at the time of writing costs 99$ per year.

To sign your iOS app you must provide the certificate and mobile provisioning profile via environment variables:

  • IOS_CERTIFICATE: base64 representation of the certificate exported from the Keychain.
  • IOS_CERTIFICATE_PASSWORD: password of the certificate set when exporting it from the Keychain.
  • IOS_MOBILE_PROVISION: base64 representation of the provisioning profile.

The following sections explain how to get these values.

Signing Certificate

After enrolling, navigate to the Certificates page to create a new Apple Distribution certificate. Download the new certificate and install it to the macOS Keychain.

To export the certificate key, open the “Keychain Access” app, expand the certificate’s entry, right-click on the key item and select “Export <key-name>” item. Select the path of the exported .p12 file and remember its password.

Run the following base64 command to convert the certificate to base64 and copy it to the clipboard:

base64 -i <path-to-certificate.p12> | pbcopy

The value in the clipboard is now the base64 representation of the signing certificate. Save it and use it as the IOS_CERTIFICATE environment variable value.

The certificate password must be set to the IOS_CERTIFICATE_PASSWORD variable.

Provisioning Profile

Additionally, you must provide the provisioning profile for your application. In the Identifiers page, create a new App ID and make sure its “Bundle ID” value matches the identifier set in the identifier configuration.

Navigate to the Profiles page to create a new provisioning profile. For App Store distribution, it must be an “App Store Connect” profile. Select the appropriate App ID and link the certificate you previously created.

After creating the provisioning profile, download it and run the following base64 command to convert the profile and copy it to the clipboard:

base64 -i <path-to-profile.mobileprovision> | pbcopy

The value in the clipboard is now the base64 representation of the provisioning profile. Save it and use it as the IOS_MOBILE_PROVISION environment variable value.

Now you can build your iOS application and distribute on the App Store!

Submit to App Store

Taurify automatically distributes your application to the App Store using the credentials you provide for code signing.