CONFIGURATION GUIDE

Configuring iOS App Distribution

Now that our deployment pipeline is set up with Codemagic, let's configure your iOS app distribution credentials. We'll connect your Apple Developer account to enable seamless iOS app deployment.

New to Apple Development?

Creating an Apple Developer Account

If you don't already have an Apple Developer account, here's how to set one up:

1. Visit developer.apple.com/programs/enroll
2. Click "Start Your Enrollment"
3. Sign in with your Apple ID (create one if needed)
4. Choose your entity type:
   • Individual / Sole Proprietor
   • Company / Organization
5. Pay the annual fee ($99)
6. Complete identity verification:
   • Individual: Provide personal identification
   • Organization: Provide D-U-N-S number and legal documentation

Warning

For company accounts, you'll need:

• D-U-N-S Number (can be obtained for free from Dun & Bradstreet)
• Legal Entity Status
• Legal Binding Authority
• Website matching your company

Connecting Apple to Codemagic

Full Video

Let's link your Apple Developer account with Codemagic to enable automated iOS deployments:

1. In Codemagic, go to your Team's (or Personal Account's) Integrations section
2. Find the Apple Developer Portal section and click Manage keys
3. Click Create Key
4. Name your key, use the name App Store Connect API Key (YOUR_TEAM_NAME)
5. We'll generate the required credentials in the next step

Setting Up Your API Keys

Now we'll create the API keys that allow secure communication between services:

1. Sign in to App Store Connect
2. Navigate to Users and Access > Integrations > App Store Connect API Keys (Or click here)
3. Click the + button to generate a new key
4. For the key name, enter Codemagic API Key (YOUR_TEAM_NAME). Select App Manager as access level.
5. Click Generate and download your API Key file
6. Stay on this page as we will need to copy the Issuer ID and Key ID to the Codemagic dashboard.

Completing the Codemagic Setup

Return to the Codemagic dashboard with your newly generated credentials:

1. Copy/paste the Issuer ID and the Key ID from the App Store Connect website to the Codemagic dashboard
2. Drag and drop the API Key file you downloaded earlier to the Codemagic dashboard
3. Click Save

Codemagic will now be able to use your App Store Connect API key to manage your iOS app distribution.

Generating Your Distribution Certificate

Full Video

When it comes to iOS app distribution, we need to generate a distribution certificate. This certificate is a way for Apple to verify the identity of the developer and make sure the app is coming from a trusted source. Think of it as a stamp that you put on your app to prove that you are the one who built it.

Important Note

Apple limits the number of certificates you can have to three per account. This is why we'll have to sign several apps with a same certificate. The one we'll generate here will be used for all your team's apps.

Codemagic has the ability to generate the certificate for you. Let's do it:

1. Open your Codemagic Team settings
2. Navigate to Code signing identities
3. Open the iOS certificates tab
4. Click Generate certificate
5. For the reference name for the certificate, enter Distribution Certificate (YOUR_TEAM_NAME)
6. For the certificate type, select Apple Distribution
7. Select the App Store Connect API key you just created
8. Click Create certificate

The certificate will be automatically registered in your Apple Developer Portal and stored securely in Codemagic for future use.

What's Next?

Perfect! Your Apple Developer account is now linked to Codemagic, enabling automated iOS app distribution. Next, we'll set up your Android deployment credentials.