如何在React Native第三方库中集成Firebase Crashlytics？

核心逻辑是复用客户已初始化的Firebase实例——这正是你之前集成Analytics报错的根源（Analytics不支持多Firebase App实例，但Crashlytics支持基于现有实例进行上报）。

具体实现步骤 #

1. 声明Peer依赖，避免版本冲突
   在你的库的package.json中，将Firebase相关依赖设为peerDependencies，确保复用客户项目中已安装的版本：

   "peerDependencies": {
     "@react-native-firebase/app": "^17.0.0 || ^18.0.0",
     "@react-native-firebase/crashlytics": "^17.0.0 || ^18.0.0"
   }
   

   这样既不会重复安装依赖，也能避免版本不兼容问题。

2. 直接使用客户的Crashlytics实例
   不要在库中调用firebase.initializeApp()创建新实例，直接导入并使用客户已初始化的Crashlytics：

   import crashlytics from '@react-native-firebase/crashlytics';
   
   // 封装库内错误上报方法
   export const reportLibraryError = (error, context = {}) => {
     // 标记错误来源为你的库，方便客户在控制台筛选
     crashlytics().setAttribute('error_source', 'your-library-name');
     // 添加上下文信息，辅助排查
     Object.keys(context).forEach(key => {
       crashlytics().setAttribute(key, context[key]);
     });
     // 上报错误
     crashlytics().recordError(error);
   };
   
   // 捕获库内未处理的Promise拒绝
   export const setupCrashListeners = () => {
     process.on('unhandledRejection', (reason) => {
       reportLibraryError(new Error(`Unhandled Rejection: ${reason}`));
     });
   };
   

3. 为客户提供集成说明
   在你的库文档中明确告知：

   • 客户项目必须已完成@react-native-firebase/app和@react-native-firebase/crashlytics的初始化配置
   • 不需要额外添加Firebase配置文件或初始化逻辑，直接调用你的库提供的方法即可

关键注意事项 #

• 绝对不要在库中初始化独立的Firebase App实例，否则会和客户的实例冲突，导致Crashlytics上报异常
• 尽量兼容多个Firebase版本，避免因版本差异出现API调用错误

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