Guide to configure the Apple Developer account on this Mac and enable signed IPA builds for Diawi / distribution.

Initial situation

This Mac has never signed iOS apps. On the first build:

❌ Error (Xcode): No Accounts — Add a new account in Accounts settings
❌ Error (Xcode): No profiles for 'com.zerolatency.liveplayer' were found

Project details:

Parameter	Value
Development Team	R5ZAZYF526
Bundle Identifier	com.zerolatency.liveplayer
Distribution method	Ad Hoc (for Diawi)

Step 1 — Add the Apple Developer account in Xcode

1. Open Xcode (already installed at /Applications/Xcode.app)
2. Menu bar: Xcode → Settings (Cmd + ,)
3. Go to the Accounts tab
4. Click the + button in the bottom left
5. Choose "Apple ID"
6. Enter the credentials of the Apple Developer account (the one associated with team R5ZAZYF526)
7. The account should appear in the list with your name and role

⚠️ Do not use a personal Apple ID — you need the account enrolled in the Apple Developer Program ($99/year) or Enterprise.

Step 2 — Verify and download provisioning profiles

After adding the account:

1. In the same Settings → Accounts, select the account you just added
2. You should see the Team Name associated with R5ZAZYF526
3. If it doesn't appear, click Download Manual Profiles (bottom right)
4. Verify the profiles are present:

ls ~/Library/MobileDevice/Provisioning\ Profiles/
# You should see .mobileprovision files

If the folder doesn't exist or is empty, the profiles haven't been downloaded.

Create a provisioning profile (if needed)

If you don't have a provisioning profile for com.zerolatency.liveplayer yet:

1. Go to developer.apple.com → Certificates, Identifiers & Profiles
2. Identifiers → Search for com.zerolatency.liveplayer (it must exist)
3. Profiles → Click +
4. Choose:
   • Ad Hoc (for Diawi, registered devices)
   • Development (for USB testing)
5. Select the Certificate (you must have created it first)
6. Select the Devices (UDIDs of the target iPads)
7. Download the .mobileprovision and open it — Xcode installs it automatically

Step 3 — Configure signing in the Xcode project

1. Open the workspace:

open zerolatency-live-player-app/ios/Runner.xcworkspace

2. In the left navigator, select Runner (project root)
3. Go to the Signing & Capabilities tab
4. Team: select your Apple Developer team
5. Bundle Identifier: com.zerolatency.liveplayer
6. Check ✅ Automatically manage signing
7. Xcode will create/update the provisioning profiles automatically

💡 Tip: If you see a "No profiles for 'com.zerolatency.liveplayer'" warning, it means the identifier doesn't exist on the Apple portal. Go to developer.apple.com → Identifiers and create it.

Step 4 — Test build

After configuration, retry the build:

cd zerolatency-live-player-app
BACKEND_URL=http://192.168.1.127:3002/api bash scripts/build-production.sh ios ipa

The generated IPA will be in build/ios/ipa/ — ready to upload to Diawi.

Troubleshooting

Problem	Cause	Solution
No Accounts	No account in Xcode	Follow Step 1
No profiles for 'com.zerolatency.liveplayer'	Identifier doesn't exist or profile not downloaded	Follow Step 2
Provisioning profile expired	Profile expired (valid 1 year)	Renew on Apple Developer → download
Failed to locate or generate matching signing assets	Xcode can't create the profile automatically	Create it manually from the Apple Developer portal
No signing certificate "iOS Distribution" found	Certificate missing	Create a certificate on Apple Developer → Certificates
The request was denied by Apple	Rate limit / authentication	Wait 5 min and retry
App Store Connect Operation Error	Bundle ID already used by another app	Use a different Bundle ID

Apple Developer — Quick links

Item	URL
Apple Developer Program	developer.apple.com/programs
Certificates, Identifiers & Profiles	developer.apple.com/account
Diawi (IPA distribution)	diawi.com