Firebase Crashlytics for Capacitor Apps

Firebase Crashlytics 帮助您实时跟踪应用程序崩溃，提供详细的报告以快速修复问题。它与 Capacitor 为 iOS 和 Android 应用程序提供服务。以下是您需要了解的内容：

为什么使用 Crashlytics？
- 获取 实时崩溃警报.
- 分析详细的崩溃报告，包括 自动问题分组.
- 监控关键错误以保持应用程序稳定。
设置要求：
- 安装 Node.js (v16+), Capacitor (v4+), 和工具类似 Xcode 14+ 和 安卓 studio 电击电鳐.
- 下载 Firebase 配置文件 (GoogleService-Info.plist 为 iOS google-services.json ，
- 为 Android). Podfile 更新平台相关文件，如 build.gradle （iOS）和

（Android).

关键步骤：

npm install @capgo/capacitor-firebase-crashlytics && npx cap sync

安装 Crashlytics：

import { FirebaseCrashlytics } from '@capgo/capacitor-firebase-crashlytics';
await FirebaseCrashlytics.initialize();

在您的应用中初始化 Crashlytics：
- 测试您的设置：
```
await FirebaseCrashlytics.crash();
```
触发测试崩溃： 附加提示： Capgo 立即获得实时更新，避免应用商店延迟。

本指南确保您的应用程序崩溃免费且用户友好。立即开始设置 Firebase Crashlytics!

2021 Android 指南： Firebase Crashlytics - 自定义崩溃 …

Firebase Crashlytics

设置要求

在开始之前，请确保您已经完成以下步骤：

所需软件和帐户

您需要安装以下内容：

Node.js (v16 或更高) 和 Capacitor (v4 或更高)
A 已激活的 Firebase 帐户 一个活跃的项目
Xcode 14+ 用于 iOS 开发
安卓 studio 电光 eel 或更高版本用于 Android 开发
Capacitor 应用程序的最新版本 CocoaPods （必需的，适用于iOS）

平台配置文件

对于 iOS:

从 Firebase 控制台下载 GoogleService-Info.plist 更新您的
以包含 Crashlytics 依赖项 Podfile 在您的
添加必要的隐私密钥 Info.plist 对于 Android:

获取

配置文件 google-services.json 从 Firebase 控制台获取文件。
同时修改项目级别和应用级别的文件。 build.gradle 文件。
更新 AndroidManifest.xml 以包含所需权限。

Firebase Firebase 控制台设置

Firebase 平台控制台

通过以下步骤设置 Firebase 并启用 Crashlytics:

创建 Firebase 项目 并启用 Crashlytics。
注册您的应用 在 Firebase 控制台中：
- 使用 iOS 的 包 ID 和 Android 的 包名
- 下载配置文件： GoogleService-Info.plist （iOS）和 google-services.json （Android）。

将 Firebase SDK 集成到您的应用中，通过添加这些依赖项： 对于 Android（应用级

protectedTokens 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'
}

