Apple Silicon（M4）设备上React Native iOS项目集成gRPC-C++与Firebase Pod时的模块映射问题

我之前在M4芯片的Mac上开发React Native iOS项目时，刚好碰到过和你一模一样的问题——集成Firebase和gRPC-C++后总是报模块映射缺失的错误，折腾了好几天才把坑踩完，给你分享几个亲测有效的解决方法：

• 调整Podfile的模块化头配置，避免全局冲突
  全局开启use_modular_headers!很容易和gRPC-C++这类对模块化支持不那么完善的Pod冲突，建议改成仅给Firebase相关组件单独开启模块化头，同时给gRPC系列Pod关闭模块化头：

  platform :ios, '16.6'
  
  use_frameworks! :linkage => :static
  $RNFirebaseAsStaticFramework = true
  
  target 'YourAppName' do
    config = use_native_modules!
  
    use_react_native!(
      :path => config[:reactNativePath],
      :hermes_enabled => true # 根据你的项目需求调整
    )
  
    # 仅给需要的Firebase组件开启模块化头
    pod 'Firebase/Core', :modular_headers => true
    pod 'Firebase/Auth', :modular_headers => true
    # 其他你用到的Firebase组件同理添加
  
    # 给gRPC系列Pod关闭模块化头
    pod 'gRPC-C++', :modular_headers => false
    pod 'gRPC-Core', :modular_headers => false
    pod 'BoringSSL-GRPC', :modular_headers => false
  
    post_install do |installer|
      react_native_post_install(installer)
      __apply_Xcode_12_5_M1_post_install_workaround(installer)
  
      # 强制gRPC相关组件开启分布式编译，修复模块映射问题
      installer.pods_project.targets.each do |target|
        if target.name.start_with?('gRPC-') || target.name == 'BoringSSL-GRPC'
          target.build_configurations.each do |config|
            config.build_settings['BUILD_LIBRARY_FOR_DISTRIBUTION'] = 'YES'
            config.build_settings['IPHONEOS_DEPLOYMENT_TARGET'] = '16.6'
          end
        end
        # 给Firebase组件配置正确的头文件设置
        if target.name.start_with?('Firebase')
          target.build_configurations.each do |config|
            config.build_settings['USE_HEADERMAP'] = 'NO'
            config.build_settings['ALWAYS_SEARCH_USER_PATHS'] = 'NO'
          end
        end
      end
    end
  end
  

• 清理Pod缓存并兼容Apple Silicon架构
  M4的arm64架构偶尔会和gRPC的预编译二进制包不兼容，建议按以下步骤操作：

  1. 先清理现有Pod依赖：pod deintegrate && rm -rf Podfile.lock ~/Library/Caches/CocoaPods ios/Pods
  2. 用Rosetta模式打开终端（右键终端图标→显示简介→勾选「使用Rosetta打开」）
  3. 重新安装Pod：pod install

• 调整Xcode项目的编译设置
  打开项目的.xcworkspace文件，在项目的Build Settings里做以下修改：

  • 找到Allow Non-modular Includes in Framework Modules，设置为YES，允许非模块化的头文件被框架模块引用
  • 检查Header Search Paths，添加$(PODS_ROOT)/gRPC-C++/include和$(PODS_ROOT)/Firebase/Core/Sources，并设置为recursive

• 验证版本兼容性
  确保你的React Native版本在0.72及以上（这个版本开始对Apple Silicon和模块化头的支持更稳定），同时Firebase Pod版本要和gRPC-C++版本匹配，比如Firebase 10.x系列建议搭配gRPC 1.50+版本，避免版本不兼容导致的头文件冲突

内容来源于stack exchange