React Native集成RNFB编译失败：RingBuffer.swift报错求助

问题描述 #

在React Native项目中集成RNFB，iOS端pod安装正常，但执行npm run ios时触发编译错误，核心问题是FirebaseCoreInternal模块中Swift代码的泛型语法不兼容，具体为Array.Index未指定泛型参数。仅需使用Firebase Analytics和Google Analytics功能，不需要心跳相关模块，但该模块默认被包含无法排除。

核心报错信息 #

❌  /Users/[Redacted]/Documents/GitHub/[Redacted]/ios/Pods/FirebaseCoreInternal/FirebaseCore/Internal/Sources/HeartbeatLogging/RingBuffer.swift:19:35: reference to generic type 'Array' requires arguments in <...>

  case outOfBoundsPush(pushIndex: Array.Index, endIndex: Array.Index)

批量编译失败命令：

The following build commands failed:
    CompileSwiftSources normal x86_64 com.apple.xcode.tools.swift.compiler
    CompileSwift normal x86_64 /Users/[Redacted]/Documents/GitHub/[Redacted]/ios/Pods/FirebaseCoreInternal/[Redacted]/Internal/Sources/HeartbeatLogging/HeartbeatController.swift
    CompileSwift normal x86_64 /Users/[Redacted]/Documents/GitHub/[Redacted]/ios/Pods/FirebaseCoreInternal/FirebaseCore/Internal/Sources/HeartbeatLogging/HeartbeatsBundle.swift
    CompileSwift normal x86_64 /Users/[Redacted]/Documents/GitHub/[Redacted]/ios/Pods/FirebaseCoreInternal/FirebaseCore/Internal/Sources/HeartbeatLogging/HeartbeatsPayload.swift
    CompileSwift normal x86_64 /Users/[Redacted]/Documents/GitHub/[Redacted]/ios/Pods/FirebaseCoreInternal/FirebaseCore/Internal/Sources/HeartbeatLogging/RingBuffer.swift

已尝试的方法 #

• 将RNFB从15.4.0降级到15.0.0，问题依旧存在
• 尝试修改RingBuffer.swift文件，但文件为只读无法编辑

环境与关键配置 #

基础环境 #

• Xcode版本：Version 13.4.1 (13F100)

package.json关键依赖 #

{
  "@react-native-firebase/app": "^15.0.0",
  "react": "16.13.1",
  "react-native": "~0.63.4",
  "expo": "~40.0.0"
}

Podfile核心配置 #

$RNFirebaseAsStaticFramework = true
platform :ios, '11.0'

target '[Redacted]' do
  use_unimodules!
  config = use_native_modules!
  use_react_native!(:path => config["reactNativePath"])
  use_frameworks!

  post_install do |installer|
    installer.pods_project.targets.each do |target|
      target.build_configurations.each do |config|
       config.build_settings['IPHONEOS_DEPLOYMENT_TARGET'] = '9.0'
       config.build_settings['SWIFT_VERSION'] = '5.0'
      end
     end
    flipper_post_install(installer)
  end
end

解决方案建议 #

1. 升级Swift版本适配 #

报错源于Swift语法版本不兼容，FirebaseCoreInternal使用了Swift 5.1+的泛型简化语法，但Podfile强制设置了SWIFT_VERSION = '5.0'。修改Podfile中的Swift版本为Xcode 13.4.1支持的最高版本：

config.build_settings['SWIFT_VERSION'] = '5.5'

执行以下命令重新安装依赖：

cd ios && pod deintegrate && pod install

2. 锁定FirebaseCoreInternal兼容版本 #

在Podfile中添加版本锁定，指定兼容旧Swift版本的FirebaseCoreInternal版本（如9.6.0）：

pod 'FirebaseCoreInternal', '9.6.0'

执行pod deintegrate && pod install重新同步依赖。

3. 绕过心跳模块编译 #

通过Podfile的post_install钩子修改FirebaseCoreInternal的编译配置，排除心跳相关文件：

post_install do |installer|
  installer.pods_project.targets.each do |target|
    if target.name == 'FirebaseCoreInternal'
      # 移除心跳相关源文件
      target.source_build_phase.files.each do |file|
        if file.file_path.to_s.include?('HeartbeatLogging')
          target.source_build_phase.remove_file(file)
        end
      end
    end
    # 保留原有配置并更新Swift版本
    target.build_configurations.each do |config|
      config.build_settings['IPHONEOS_DEPLOYMENT_TARGET'] = '9.0'
      config.build_settings['SWIFT_VERSION'] = '5.5'
    end
  end
  flipper_post_install(installer)
end

执行pod install后重新编译项目。

4. 升级React Native与RNFB版本 #

当前React Native 0.63.4属于较旧版本，RNFB 15.x对新版本RN兼容性更好。建议升级到React Native 0.68+，同时使用RNFB 18.x版本，可从根源解决依赖兼容问题。

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