React Native iOS Intent扩展构建报错：Undefined symbol: _OBJC_CLASS_$_RCTRootView

问题根源 #

Intent Extension是独立的iOS Target，默认不会自动关联React Native的核心库，导致链接阶段找不到RCTRootView的类定义。

一步步修复 #

1. 给Extension Target添加依赖库 #

• 打开Xcode，选中你的Intent Extension Target
• 切换到Build Phases标签页，找到Link Binary With Libraries
• 点击+号，添加以下React Native核心库：
  • libReact-Core.a（新架构环境下换成libReact-Core-TurboModule.a，根据你的RN版本选择）
  • libReact-RCTAppDelegate.a
  • libReactCommon.a
  • libRCTRequired.a
  • libRCTTypeSafety.a
    RN 0.74版本可能还需要额外添加libReact-NativeModules.a这类模块化库

2. 设置头文件搜索路径 #

• 切换到Build Settings标签页，搜索Header Search Paths
• 添加以下路径（确保路径和你的项目结构匹配）：
  • $(SRCROOT)/../node_modules/react-native/React
  • $(SRCROOT)/../node_modules/react-native/React/Base
  • $(SRCROOT)/../node_modules/react-native/ReactCommon
  • $(SRCROOT)/../node_modules/react-native/Libraries
    记得勾选Recursive（递归搜索）选项

3. 配置预编译宏 #

• 在Build Settings中搜索Preprocessor Macros
• 若项目启用了新架构（RN 0.74默认开启，0.72版本看项目自身配置），添加RCT_NEW_ARCH_ENABLED=1

4. 统一Deployment Target #

确保Intent Extension的Deployment Target和主App Target保持一致：RN 0.72+要求iOS 13.0及以上，RN 0.74要求iOS 14.0及以上。

5. 调整Podfile配置（使用CocoaPods时） #

在Podfile中为Extension Target添加React Native依赖：

target '你的Extension名称' do
  use_frameworks! :linkage => :static

  pod 'React-Core', :path => '../node_modules/react-native/'
  pod 'React-RCTAppDelegate', :path => '../node_modules/react-native/Libraries/AppDelegate'
  pod 'ReactCommon', :path => '../node_modules/react-native/ReactCommon'
  # RN 0.74版本需额外添加对应模块化pod，比如React-NativeModules
end

执行pod install重新安装依赖。

6. 验证代码导入 #

在Extension的代码文件中，确保正确导入RCTRootView：
Swift版本：

import React

Objective-C版本：

#import <React/RCTRootView.h>

额外注意事项 #

• 启用新架构时，需将Extension Target的ENABLE_BITCODE设置为NO（新架构不支持Bitcode）
• 清理Xcode缓存：按Cmd+Shift+K清理构建文件，再按Cmd+Option+Shift+K清理Derived Data，之后重新构建项目

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