Skip to content
Free tool · No sign-up

ExportOptions.plist generator

Fill in how the archive should be signed and exported, then copy the plist and the xcodebuild command that uses it.

10 characters, from Membership details in your Apple Developer account.

Signing

ExportOptions.plist

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
	<key>method</key>
	<string>app-store-connect</string>
	<key>signingStyle</key>
	<string>automatic</string>
	<key>destination</key>
	<string>export</string>
	<key>uploadSymbols</key>
	<true/>
	<key>manageAppVersionAndBuildNumber</key>
	<false/>
</dict>
</plist>

Command

xcodebuild -exportArchive \
  -archivePath build/App.xcarchive \
  -exportOptionsPlist ExportOptions.plist \
  -exportPath build/export \
  -allowProvisioningUpdates

Which method to choose

The method decides what kind of .ipa comes out.

  • app-store-connect: for TestFlight and the App Store.
  • release-testing: an ad hoc build for registered devices.
  • debugging: a development build for registered devices.
  • enterprise: in-house distribution with an Apple Developer Enterprise account.

The names changed in Xcode 15.3

Older Xcode versions call these app-store, ad-hoc and development. Xcode 15.3 and later accept the old names but print a deprecation warning. Turn on the older-names option if your build machine runs Xcode 15.2 or earlier.

Automatic or manual signing

With automatic signing, Xcode picks or creates the certificate and profile; add -allowProvisioningUpdates to the command so it may do that from the command line. With manual signing you name the provisioning profile for each bundle ID, including app extensions.

Questions and answers

What is ExportOptions.plist?

It is a property list that tells xcodebuild -exportArchive how to turn an .xcarchive into an .ipa: the distribution method, the team, the signing style and a few options such as uploading symbols.

How do I export an IPA from the command line?

Archive with xcodebuild archive, then run xcodebuild -exportArchive -archivePath App.xcarchive -exportOptionsPlist ExportOptions.plist -exportPath build. The generator writes that command for you.

Where do I find my team ID?

In the Apple Developer account under Membership details. It is a 10-character code such as A1B2C3D4E5.

Can xcodebuild upload straight to App Store Connect?

Yes. Set destination to upload with the app-store-connect method, and pass App Store Connect API key options to xcodebuild so it can sign in.

Build and release from one Mac.

VenelX Studio builds your iOS and Android apps on a Mac you own, shares test builds and releases to the stores, from any browser.

Free sign-up. Paid plans, billed yearly. 14-day money-back guarantee. No per-build or per-minute fees.