对于 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'});
```

重要:

iOS Setup 在发布应用之前，移除崩溃调用。要在开发期间禁用崩溃收集，请使用：

await FirebaseCrashlytics.setCrashlyticsCollectionEnabled({enabled: false});

监控指南

一旦你确认了你的设置并通过测试崩溃后，使用 Firebase 控制台来跟踪实际崩溃和错误在你的线上应用中。

阅读崩溃报告

你可以在 Firebase 控制台下的 Crashlytics 部分找到崩溃报告。以下是你会看到的内容：

无崩溃用户: 未经历崩溃的用户百分比。
问题稳定性: 崩溃发生的频率。
影响分析: 受影响的用户数量。

点击任何问题以深入了解详细信息，如堆栈跟踪、设备信息（例如 OS 版本、内存）、自定义键、日志和导致崩溃的用户旅程。

Pro 提示: 启用“速度警报”功能，以便在崩溃率突然增加时收到通知。这可以帮助您在问题影响太多用户之前解决问题。

错误管理提示

按影响程度排序: 将重点放在影响最多用户或发生在应用关键部分的崩溃上。跟踪趋势可以帮助您识别紧急问题。

使用自定义键: 在崩溃报告中添加自定义键。例如：

await FirebaseCrashlytics.setCustomKey({
  key: 'current_view',
  value: 'payment_processing'
});

类似问题分组: 利用 Firebase 的自动问题分组功能。您还可以使用一致的自定义键标记相关崩溃，并使用清晰、描述性的标题进行更容易的跟踪。

保护用户隐私

: 以确保遵守和保护用户数据，请遵循以下指南：

权限:
- 请在隐私政策中提及崩溃报告。
- 在遵守GDPR法规的地区获取用户同意以收集数据。
- 向用户提供崩溃报告的选项。

数据收集控制:

await FirebaseCrashlytics.setCrashlyticsCollectionEnabled({enabled: false});
await FirebaseCrashlytics.setCrashlyticsCollectionEnabled({enabled: true});

数据保留:
- 设置自动删除数据90天后。
- 从报告中清除敏感信息。
- 使用非识别的自定义键来在调试时维护用户隐私。

Capgo 集成

Capgo Live Update 控制台界面

通过将Capgo的live update系统与Crashlytics配对，简化从崩溃检测到修复部署的流程。

关于Capgo

Capgo 是一款 live update 工具，专门为 Capgo 应用程序设计 Capacitor 应用程序。通过超过 1900 个生产应用程序和 24 小时内 95% 的更新率，它确保了快速修复而无需等待应用商店批准 [1].

关键功能包括:

端到端加密 用于安全更新
一键回滚 到上一个版本
基于频道的分发 用于目标发布
无缝 CI/CD 集成
A 完全开源平台

Crashlytics和Capgo

使用 Crashlytics 与 Capgo 可以快速高效地识别和解决问题。

以下是如何工作的:

崩溃检测和响应
Crashlytics 能够识别应用程序崩溃，Capgo 允许您立即部署修复程序，而无需等待应用商店的批准。
目标更新
- 测试测试修复程序以确保它们有效。
- 阶段性部署逐渐部署更新以减少风险。
- 紧急修复:快速推送关键补丁来解决紧急问题。
监控和验证
在部署了Capgo更新后，使用 Crashlytics 跟踪崩溃率并确认问题已解决。

安全性和应用商店规则

:Capgo遵守苹果和谷歌的政策，同时提供强大的安全功能:

全球成功率82% [1]
自动版本控制
遵守应用商店live update指南

为Crashlytics的安全集成:

在两个系统中启用错误跟踪。
使用Capgo的监控工具与Crashlytics报告一起使用。
保持所有更新的版本控制。
为审计目的保留详细的更新日志。

继续到插件选项部分，探索其他live update工具。

插件选项

选择合适的崩溃报告插件对您识别和修复应用程序错误至关重要。

以下是Crashlytics与其他流行的错误报告工具的快速比较：Capacitor

Crashlytics: 提供免费层，付费计划从每月26美元开始。支持超过30个平台，提供实时错误监控以及详细的上下文。
Bugsnag: 从每月47美元开始。涵盖移动和web平台，具有自动错误分组和发布跟踪功能。
Rollbar: 价格从每月31美元起。支持多个平台，具有部署跟踪和人员跟踪功能。

Crashlytics 对于已经使用 Firebase 的团队来说尤其有吸引力，因为它的整合非常Smooth，并且有免费的层次。

概要

快速回顾一下您已经完成的工作和下一步骤:

设置步骤回顾

您已经完成了三个关键步骤:

创建了 Firebase 项目并注册了 iOS/Android 应用。
安装并配置了 Crashlytics 插件。
更新了必要的 iOS 和 Android 平台文件。

上述工具的整合理由

将 Firebase Crashlytics 与 Capgo 配对起来，可以为您提供一个强大的错误跟踪和更新管理系统。此组合提供了以下优势：update management

快速修复: 只需一键即可推送即时更新并回滚更改。
可靠的发布: 确保更新广泛采用并顺利向用户交付。

下一步

: 在 Firebase 控制台中启用详细的崩溃分析。
将 Capgo 添加到您的 CI/CD pipeline 中以实现流程化更新。
使用 Capgo 通道来逐步测试和发布修复。

在 Crashlytics 和 Capgo 的帮助下，您可以确保您的应用程序始终保持平稳并不断改进。

继续使用 Firebase Crashlytics 为 Capacitor 应用程序

如果您正在使用 使用 Firebase Crashlytics 为 Capacitor 应用 为了计划原生插件工作，连接它与 Capgo 插件目录在 Capgo 插件目录中，了解产品工作流程 Capacitor 插件由 Capgo 了解在 Capacitor 插件由 Capgo 中的实现细节添加或更新插件了解添加或更新插件中的实现细节 Ionic 企业插件替代品了解 Ionic 企业插件替代品中的产品工作流程 Capgo 原生构建为Capgo原生构建的产品工作流程。