React Native版本升级后，如何通过Xcode禁用Metro实现快速启动？

要实现Xcode运行时不依赖Metro、直接加载离线bundle，需要从预生成bundle、Xcode配置、启动逻辑调整三个方面入手，具体步骤如下：

1. 预生成离线main.jsbundle及资源文件 #

React Native升级后，生成离线bundle的命令需明确指定参数，执行以下命令（根据项目实际入口文件调整）：

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

• 若项目使用TypeScript，将entry-file改为index.tsx
• 执行后会在ios目录下生成main.jsbundle和包含图片等资源的assets文件夹

2. 修改Xcode项目配置，确保bundle被打包进APP #

打开Xcode中的iOS项目，找到对应target，进入Build Phases：

• 检查是否存在Copy Bundle Resources阶段，若没有则点击左上角+号新建该阶段
• 将刚生成的main.jsbundle和assets文件夹添加到Copy Bundle Resources列表中，确保构建时会把这些文件打包进APP包

3. 调整APP启动逻辑，加载本地bundle而非Metro #

修改iOS项目中的启动文件，替换原有Metro连接逻辑：

Objective-C（AppDelegate.m） #

// 注释或删除原Metro加载代码，替换为以下内容
NSURL *jsCodeLocation = [[NSBundle mainBundle] URLForResource:@"main" withExtension:@"jsbundle"];
RCTRootView *rootView = [[RCTRootView alloc] initWithBundleURL:jsCodeLocation
                                                    moduleName:@"YourAppName"
                                             initialProperties:nil
                                                 launchOptions:launchOptions];

Swift（AppDelegate.swift） #

// 注释或删除原Metro加载代码，替换为以下内容
let jsCodeLocation = Bundle.main.url(forResource: "main", withExtension: "jsbundle")!
let rootView = RCTRootView(
  bundleURL: jsCodeLocation,
  moduleName: "YourAppName",
  initialProperties: nil,
  launchOptions: launchOptions
)

• 注意将YourAppName替换为你项目package.json中的name字段值
• 若项目存在DEBUG模式下强制连接Metro的条件判断（如#ifdef DEBUG），需同步修改该分支的逻辑，确保Debug模式也加载本地bundle

4. 可选：添加自动生成bundle的构建脚本 #

若不想每次手动生成bundle，可在Xcode的Build Phases中添加Run Script阶段（放在Compile Sources之后、Copy Bundle Resources之前），脚本内容如下：

npx react-native bundle \
  --platform ios \
  --entry-file index.js \
  --bundle-output "${BUILT_PRODUCTS_DIR}/${PRODUCT_NAME}.app/main.jsbundle" \
  --assets-dest "${BUILT_PRODUCTS_DIR}/${PRODUCT_NAME}.app"

该脚本会在每次Xcode构建时自动生成bundle到最终的APP包目录，无需手动管理文件位置。

完成以上配置后，通过Xcode运行APP时会直接加载本地离线bundle，跳过Metro的初始化和网络连接流程，实现和TestFlight版本一致的瞬间启动速度。

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