Firebase Crashlytics 帮助您实时跟踪应用程序崩溃,提供详细报告以快速修复问题。它与 Capacitor 为 iOS 和 Android 应用程序提供服务。以下是您需要了解的内容:
-
為什麼要使用 Crashlytics?
- 获取 实时崩溃警报.
- 分析详细崩溃报告,包括 自动问题分组.
- 监控关键错误以保持应用程序稳定。
-
设置要求:
-
关键步骤:
-
安装 Crashlytics:
npm install @capgo/capacitor-firebase-crashlytics && npx cap sync -
初始化 Crashlytics 在您的应用中:
import { FirebaseCrashlytics } from '@capgo/capacitor-firebase-crashlytics'; await FirebaseCrashlytics.initialize();
-
-
测试您的设置:
-
触发测试崩溃:
await FirebaseCrashlytics.crash();
-
-
附加提示: 结合 Crashlytics 与 Capgo 立即获得实时更新,避免应用商店延迟。
本指南确保您的应用程序崩溃免费且用户友好。立即开始设置 Firebase Crashlytics!
2021 Android 指南: Firebase Crashlytics - 自定义崩溃 …

设置要求
在开始之前,请确保您已经完成以下步骤:
所需软件和帐户
您需要安装以下内容:
- Node.js (v16 或更高) 和 Capacitor (v4 或更高)
- A 已激活的 Firebase 帐户 一个活跃的项目
- Xcode 14+ 用于 iOS 开发
- Android Studio Electric Eel 或更高版本 用于 Android 开发
- Capacitor 应用程序的最新版本 CocoaPods (iOS 必须)
平台配置文件
对于iOS:
- 从Firebase控制台下载
GoogleService-Info.plist更新您的 - 以包含Crashlytics依赖项
Podfile在您的 - 添加必要的隐私密钥
Info.plist对于Android:
获取
- 文件
google-services.json从 Firebase 控制台获取文件。 - 同时修改项目级别和应用级别的文件。
build.gradle文件。 - 更新到包含所需权限的文件。
AndroidManifest.xmlFirebase
Firebase 控制台设置 Firebase 平台控制台

创建 Firebase 项目并启用 Crashlytics。
-
注册您的应用 file from the Firebase Console.
-
Make changes to both the project-level and app-level files. 在 Firebase 控制台中:
- 使用 iOS 的 ID 和 Android 的 名称
- 下载配置文件:
GoogleService-Info.plist(iOS) 和google-services.json(Android).
-
将 Firebase SDK 集成到您的应用中,通过添加这些依赖项:
对于 Android (app-level
build.gradle):dependencies { implementation platform('com.google.firebase:firebase-bom:32.0.0') implementation 'com.google.firebase:firebase-crashlytics' implementation 'com.google.firebase:firebase-analytics' }For iOS (
Podfile):pod 'Firebase/Crashlytics' pod 'Firebase/Analytics'
完成以下步骤后,您可以进入插件安装部分。
安装步骤
插件安装
然后,同步插件与您的原生平台并查看 @capgo/capacitor-firebase-crashlytics Capacitor 插件页面,完整的API参考:
npm install @capgo/capacitor-firebase-crashlytics && npx cap sync
@code app.component.ts or main.ts:
import { FirebaseCrashlytics } from '@capgo/capacitor-firebase-crashlytics';
await FirebaseCrashlytics.initialize();
或
平台配置
设置 Android 和 iOS 平台所需的配置项
-
在您的应用级文件中添加 Crashlytics Gradle 插件
build.gradle文件:buildscript { dependencies { classpath 'com.google.firebase:firebase-crashlytics-gradle:2.9.5' } } apply plugin: 'com.google.firebase.crashlytics' -
在 iOS 设定中启用崩溃收集
AndroidManifest.xml:<meta-data android:name="firebase_crashlytics_collection_enabled" android:value="true" />
配置 Firebase
-
测试您的设定
AppDelegate.swift:import Firebase FirebaseApp.configure()
确认 Crashlytics 正在工作的方法是运行一个测试崩溃并检查 Firebase 控制台:
使用自定义键触发一个测试崩溃:
-
可选地,识别一个用户:
await FirebaseCrashlytics.setCustomKey({key: 'test_scenario', value: 'manual_crash'}); await FirebaseCrashlytics.crash(); -
记录自定义事件:
await FirebaseCrashlytics.setUserId({userId: 'user123'}); -
包括堆栈跟踪、设备详细信息和自定义键的报告,应该在大约 5 分钟内出现在 Firebase 控制台。
await FirebaseCrashlytics.log({message: 'Test crash triggered'});
重要:
file 在发布应用之前,移除崩溃调用。要在开发期间禁用崩溃收集,请使用:
await FirebaseCrashlytics.setCrashlyticsCollectionEnabled({enabled: false});
监控指南
一旦你确认了设置并通过测试崩溃,使用 Firebase 控制台来跟踪实际崩溃和错误在您的在线应用中:
阅读崩溃报告
您可以在 Firebase 控制台下的 Crashlytics 部分找到崩溃报告。以下是您将看到的内容:
- 无崩溃用户: 未经历崩溃的用户百分比。
- 问题稳定性: 崩溃发生的频率。
- 影响分析: 受影响的用户数量。
单击任何问题以深入了解详细信息,如堆栈跟踪、设备信息(例如 OS 版本、内存)、自定义键、日志和导致崩溃的用户旅程。
专业提示:
Error Management Tips
-
Prioritize by Impact:
-
Use Custom Keys: Add context to your crash reports with custom keys. For example:
await FirebaseCrashlytics.setCustomKey({ key: 'current_view', value: 'payment_processing' }); -
Group Similar Issues:
Protecting User Privacy
To ensure compliance and safeguard user data, follow these guidelines:
-
: :
- 请在隐私政策中提及崩溃报告。
- 在遵守GDPR法规的地区获取用户同意以收集数据。
- 向用户提供崩溃报告的选项。
-
数据收集控制:
await FirebaseCrashlytics.setCrashlyticsCollectionEnabled({enabled: false}); await FirebaseCrashlytics.setCrashlyticsCollectionEnabled({enabled: true}); -
数据保留:
- 设置自动删除数据90天后。
- 从报告中清除敏感信息。
- 使用非识别的自定义键来在调试时维护用户隐私。
Capgo 集成

