React-Native集成admob-native-ads后遇FacebookAdapter链接及符号缺失问题

问题详情 #

安装react-native-admob-native-ads库后，iOS编译抛出链接错误：

ld: framework not found FacebookAdapter
clang: error: linker command failed with exit code 1 (use -v to see invocation)

已在Podfile中添加以下依赖：

pod 'Google-Mobile-Ads-SDK'
pod 'GoogleMobileAdsMediationFacebook'

问题仍未解决，尝试降级上述两个Pod版本后，又出现未定义符号错误：

Showing Recent Messages
Undefined symbol: OBJC_CLASS$_GADAdLoader

Showing Recent Messages
Undefined symbol: OBJC_CLASS$_GADMultipleAdsAdLoaderOptions

Showing Recent Messages
Undefined symbol: OBJC_METACLASS$_GADNativeAdView

Showing Recent Messages
Undefined symbol: OBJC_CLASS$_GADCustomEventExtras

Showing Recent Messages
Undefined symbol: _GADSimulatorID

Showing Recent Messages
Undefined symbol: OBJC_CLASS$_GADCustomEventExtras

Showing Recent Messages
Undefined symbol: OBJC_CLASS$_GADNativeAdMediaAdLoaderOptions

Showing Recent Messages
Undefined symbol: OBJC_CLASS$_GADNativeAdViewAdOptions

解决步骤 #

1. 锁定兼容的依赖版本 #

react-native-admob-native-ads与Google广告SDK、Facebook中介库有严格的版本匹配要求，别盲目降级。直接查看该库的README文档，找到官方推荐的版本组合。比如当前稳定组合可参考：

• Google-Mobile-Ads-SDK: ~> 10.0.0
• GoogleMobileAdsMediationFacebook: ~> 6.12.0

2. 彻底清理Pod缓存并重装 #

执行以下命令清理旧依赖：

# 进入iOS项目目录
cd ios

# 删除锁文件和Pods文件夹
rm -rf Podfile.lock Pods

# 清空Pod全局缓存
pod cache clean --all

# 重新安装依赖
pod install

3. 手动添加FacebookAdapter框架 #

如果仍提示找不到FacebookAdapter，在Xcode中手动添加：

• 打开项目的.xcworkspace文件
• 选中项目Target → Build Phases → Link Binary With Libraries
• 点击+号，搜索FacebookAdapter并添加对应的.framework文件；如果搜不到，检查Pods/FacebookAdapter目录是否存在，不存在则重新执行pod install

4. 修正项目架构设置 #

• 选中项目Target → Build Settings → Architectures
• 设置Architectures为Standard Architectures (arm64, x86_64)
• 确保Build Active Architecture Only在Debug模式下设为Yes，Release模式下设为No

5. 检查库的初始化配置 #

部分版本的react-native-admob-native-ads需要手动配置：

• 在AppDelegate.m中添加Google广告SDK的初始化代码
• 在Info.plist中添加必要权限（比如NSUserTrackingUsageDescription）

6. 升级React-Native版本（可选） #

如果你的RN版本偏老，可能和广告库存在兼容性冲突，尝试升级到0.70+的稳定版本后，重新安装所有依赖

内容的提问来源于stack exchange，提问作者Engr.Aftab Ufaq