React Native新iOS发布版应用体积超500MB问题求助

我通过CLI用模板创建了一个全新的React Native应用，但Release模式下的iOS应用体积居然达到了511.9MB（iPhone存储显示），正常新RN应用体积应该在10MB以内，这个情况是近期才出现的，请问我忽略了哪些因素？

操作步骤 #

• 执行 npm uninstall -g react-native-cli @react-native-community/cli
• 执行 npx react-native@latest init TestProject
• 在Xcode中打开 /ios/TestProject.xcworkspace
• 进入Test Project > Edit Scheme
• 将构建配置改为Release并取消勾选Debug Executable
• 关闭弹窗后点击运行按钮，在已连接设备上运行应用
• 在iPhone的设置 > 通用 > iPhone存储中查看，新安装应用占用511.9MB

额外尝试的步骤 #

• 在Xcode中点击Product > Archive
• 在Organizer窗口右键点击应用选择Show in Finder，文件系统中应用体积为544.8MB

环境信息 #

• macOS: Ventura 13.2.1
• Xcode: 14.2 (14C18)
• Node: 18.15.0
• Ruby: 2.7.6p219

项目package.json（模板生成） #

{
  "name": "TestProject",
  "version": "0.0.1",
  "private": true,
  "scripts": {
    "android": "react-native run-android",
    "ios": "react-native run-ios",
    "lint": "eslint .",
    "start": "react-native start",
    "test": "jest"
  },
  "dependencies": {
    "react": "18.2.0",
    "react-native": "0.71.4"
  },
  "devDependencies": {
    "@babel/core": "^7.20.0",
    "@babel/preset-env": "^7.20.0",
    "@babel/runtime": "^7.20.0",
    "@react-native-community/eslint-config": "^3.2.0",
    "@tsconfig/react-native": "^2.0.2",
    "@types/jest": "^29.2.1",
    "@types/react": "^18.0.24",
    "@types/react-test-renderer": "^18.0.0",
    "babel-jest": "^29.2.1",
    "eslint": "^8.19.0",
    "jest": "^29.2.1",
    "metro-react-native-babel-preset": "0.73.8",
    "prettier": "^2.4.1",
    "react-test-renderer": "18.2.0",
    "typescript": "4.8.4"
  },
  "jest": {
    "preset": "react-native"
  }
}

可能的原因及解决办法 #

1. 构建生成了多架构通用包（Universal Binary） #

Xcode默认Archive会生成同时包含真机arm64架构和模拟器x86_64架构的通用包，两种架构代码叠加会让体积直接翻倍甚至更多。

• 解决：Archive完成后，在Organizer中选择「Distribute App」，选择「iOS App Store」或「Ad Hoc」分发渠道，Xcode会自动剥离模拟器架构，最终导出的包体积会大幅缩小；也可以在项目Build Settings中，将Architectures和Valid Architectures都设置为arm64，重新Archive。

2. 意外开启了Bitcode #

React Native 0.70+版本默认已关闭Bitcode，但如果配置被修改，开启Bitcode会生成额外的编译数据，导致包体积剧增。

• 检查：在Xcode项目Build Settings中搜索Enable Bitcode，确认Release模式下设置为NO。

3. Xcode 14+默认包含完整调试符号（dSYM） #

Xcode 14及以上版本，Release构建默认会生成完整的dSYM调试符号文件，这类文件可能占用几百MB空间。

• 临时查看真实体积：在Build Settings的Debug Information Format中，将Release模式改为DWARF（不生成dSYM），重新构建后体积会明显减小。注意：发布到App Store需要保留dSYM用于崩溃日志解析，发布前需改回DWARF with dSYM File。

4. Xcode DerivedData缓存异常 #

旧的构建缓存可能导致体积异常膨胀，清理缓存后重新构建即可解决。

• 操作：打开Xcode → 顶部菜单「Xcode」→「Settings」→「Locations」→ 点击DerivedData旁的箭头打开文件夹，删除对应项目的缓存文件夹，再重新Archive。

5. 本地运行Release模式的特殊处理 #

直接在设备上运行Release模式时，Xcode可能额外注入调试相关文件或符号，导致设备显示的体积比实际分发包大。建议以Archive后导出的包体积作为真实参考。

内容的提问来源于stack exchange，提问作者Anthony Tietjen