React Native集成Zoom Video SDK iOS编译报错：Undefined symbol问题

出现的错误符号包括：

• _OBJC_CLASS_$_ZoomVideoSDKSessionContext
• _OBJC_CLASS_$_ZoomVideoSDKVideoOptions
• _OBJC_CLASS_$_ZoomVideoSDKAudioOptions
• _OBJC_CLASS_$_ZoomVideoSDK
• _OBJC_CLASS_$_ZoomVideoSDKInitParams

以下是针对性的排查和解决步骤：

1. 严格匹配SDK版本 #

确认@zoom/react-native-videosdk的npm包版本与你手动安装的iOS端ZoomVideoSDK版本完全一致，版本不兼容是导致符号未定义的常见原因。比如npm包是1.10.0，iOS SDK必须下载对应版本的压缩包。

2. 修正Pod配置与使用方式 #

• 打开项目根目录的Podfile，确保正确引入Zoom SDK：

  pod 'ZoomVideoSDK', :path => '../node_modules/@zoom/react-native-videosdk/ios'
  

• 执行pod install后，必须打开.xcworkspace文件进行编译，而非.xcodeproj，否则Pod依赖的框架不会被正确链接。

3. 验证Framework嵌入与链接状态 #

• 在Xcode的项目Target -> General -> Frameworks, Libraries, and Embedded Content中，确认ZoomVideoSDK.framework的Embed选项为Embed & Sign，而非Do Not Embed。
• 切换到Build Phases -> Link Binary With Libraries，检查ZoomVideoSDK.framework是否存在，若缺失则重新添加。

4. 调整Build Settings配置 #

• 进入Build Settings -> Architectures，确保Project和Target的架构统一（比如真机选arm64，模拟器选x86_64），避免混合架构导致链接失败。
• 修改Build Settings -> Other Linker Flags，将-all_load替换为-ObjC，后者更精准地处理Objective-C类的符号链接，部分场景下比-all_load更有效。

5. 彻底清理缓存后重建 #

• 清理前端依赖：

  rm -rf node_modules && npm install
  

• 清理iOS Pod缓存：

  pod deintegrate && pod install
  

• 在Xcode中执行Product -> Clean Build Folder（快捷键Cmd+Shift+K），然后重新编译项目。

6. 检查初始化代码拼写 #

确认你的SDK初始化代码中，类名拼写完全正确，比如ZoomVideoSDKInitParams、ZoomVideoSDKSessionContext等，避免因代码中的拼写错误导致编译器无法识别符号。

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