iOS Builds

Primio can build native iOS IPA files for TestFlight testing and App Store submission. iOS builds require App Store Connect API credentials.

Cost: 40,000 tokens | Build time: ~10 minutes

You're only charged for successful builds

The 40,000 token cost is only deducted when the build completes successfully. If a build fails for any reason, you are not charged — you can retry without worrying about wasting tokens.

What you need

Note

You need an Apple Developer Program membership ($99/year) to create the required credentials. Enroll here if you haven’t already.

iOS builds require three pieces of information from your Apple Developer account:

1. App Store Connect API Key (.p8 file) — A private key file downloaded from App Store Connect
2. Key ID — A 10-character alphanumeric identifier shown next to your key
3. Issuer ID — A UUID found at the top of the App Store Connect API Keys page

Setting up credentials

1. Open App Store Connect

   Go to App Store Connect → Users and Access → Integrations → App Store Connect API.

2. Generate a new API key

   Click the + button. Give the key a name (e.g., “Primio Build Key”) and select the App Manager role.

3. Download the .p8 file

   Click Download. You can only download this file once — save it somewhere secure.

4. Note the Key ID

   The Key ID is shown next to your key in the list. It’s a 10-character alphanumeric string.

5. Note the Issuer ID

   The Issuer ID is shown at the top of the API Keys page. It’s a UUID in the format xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.

Caution

Apple only lets you download the .p8 key file once. If you lose it, you’ll need to create a new key.

Caution

Apple allows a maximum of 3 iOS distribution certificates. Primio’s build process creates one automatically. If you already have 3, the build will fail. Manage your certificates in the Apple Developer Portal.

Note

Your .p8 key file is never stored by Primio — you’ll need to re-upload it each browser session. Your Key ID and Issuer ID are saved locally for convenience.

Building the IPA

1. Open the Publish section

   Go to Workspace → Publish → iOS.

2. Upload your .p8 key file

   Drag the file into the upload area or click to browse.

3. Enter your Key ID and Issuer ID

   Paste the values from App Store Connect.

4. Click “Build IPA”

   The build takes about 15 minutes.

Your Key ID and Issuer ID are saved in your browser session, so you don’t need to re-enter them for future builds in the same session.

After the build

Once the build completes, you need to upload the IPA to App Store Connect and test it.

Create your app in App Store Connect

Before uploading, register your app in App Store Connect — Transporter will fail if the app doesn’t exist yet.

1. Go to App Store Connect → Apps → + → New App
2. Fill in the app name, select your Bundle ID, set a SKU, and choose the primary language
3. Click Create

Caution

The Bundle ID must match the one in your Primio project settings. If they don’t match, the upload will fail.

Upload with Transporter

1. Download Transporter on your Mac (free from the Mac App Store)
2. Open Transporter and sign in with your Apple Developer account
3. Drag the IPA file into Transporter and click Deliver
4. Wait for upload and processing (5-15 minutes)

Note

Transporter is macOS only. There is no Windows or Linux alternative for uploading IPA files to App Store Connect.

Test with TestFlight

1. In App Store Connect, go to your app → TestFlight
2. Your uploaded build appears after processing
3. Complete the Export Compliance Information (most apps select “None of the algorithms mentioned above”)
4. Create an Internal Testing group and add yourself as a tester
5. Download the TestFlight app on your iPhone
6. Open the email invitation on your iPhone — tap the link to install and test

You can add up to 100 internal testers and 10,000 external testers via TestFlight.

TestFlight build expiration

TestFlight builds expire after 90 days. After that, testers can no longer install or open the build. If your testing phase stretches longer, upload a new build before the old one expires to maintain tester access.

Processing times: After uploading via Transporter, builds take 5-15 minutes to process before they appear in TestFlight. Occasionally this takes longer — check the Activity tab in App Store Connect for status.

External testers: The first build you send to external testers requires a brief Apple review (usually 24-48 hours). Subsequent builds to the same external group are available immediately.

Submit to the App Store

When you’re happy with testing, see the App Store Submission Guide for the full step-by-step submission process.

Project compatibility

Caution

Projects created before March 2026 may need to be regenerated for iOS compatibility. If you see a compatibility warning on the iOS build page, create a new project and re-describe your app.

Build history

Past builds are listed below the build form. Each entry shows the build status, download link for completed builds, and error messages if something went wrong.