通过将Capgo的live update系统与Crashlytics配对来简化从崩溃检测到修复部署的流程。
关于Capgo
Capgo是一款live update工具,专门为Capgo应用设计 Capacitor应用。通过超过1900个应用的生产和24小时内95%的更新率,它确保了快速修复而无需等待应用商店审批 [1].
关键功能包括:
- 端到端加密 用于安全更新
- 一键回滚 到之前的版本
- 基于频道的分发 用于目标发布
- 无缝CI/CD集成
- A 完全开源平台
Crashlytics与Capgo集成
Using Crashlytics with Capgo creates an efficient workflow for identifying and resolving issues quickly.
以下是如何实现的:
-
崩溃检测和响应
Crashlytics能够识别崩溃,并且Capgo允许您立即部署修复程序,而无需等待应用商店的批准。 -
目标更新
- 测试测试修复程序以确保它们有效。
- 阶段性发布逐步发布更新以减少风险。
- 紧急修复:快速推送关键补丁以解决紧急问题。
-
监控和验证
在部署了Capgo更新后,使用Crashlytics来追踪崩溃率并确认问题已经解决。
安全性和应用商店规则
:Capgo 遵守苹果和谷歌的政策,同时提供强大的安全功能:
- 全球成功率82% [1]
- 自动版本控制以更好地组织
- 遵守应用商店live update 指南
为与 Crashlytics 安全集成:
- 在两个系统中启用错误跟踪。
- 使用Capgo 的监控工具与 Crashlytics 报告一起使用。
- 保持所有更新的版本控制。
- 为审计目的保留详细的更新日志。
继续到插件选项部分,探索其他live update工具。
插件选项
选择合适的崩溃报告插件对识别和修复应用程序错误至关重要。
以下是Crashlytics与其他流行的错误报告工具的快速比较:Capacitor
- Sentry:提供免费层,付费计划从每月26美元开始。支持超过30个平台,提供实时错误监控和详细上下文。
- Bugsnag:从每月47美元开始。涵盖移动和web平台,具有自动错误分组和发布跟踪功能。
- Rollbar:价格从每月31美元起。支持多个平台,具有部署跟踪和人跟踪功能。
Crashlytics 对于已经使用 Firebase 的团队来说尤其有吸引力,因为它的整合非常Smooth,并且有免费的层次。
概要
快速回顾一下您已经完成了什么以及接下来要做什么:
设置步骤回顾
您已经完成了三个关键步骤:
- 创建了 Firebase 项目并注册了 iOS/Android 应用。
- 安装并配置了 Crashlytics 插件。
- 更新了必要的 iOS 和 Android 平台文件。
context
Pairing Firebase Crashlytics with Capgo gives you a powerful system for error tracking and crash reporting. 为什么要整合这些工具?将 Firebase Crashlytics 与 __CAPGO_KEEP_0__ 配对起来,可以为您提供一个强大的错误跟踪和更新管理系统。
- 快速修复: 只需一键即可推送即时更新并回滚更改。
- 可靠的发布: 确保更新广泛采用并顺利向用户推送。
接下来是什么?
- 在 Firebase 控制台中启用详细的崩溃分析。
- 将 Capgo 添加到 CI/CD pipeline 中以实现流程化更新。
- 使用 Capgo 通道 来逐步测试和发布修复。
在 Crashlytics 和 Capgo 的帮助下,您可以确保您的应用程序始终保持稳定并不断改进。
继续使用 Firebase Crashlytics 为 Capacitor 应用程序
如果您正在使用 使用 Firebase Crashlytics 为 Capacitor 应用 为了计划原生插件工作,连接它与 Capgo 插件目录 在 Capgo 插件目录中 Capacitor 插件由 Capgo 提供 为 Capacitor 插件的实现细节提供了 Capgo 了解 __CAPGO_KEEP_0__ 插件的实现细节 添加或更新插件 了解添加或更新插件的实现细节 Ionic 企业插件替代品 Capgo 原生构建 为Capgo原生构建的产品工作流程。