Ionic 3项目中基于Firebase插件集成Crashlytics的方法咨询

嘿，我刚好处理过类似的Ionic3 + Firebase Crashlytics配置问题，结合你的情况，给你整理一套完整的实操步骤，帮你顺利用上Crashlytics：

一、先搞懂：为什么不用cordova-fabric-plugin了 #

没错，Fabric早就被Firebase完全整合了，现在Crashlytics是Firebase原生套件的一部分，所以旧的Fabric插件可以彻底弃用，官方提示移除Fabric API密钥就是这个原因——现在所有配置都通过Firebase的配置文件来管理了。

二、第一步：清理旧的Fabric插件和配置 #

如果你之前用过cordova-fabric-plugin，先把它彻底清掉：

• 卸载插件：

  cordova plugin remove cordova-fabric-plugin
  

• 清理平台配置文件：
  • Android：打开platforms/android/app/src/main/AndroidManifest.xml，删掉带Fabric API key的<meta>标签，以及任何和Fabric相关的权限、组件声明
  • iOS：打开platforms/ios/YourAppName/Info.plist，删除所有Fabric相关的键值对（比如Fabric字典、API Key条目）

三、第二步：安装Firebase Crashlytics的官方Cordova插件 #

现在Firebase官方提供了适配Cordova/Ionic的Crashlytics插件，直接安装：

cordova plugin add cordova-plugin-firebase-crashlytics

这个插件会自动帮你配置Android和iOS项目的Crashlytics依赖，不用手动改gradle或Xcode配置。

四、第三步：确认Firebase项目配置 #

因为你已经集成了Firebase插件，应该已经有google-services.json（Android）和GoogleService-Info.plist（iOS）了，但要做两件事：

1. 登录Firebase控制台，进入你的项目，左侧菜单找到「Crashlytics」，按照提示启用该服务（如果还没开的话）
2. 重新下载最新的配置文件，替换到项目对应的位置：
   • Android：把google-services.json放到platforms/android/app/目录下
   • iOS：把GoogleService-Info.plist放到platforms/ios/YourAppName/目录下

五、第四步：在Ionic 3代码里用Crashlytics #

插件提供了几个核心API，你可以在代码里主动记录日志、错误，甚至测试崩溃：

记录自定义日志 #

在关键流程里加日志，方便排查问题：

// 比如用户触发某个操作时
window.Crashlytics.log("用户进入了个人中心页面");

记录非致命错误 #

捕获代码里的异常并上报：

try {
  // 可能出错的业务代码
  const data = JSON.parse(invalidJsonString);
} catch (error) {
  window.Crashlytics.recordError(error);
}

测试崩溃（验证用） #

可以加个测试按钮，主动触发崩溃来确认上报是否正常：

testCrash() {
  // 调用这个方法会直接崩溃应用
  window.Crashlytics.crash("测试崩溃：主动触发的测试用例");
}

六、验证是否生效 #

1. 运行你的应用：ionic cordova run android 或 ionic cordova run ios
2. 触发崩溃（比如点击测试按钮）
3. 关闭应用再重启（这样崩溃日志才会上报到Firebase）
4. 等个5-10分钟，打开Firebase控制台的Crashlytics页面，就能看到对应的崩溃记录了

一些注意事项 #

• iOS端要确保Xcode里的签名配置正确，Crashlytics需要权限收集崩溃日志
• 崩溃日志不会实时显示，有时候需要等一会儿，或者多触发几次再检查
• 如果Android端上报有问题，可以检查platforms/android/build.gradle，插件应该已经自动添加了Crashlytics的依赖，如果没有的话，手动添加也可以

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