Build iOS Job

Build iOS Job

The Build iOS job creates an IPA artifact for iOS deployment.

Requirements

• macOS build agent
• Xcode installed
• Valid code signing setup

Configuration

Option	Description	Default
Build Mode	release, debug, profile	release
Target	Entry point file	lib/main.dart
Flavor	Flutter flavor	-
Export Options	Path to ExportOptions.plist	ios/ExportOptions.plist
Environment Variables	Key-value pairs	-

Build Command

flutter build ipa --release --export-options-plist=ios/ExportOptions.plist

Artifacts

Artifact	Location
IPA	build/ios/ipa/*.ipa

The IPA is uploaded and available for Download or Deploy iOS jobs.

Code Signing

iOS builds require code signing. Set up:

1. Distribution certificate in Keychain
2. Provisioning profile installed
3. ExportOptions.plist configured

See Code Signing Guide for details.

Example Pipeline

┌──────────┐     ┌───────────┐     ┌────────────┐
│ On Tag   │────▶│ Build iOS │────▶│ Deploy iOS │
└──────────┘     └───────────┘     └────────────┘

Troubleshooting

“No signing certificate”

• Ensure certificate is in Keychain
• Check ExportOptions.plist has correct team ID

“Provisioning profile not found”

• Install profile via Xcode or manually
• Verify bundle ID matches