Skip to main content

​
Prerequisites

  • Xcode and CocoaPods
  • iOS deployment target 14.0+ in Podfile (required for AIR Kit)

​
Associated Domains

  1. Open ios/Runner.xcworkspace in Xcode.
  2. Select the Runner target → Signing & Capabilities.
  3. Add Associated Domains.
  4. Add the domains you use:
webcredentials:account.air3.com
webcredentials:account.sandbox.air3.com
Optional for non-production testing: 
webcredentials:account.staging.air3.com
webcredentials:account.uat.air3.com
Include only environments you actually use. Production and sandbox are the usual minimum.

​
App ID allowlisting

Provide Moca with your Apple Team ID and bundle identifier in the form TEAMID.com.example.app.

​
Podfile

Set the platform version: 
platform :ios, '14.0'
Then: 
cd ios
pod install

​
Info.plist (optional)

If you need ATS exceptions for specific domains, configure them narrowly in Info.plist. Prefer default secure TLS where possible. Optional usage strings if you add camera / photo features: 
<key>NSCameraUsageDescription</key>
<string>Required for features that use the camera.</string>

​
Testing

  • Passkeys and full WebAuthn behavior require a physical device in many cases.
  • Build with flutter build ios and run from Xcode or flutter run.

​
Troubleshooting

IssueWhat to check
Domain verification failuresCapability enabled, correct team, provisioning profile, domains spelled correctly
pod install errorsrm -rf Pods Podfile.lock, pod repo update, pod install
WebView / networkAssociated Domains, device network, ATS settings
See also Flutter troubleshooting.

​
Next steps

​
Reference