Common iOS .ipa & zipped .app upload errors
Resolving numeric upload error codes (4001503–4001506), Info.plist parsing issues, and simulator vs device builds.
Supported iOS archive formats
BuildDrop accepts two iOS archive layouts:
- Standard
.ipaarchive exported from Xcode Organizer orxcodebuild -exportArchive, containingPayload/YourApp.app/Info.plistandPayload/YourApp.app/embedded.mobileprovision. - Zipped
.appbundle (.zip) containing a compiledYourApp.app/directory. BuildDrop automatically wraps zipped.appbundles into a validPayload/YourApp.app.ipaarchive during upload processing.
Reference of numeric upload error codes
4001401— File exceeds plan limit: Your archive is larger than your current 20 MB cap.4001403— Chunk missing or corrupt: A network interruption dropped an upload chunk; click Retry to resume from completed chunks.4001503— Invalid.ipaarchive:Payload/*.app/Info.plistis missing or unreadable (neither valid binary plistbplist00nor XML plist).4001504— Unsupported archive: Plain source-code.zipfiles,.dmgimages, or.xcarchivefolders without a device.appbundle cannot be installed on devices.4001505— Missing bundle metadata:CFBundleIdentifieror version strings are missing fromInfo.plist.4001506— Zipped.apprepackaging failed: Ensure the.zipwas created from an arm64 iOS device archive—macOS Simulator builds (x86_64/ simulator SDK withoutembedded.mobileprovision) will never install on physical iPhones.
# Export an Ad-Hoc .ipa from CI using xcodebuild:
xcodebuild -exportArchive \
-archivePath build/MyApp.xcarchive \
-exportOptionsPlist ExportOptions-AdHoc.plist \
-exportPath build/ipa