如何在iOS系统上构建已开发完成的现有React Native应用？

排查方向 #

1. 清除手动链接残留配置

取消手动链接后不要只依赖自动unlink指令，手动检查两处配置：

• 打开Xcode项目的Build Phases面板，检查Link Binary With Libraries、Copy Bundle Resources两个模块，删除所有手动引入的第三方RN库相关文件
• 检查项目根目录的react-native.config.js，删除多余的依赖排除规则，避免自动链接跳过必要的依赖库

2. 分步验证Podfile配置

原生RN项目后续接入Expo很容易出现Podfile规则冲突，按以下步骤验证：

• 先注释Podfile中所有你自行添加的第三方库依赖，仅保留RN核心、Expo相关的默认配置
• 进入ios目录执行以下指令更新Pod源后重新安装：

pod deintegrate
rm -rf Pods Podfile.lock build
pod install --repo-update

• 此时尝试构建项目，如果能正常运行，再逐个放开第三方库的注释重新pod install，定位具体是哪一个依赖导致的链接冲突
• 若你使用的是M系列芯片的远程Mac，需要在Podfile末尾添加架构兼容配置：

post_install do |installer|
  installer.pods_project.targets.each do |target|
    target.build_configurations.each do |config|
      config.build_settings['EXCLUDED_ARCHS[sdk=iphonesimulator*]'] = 'arm64'
      config.build_settings['ONLY_ACTIVE_ARCH'] = 'YES'
    end
  end
end

3. 全量清理缓存重新构建

你之前的清理操作没有覆盖所有缓存项，完整清理流程：

# 清理node模块缓存
rm -rf node_modules package-lock.json
npm cache clean --force
npm install

# 清理iOS构建缓存
cd ios
rm -rf Pods Podfile.lock build *.xcworkspace/xcuserdata
pod deintegrate
pod install --repo-update

清理完成后打开Xcode，按住Option键点击顶部菜单栏Product -> Clean Build Folder，再执行构建操作。

4. 验证Expo与RN版本兼容性

后续接入Expo的项目很容易出现版本不匹配问题，执行npx expo-doctor指令，工具会自动检测依赖冲突、配置错误并给出修复建议，修复所有检测到的问题后再尝试构建。

付费技术支持说明 #

你可以在正规外包服务平台筛选有React Native跨端开发、Expo iOS适配经验的开发者，支持按单次问题解决付费。

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