Xcode编译简单App报错找不到YogaKit，真机部署受阻求助

针对YogaKit.modulemap找不到的编译错误 #

1. 修正Xcode模块映射路径配置 #

• 打开Xcode主项目，选中KairosTimer2 target，进入Build Settings
• 搜索Module Map，找到YogaKit相关的配置项，将路径手动修改为本地Pods目录的正确路径：

  $(SRCROOT)/Pods/Target Support Files/YogaKit/YogaKit.modulemap
  

• 确保Enable Modules (C and Objective-C)选项设置为Yes

2. 彻底清理DerivedData与构建缓存 #

• 执行Clean Build Folder（快捷键Cmd+Shift+K）
• 手动删除当前项目的DerivedData目录：

  rm -rf ~/Library/Developer/Xcode/DerivedData/KairosTimer2-gxpqydcwjdfhzybaymdaiirfhuzg
  

• 重启Xcode后重新执行pod install

3. 检查Pods项目的YogaKit配置 #

• 打开ios目录下的Pods.xcodeproj，找到YogaKit target
• 进入Build Settings，确认Module Map File路径指向本地的YogaKit.modulemap文件，无拼写错误

针对真机安装时React-RCTAnimation依赖卡顿问题 #

1. 修正Podfile依赖声明 #

• 打开项目根目录的Podfile，确认React-RCTAnimation的依赖路径正确，示例：

  pod 'React-RCTAnimation', :path => '../node_modules/react-native/Libraries/NativeAnimation'
  

• 执行完全重新集成Pods的命令：

  cd ios && pod deintegrate && rm -rf Podfile.lock && pod install
  

2. 修复Xcode项目的依赖关联 #

• 回到主项目的Build Phases，检查Link Binary With Libraries中是否包含libReact-RCTAnimation.a，若缺失则从Pods项目中手动添加
• 检查Target Dependencies列表，确保包含Pods-KairosTimer2与React-RCTAnimation相关target

3. 跨环境缓存清理 #

• 清理npm缓存并重装依赖：

  npm cache clean --force && rm -rf node_modules && npm install
  

• 再次执行iOS端缓存清理与Pods安装：

  cd ios && pod cache clean --all && rm -rf Pods && pod install
  

额外兼容性检查（针对历史正常项目） #

• 确认当前Xcode版本与8个月前上架时的版本差异，若升级过Xcode，需同步调整项目的Deployment Target至对应兼容版本
• 检查package.json中react-native版本是否与历史版本一致，若有变更，可回退至原版本：

  npm install react-native@<历史版本号>
  

内容的提问来源于stack exchange，提问作者Space Age Crystal