Hey there, let's break down why your React Native IPA is under 4MB and failing to install—this is a super common issue with a few key fixes we can walk through:

1. You're exporting an empty "shell" IPA without the React Native bundle #

React Native apps rely on a compiled JavaScript bundle (main.jsbundle) and asset files to run. If you skip the release bundle step, Xcode will only export the bare native container app (which is tiny, ~4MB) with no actual app code inside.

Fix:

• First, generate the release bundle and assets locally:

  npx react-native bundle --platform ios --dev false --entry-file index.js --bundle-output ios/main.jsbundle --assets-dest ios
  

• Then, in Xcode, make sure main.jsbundle and the assets folder are added to your project (drag them into your target's files list if missing).
• Alternatively, build a full release version directly via:

  npx react-native run-ios --configuration Release
  

  Then proceed to archive and export from Xcode.

2. Incorrect Xcode Archive/Export Configuration #

If you're not archiving in Release mode or choosing the wrong distribution method, you might end up with a broken or stripped-down IPA.

Fix:

• Open Xcode, select your project target, and set the build configuration to Release (top toolbar, next to the device selector).
• Go to Product > Archive—wait for the archive to complete (this should bundle all your code and dependencies properly).
• When distributing, select the correct option:
  • Use Ad Hoc or Enterprise for internal testing (make sure your device's UID is included in the provisioning profile).
  • Use App Store Connect for app submission.
• Double-check that your signing certificate and provisioning profile are valid and match the distribution method.

3. Missing React Native Build Scripts in Xcode #

If the automatic bundle generation script isn't set up, Xcode won't include your JS code during the archive process.

Fix:

• In Xcode, go to your target's Build Phases tab.
• Look for a phase called Bundle React Native code and images. If it's missing, add a new Run Script phase with this content:

  export NODE_BINARY=node
  ../node_modules/react-native/scripts/react-native-xcode.sh
  

• Make sure this script runs before the Copy Bundle Resources phase.

4. You Built for the Simulator, Not a Real Device #

Simulator builds use x86_64 architecture, which is much smaller and incompatible with real iOS devices.

Fix:

• In Xcode's device selector, choose Any iOS Device (arm64) instead of a simulator before archiving.
• Check your target's Build Settings > Architectures and ensure it's set to Standard Architectures (arm64) (no simulator architectures included).

Once you fix these steps, your IPA should be a reasonable size (usually 20MB+ depending on dependencies) and install correctly on your target devices.

内容的提问来源于stack exchange，提问作者Behzad Saberi