React Native 0.72项目添加Widget Extension后CocoaPods执行pod install报错求助

DevOps 小满

2026-6-16

可行解决步骤

1. 调整Podfile中Extension Target的继承策略与依赖配置

RN 0.72默认使用use_frameworks! :linkage => :static，不要直接移除该配置，而是给Widget Extension设置正确的继承规则并仅引入必要依赖：

target 'YourMainApp' do
  use_frameworks! :linkage => :static
  config = use_native_modules!
  use_react_native!(
    :path => config[:reactNativePath],
    :hermes_enabled => true # 根据项目实际配置调整
  )
  # 主应用的其他第三方依赖
end

target 'YourWidgetExtension' do
  inherit! :complete
  # 仅引入Widget需要的RN核心组件，避免冗余依赖冲突
  pod 'React-Core', :path => '../node_modules/react-native/'
  pod 'React-RCTAppDelegate', :path => '../node_modules/react-native/Libraries/AppDelegate'
end

若之前使用inherit! :search_paths，建议替换为inherit! :complete并手动控制依赖范围，减少路径与依赖冲突。

2. 彻底清理CocoaPods缓存与构建文件

执行以下命令清除所有可能的缓存后，重新安装依赖：

pod deintegrate
rm -rf Pods
rm Podfile.lock
rm -rf ~/Library/Caches/CocoaPods
rm -rf ios/build
npm cache clean --force

完成后重新运行pod install。

3. 统一Deployment Target版本

确保Widget Extension的Deployment Target与主应用完全一致（RN 0.72要求最低iOS 13.0），版本不一致会导致Pod依赖的编译配置冲突。

4. 隔离不兼容的第三方依赖

部分第三方SDK（如部分统计、支付类库）不支持在Extension环境中运行，需在Podfile中指定这些库仅在主应用target中引入：

target 'YourMainApp' do
  # 仅主应用使用的冲突依赖
  pod 'ProblematicThirdPartyPod', '~> 2.0'
end

target 'YourWidgetExtension' do
  inherit! :complete
  # 不引入上述冲突依赖
end