developing-ios-apps

SKILL.md

iOS App Development

Build, configure, and deploy iOS applications using XcodeGen and Swift Package Manager.

Critical Warnings

Issue
Cause
Solution

"Library not loaded: @rpath/Framework"
XcodeGen doesn't auto-embed SPM dynamic frameworks
Build in Xcode GUI first (not xcodebuild). See Troubleshooting

xcodegen generate loses signing
Overwrites project settings
Configure in project.yml target settings, not global

Command-line signing fails
Free Apple ID limitation
Use Xcode GUI or paid developer account ($99/yr)

"Cannot be set when automaticallyAdjustsVideoMirroring is YES"
Setting isVideoMirrored without disabling automatic
Set automaticallyAdjustsVideoMirroring = false first. See Camera

App signed as adhoc despite certificate
@electron/packager defaults continueOnError: true
Set continueOnError: false in osxSign. See Code Signing

"Cannot use password credentials, API key credentials..."
Passing teamId to @electron/notarize with API key auth
Remove teamId. notarytool infers team from API key. See Code Signing

EMFILE during signing (large embedded runtime)
@electron/osx-sign traverses all files in .app bundle
Add ignore filter + ulimit -n 65536 in CI. See Code Signing

Quick Reference