Skip to content

Apple App Store

To submit your iOS app builds to the Apple App Store (TestFlight), you need to configure an Apple App Store destination in the Capawesome Cloud Console. App submissions are automatically uploaded to TestFlight for testing and distribution.

Configuration

To create an Apple App Store destination, navigate to the Destinations page in the Capawesome Cloud Console and provide the following information:

  • Name: A descriptive name for this destination (e.g., "Production iOS", "TestFlight Beta").
  • Platform: Must be set to iOS.
  • Authentication Method: Choose how to authenticate with App Store Connect. You can use either Apple ID + Password or API Key.
  • Team ID: Your Apple Developer Team ID from the Membership Details section.

Depending on the authentication method you choose, you will need to provide additional credentials:

Apple ID + Password

  • Apple ID: Your Apple ID email address.
  • Apple App ID: The Apple ID property from the App Information section in App Store Connect.
  • App-specific Password: An app-specific password generated on your Apple ID account page.

API Key

  • API Key File: The .p8 private key file downloaded from App Store Connect.
  • Key ID: The Key ID associated with your API key.
  • Issuer ID: The Issuer ID from App Store Connect.

Read on for instructions on obtaining these credentials.

Obtaining Credentials

Team ID

  1. Sign in to your Apple Developer account.
  2. Scroll down to Membership Details.
  3. Copy your Team ID.

Apple ID + Password Credentials

Apple ID

This is the email address associated with your Apple Developer account.

Apple App ID

  1. Sign in to App Store Connect.
  2. Navigate to Apps and select your app.
  3. Go to App Information.
  4. Copy the Apple-ID value (a numeric identifier).

App-specific Password

  1. Sign in to your Apple ID account page.
  2. Navigate to Security section.
  3. Under App-Specific Passwords, click Generate Password.
  4. Enter a descriptive label (e.g., "Capawesome Cloud").
  5. Copy the generated password and save it securely.

API Key Credentials

API Key File, Key ID, and Issuer ID

  1. Sign in to App Store Connect.
  2. Navigate to Users and Access.
  3. Select the Integrations tab, then select App Store Connect API. Note: If you do not see this tab, ensure that your account has the necessary permissions (Admin or App Manager role).
  4. Click the + button to create a new Team Key.
  5. Enter a name for the key (e.g., "Capawesome Cloud") and select App Manager as the access level.
  6. Click Generate.
  7. Copy the Issuer ID displayed at the top of the page.
  8. Copy the Key ID from the newly created key row.
  9. Click Download API Key to download the .p8 file. Note: You can only download this file once, so store it securely.

Common Issues

Submission not appearing in TestFlight

It may take some time for the build to process in App Store Connect before it appears in TestFlight. If your build does not appear after a reasonable amount of time, make sure to check your email inbox for any processing errors or issues notified by Apple.

The most common reasons for this can be:

  • Build number was not incremented
  • Missing Privacy Descriptions in your app's Info.plist
  • Incorrect build settings or configurations
  • App Store Connect account permissions are insufficient (account must have at least App Manager role)