This is an automated email from the ASF dual-hosted git repository. GitToTheHub pushed a commit to branch pr-ios-guide-building-for-app-store-upload in repository https://gitbox.apache.org/repos/asf/cordova-docs.git
commit 055abb0689fe8b26231fb193df6685680842a007 Author: Manuel Beck <[email protected]> AuthorDate: Wed May 13 11:16:08 2026 +0200 ios(guide): add instructions for building for App Store Upload - Note, that `--device` has to be added to `cordova build ios --release` to create an IPA. - Note, that packageType can be set by build.json and must not be set extra --- www/docs/en/latest/guide/platforms/ios/index.md | 14 ++++++++++++++ 1 file changed, 14 insertions(+) diff --git a/www/docs/en/latest/guide/platforms/ios/index.md b/www/docs/en/latest/guide/platforms/ios/index.md index 97f02eed02..181aab403f 100644 --- a/www/docs/en/latest/guide/platforms/ios/index.md +++ b/www/docs/en/latest/guide/platforms/ios/index.md @@ -286,6 +286,20 @@ For manual signing, specifying the provisioning profiles by UUID: There is also support to mix and match command line arguments and parameters in `build.json`. Values from the command line arguments will get precedence. +### Building for App Store Upload + +When creating an `.ipa` intended for App Store upload, make sure the build targets a **device** build. + +Use: + +```zsh +cordova build ios --release --device +``` + +Without `--device`, Cordova may build for the simulator depending on context, which does not follow the same archive/export flow used for App Store distribution. + +If `packageType` is already set in your `build.json` release configuration (for example, `"packageType": "app-store"`), you do not need to pass `--packageType` on the command line unless you want to override it. + ## Xcode Build Flags If you have a custom situation where you need to pass additional build flags to Xcode you would use one or more `--buildFlag` options to pass these flags to `xcodebuild`. If you use an `xcodebuild` built-in flag, it will show a warning. --------------------------------------------------------------------- To unsubscribe, e-mail: [email protected] For additional commands, e-mail: [email protected]
