iOS apps

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:

  1. Standard .ipa archive exported from Xcode Organizer or xcodebuild -exportArchive, containing Payload/YourApp.app/Info.plist and Payload/YourApp.app/embedded.mobileprovision.
  2. Zipped .app bundle (.zip) containing a compiled YourApp.app/ directory. BuildDrop automatically wraps zipped .app bundles into a valid Payload/YourApp.app .ipa archive 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 .ipa archive: Payload/*.app/Info.plist is missing or unreadable (neither valid binary plist bplist00 nor XML plist).
  • 4001504 — Unsupported archive: Plain source-code .zip files, .dmg images, or .xcarchive folders without a device .app bundle cannot be installed on devices.
  • 4001505 — Missing bundle metadata: CFBundleIdentifier or version strings are missing from Info.plist.
  • 4001506 — Zipped .app repackaging failed: Ensure the .zip was created from an arm64 iOS device archive—macOS Simulator builds (x86_64 / simulator SDK without embedded.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