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