iOS环境构建@capacitor-community/fcm@2.0.2报nanopb错误如何解决？

报错根因 #

该错误由2.0.2版本@capacitor-community/fcm依赖的nanopb库与Xcode头文件引用规则冲突导致：nanopb默认使用双引号引入头文件"pb.h"，不符合Xcode对framework头文件要求的尖括号引用规范，进而触发Could not build module 'nanopb'报错。

修复步骤 #

方案1：升级FCM版本（推荐） #

2.0.3及以上的2.x版本已经官方修复了该兼容问题，直接升级即可：

• 卸载旧版本包：
  npm uninstall @capacitor-community/fcm
• 安装修复后的兼容版本：
  npm install @capacitor-community/fcm@2.0.3
• 同步iOS原生依赖：
  npx cap sync ios
• 打开Xcode清理构建缓存后重新编译即可：
  打开ios目录下后缀为.xcworkspace的项目文件，按下Command + Shift + K清理缓存，再按下Command + B重新构建。

方案2：不升级版本的临时修复 #

如果必须保留2.0.2版本，可以手动修改Xcode配置规避错误：

• 打开iOS项目的Xcode workspace，左侧导航栏选中Pods项目
• 在Targets列表中找到nanopb，进入Build Settings页
• 搜索Quoted Include In Framework Header配置项，将其值修改为No
• 清理构建缓存后重新编译项目即可。

内容的提问来源于stack exchange，提问作者Rakesh Ramesh