Foolproof Guide to Publishing a uniapp IPA to the App Store

1. uniapp Packaging

  1. Open your project in HBuilder X Editor.
  2. Click the menu: 发行 → 原生App-云打包 (Publish → Native App - Cloud Build).
  3. Fill in the required information in the pop-up window (e.g., App name, bundle ID, certificate configuration).

Packaging Configuration

  1. Click Build.

Build Operation

  1. Wait for the build to complete. After success, download the .ipa file.

Build Success

After downloading, you will have a .ipa file on your local machine:

Downloaded IPA

2. Publishing to App Store

The .ipa file packaged by uniapp needs to be uploaded to App Store Connect to publish.
Here, we explain how to use Windows + AppUploader to complete the submission.

Overview of Steps

Step Action
1. Log in to Apple Developer Center Go to App Store Connect → My Apps
2. Create App Info Click ➕ to create a new App. Ensure Bundle ID matches the one used during packaging
3. Upload Screenshots Upload screenshots for required device resolutions; can use AppUploader screenshot tool
4. Upload IPA File Use AppUploader → Upload to submit the .ipa
5. Enter Upload Credentials Provide Apple ID and App-specific password (not login password)
6. Build Appears in List Select uploaded build, fill in app information
7. Submit for Review Wait for Apple review; upon approval, the app goes live on App Store

Detailed Steps

1. Log in to App Store Connect

Go to App Store Connect → My Apps. If you haven’t created an app yet, click the blue ➕:

Create App

⚠️ Note: Bundle ID must match the one used during packaging, otherwise upload will fail.

2. Upload Screenshots

App Store requires screenshots for different device models. If you don’t have real devices, use AppUploader tool to generate screenshots:

Screenshot Requirements

Screenshot Tool

3. Upload IPA File

Apple’s official tools only support macOS. Windows users can use AppUploader to submit the .ipa:

Upload IPA

4. Enter Upload Credentials

AppUploader requires:

  • Apple ID
  • App-specific password (not login password; can be generated in Apple ID settings)

App-specific Password Setup

5. Submit for Review

After successful upload, return to App Store Connect → Build Version, select the newly uploaded version, fill in app metadata (description, keywords, privacy policy, etc.), and submit for review.