iOS apps

iOS compatibility, provisioning profiles & UDID retrieval

Checking iPhone/iPad device family, MinimumOSVersion, Ad-Hoc UDID lists, and retrieving your device UDID via /m/device.

Provisioning profile types

Every installable .ipa embeds a signed embedded.mobileprovision file that dictates which Apple devices are allowed to run it:

  • Development & Ad Hoc: Restricted to the explicit list of hardware UDIDs (ProvisionedDevices) compiled into the profile before Xcode exported the .ipa.
  • In-House (Enterprise): Contains ProvisionsAllDevices = true under the Apple Developer Enterprise Program, allowing authorized employees to install without pre-registering UDIDs.
  • App Store: Intended exclusively for App Store Connect / TestFlight—cannot be installed over the air via itms-services://. BuildDrop flags App Store profiles on the install page so developers know to re-export as Ad Hoc or Development.

Finding your iPhone or iPad UDID with My Device (/m/device)

Apple Development and Ad Hoc builds require your 25-character or 40-character hardware UDID:

  1. Open /m/device in Apple Safari on your iPhone, iPad, or Mac.
  2. Tap Get my device UDID and allow the signed configuration profile download.
  3. Open Settings -> Profile Downloaded and tap Install. iOS sends your UDID, hardware PRODUCT identifier (for example iPhone17,1 -> iPhone 16 Pro), and OS version once, removes the temporary enrollment profile automatically, and redirects Safari to /m/device/{token}.
  4. Copy or email your UDID to your developer—and immediately see every live find_by_udid build already provisioned for your device.

Hardware & OS checks on /i/{hash}

BuildDrop automatically inspects MinimumOSVersion, UIDeviceFamily (1 = iPhone, 2 = iPad), UIRequiredDeviceCapabilities, and Mach-O CPU slices (arm64) and warns testers upfront if their OS version, form factor, or enrolled UDID does not match the build.