Firebase Crashlytics for Capacitor 应用

Firebase Crashlytics 帮助您实时跟踪应用程序崩溃，提供详细的报告以快速修复问题。它与 __CAPGO_KEEP_0__ 完美集成，适用于 iOS 和 Android 应用程序。以下是您需要了解的内容： Capacitor 获取

实时崩溃警报
- 分析详细的崩溃报告，自动分组问题 监控关键错误以保持应用程序稳定.
- __CAPGO_KEEP_0__ __CAPGO_KEEP_0__.
- Get
Setup Requirements:
- 安装 Node.js (v16+), Capacitor (v4+), 和工具如 Xcode 14+ 和 Android Studio Electric Eel.
- 下载 Firebase 配置文件（GoogleService-Info.plist 用于iOS google-services.json 用于Android）。
- 更新平台特定的文件，如 Podfile (iOS) 和 build.gradle (Android)。

关键步骤：

安装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 即刻实时更新，避免app store延迟。

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

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

Firebase Crashlytics

设置要求

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

所需软件和帐户

You’ll need to install the following:

Node.js (v16 or higher) and Capacitor (v4 or higher)
A Firebase 一个有活跃项目的
Xcode 14+ 用于 iOS 开发
Android Studio Electric Eel 或更高版本的 Android 开发
最新版本的 CocoaPods (iOS所需)

平台配置文件

iOS：

从Firebase控制台下载 GoogleService-Info.plist 文件
更新 Podfile 以包含Crashlytics依赖项
添加必要的隐私密钥到 Info.plist 文件

Android：

从 Firebase 控制台获取文件。 google-services.json 同时修改项目级别和应用级别的文件。
更新文件以包含所需的权限。 build.gradle Firebase 控制台设置
Firebase 平台控制台 AndroidManifest.xml 通过以下步骤设置 Firebase 并启用 Crashlytics:

创建 Firebase 项目并启用 Crashlytics。 Firebase Console

Firebase Platform Dashboard

通过以下步骤设置 Firebase 和 Crashlytics:

创建一个 Firebase 项目并启用 Crashlytics。 从 Firebase 控制台获取文件
注册您的应用 在 Firebase 控制台:
- 使用 __CAPGO_KEEP_0__ 的 iOS 和 __CAPGO_KEEP_0__ 的 Android。
- 下载配置文件: GoogleService-Info.plist (iOS) 和 google-services.json (Android).

将 Firebase SDK 集成到您的应用中，通过添加这些依赖项： 在 Firebase 控制台中注册您的应用

For 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 插件页面查看完整API参考：

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

然后，在您的应用中初始化Crashlytics。添加以下code app.component.ts 或 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'

在 AndroidManifest.xml:

<meta-data
    android:name="firebase_crashlytics_collection_enabled"
    android:value="true" />

iOS 设置

配置 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'});

记录自定义事件:

await FirebaseCrashlytics.log({message: 'Test crash triggered'});

__CAPGO_KEEP_0__，包括堆栈跟踪、设备详细信息和自定义键，应该在大约 5 分钟内出现在 Firebase 控制台中。

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

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

监控指南

一旦您确认了测试崩溃，请使用 Firebase 控制台来跟踪您的实时应用中的实际崩溃和错误。

阅读崩溃报告

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

无崩溃用户: 没有遇到崩溃的用户百分比。
问题稳定性: 崩溃发生的频率。
影响分析: 受影响的用户数量。

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

专业提示：错误管理提示

根据影响程度优先

关注影响最多用户或发生在应用关键部分的崩溃。跟踪趋势可以帮助您识别紧急问题。使用自定义键

例如：类似问题分组

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

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

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

__CAPGO_KEEP_0__

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

数据收集控制:

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

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

Capgo 集成

Capgo 实时更新控制台界面

通过将Capgo的实时更新系统与Crashlytics配对，简化从崩溃检测到修复部署的整个过程。

关于Capgo

Capgo是一款专门为Capgo应用设计的实时更新工具。 Capacitor应用目前有超过1900个应用在生产环境中运行，24小时内更新率达95%，它确保了快速修复而无需等待应用商店审批。 [1].

关键功能包括：

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

Capgo和Crashlytics一起使用

使用Capgo和Crashlytics可以快速识别和解决问题

这是如何工作的:

崩溃检测和响应
Crashlytics检测崩溃,Capgo允许您立即部署修复程序，而无需等待应用商店批准
目标更新
- Beta测试:测试修复程序与特定组以确保它们有效
- 分阶段发布: __CAPGO_KEEP_0__逐步部署更新以降低风险。
- 紧急修复: 快速推送关键补丁以解决紧急问题。
监控和验证
After deploying updates with Capgo, use Crashlytics to track crash rates and confirm the issue is resolved.

安全性和应用商店规则

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

全球成功率82%：安全地交付更新 [1]
自动版本控制以更好地组织
遵守应用商店实时更新指南

为了安全地与Crashlytics集成：

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

继续到插件选项部分来探索其他实时更新工具。

插件选项

选择合适的崩溃报告插件对您识别和修复应用程序错误的方式有着重大影响。

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

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

Crashlytics 对于已经使用 Firebase 的团队来说尤其有吸引力，感谢其smooth 的集成和免费层次。

概要

快速浏览您已经完成的工作和即将到来的内容：

设置步骤回顾

您已经完成了三个关键步骤以开始：

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

为什么集成这些工具?

将 Firebase Crashlytics 与 Capgo 配对起来，给您一个强大的错误跟踪和更新管理系统。概要. 这个组合提供了什么？

快速修复：使用单击即可推送即时更新并回滚更改。
可靠的发布：确保更新广泛采用并顺利地向用户交付。

接下来是什么？

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

在 Crashlytics 和 Capgo 的帮助下，您的应用程序将能够保持平稳运行并随着时间的推移而不断改进。

从 Firebase Crashlytics 迁移到 Capacitor 应用

如果您正在使用 Firebase Crashlytics 为 Capacitor 应用 来规划原生插件工作，连接它到 Capgo 插件目录在 Capgo 插件目录中 Capacitor 插件由 Capgo 在 Capacitor 插件由 Capgo 中添加或更新插件在添加或更新插件中 Ionic Enterprise 插件替代方案在 Ionic Enterprise 插件替代方案中 Capgo 原生构建为产品工作流程中的 Capgo 原生构建。