Firebase Crashlytics for Capacitor 应用

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

为什么要使用 Crashlytics？
- 获取 实时崩溃警报.
- 使用自动问题分组的详细崩溃报告进行分析 监控关键错误以保持应用稳定.
- 设置要求：
安装
- Node.js (v16+) Why Use Crashlytics? (header) - Why Use Crashlytics?, 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 实现即时实时更新，避免应用商店延迟。

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

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

Firebase Crashlytics

设置要求

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

所需软件和帐户

您需要安装以下内容：

Node.js (v16 或更高版本) 和 Capacitor __CAPGO_KEEP_0__
A 需要一个有活跃项目的Firebase账户 需要一个有活跃项目的Firebase账户
需要Xcode 14或更高版本 需要Xcode 14或更高版本
需要Android Studio Electric Eel或更高版本 需要Android Studio Electric Eel或更高版本
最新版本的 CocoaPods （iOS开发必需）

平台配置文件

For iOS：

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

对于 Android：

从 Firebase 控制台获取 google-services.json 文件。
同时修改项目级别和应用级别的 build.gradle 文件。
更新 AndroidManifest.xml __CAPGO_KEEP_0__

Firebase Firebase 控制台设置

Firebase 平台控制台

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

创建一个 Firebase 项目 并启用 Crashlytics。
在 Firebase 控制台中注册您的应用: 使用
- bundle ID 在 Firebase 控制台中注册您的应用： 为 iOS 和 Android 设备开发 __CAPGO_KEEP_0__ 为 Android 设备开发
- 下载配置文件： GoogleService-Info.plist (iOS) 和 (Android) google-services.json 将 Firebase SDK 集成到您的应用中，通过添加这些依赖项：

为 Android (app-level 为 iOS (

完成这些步骤后，您就可以进入插件安装部分 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'
}

安装步骤Podfile):

pod 'Firebase/Crashlytics'
pod 'Firebase/Analytics'

__CAPGO_KEEP_1__

__CAPGO_KEEP_2__

插件安装

首先，安装插件并与Capacitor:

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平台设置所需的配置。

Android设置

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

在 Firebase 控制台中，包括堆栈跟踪、设备详细信息和自定义密钥的报告，约 5 分钟内就会出现。

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

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

监控指南

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

阅读崩溃报告

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

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

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

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

错误管理提示

根据影响优先: Focus on crashes that affect the most users or occur in critical parts of your app. Tracking trends can help you identify urgent issues.

Use Custom Keys: 使用自定义键添加上下文到崩溃报告中。例如：

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

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

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

权限

在隐私政策中提及崩溃报告。:
- 在 GDPR 规则管辖的地区获取用户同意进行数据收集。
- 为用户提供选择是否退出崩溃报告的选项。
- 数据收集控制

Data Collection Controls:

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

数据保留期:
- 自动删除数据后 90 天。
- 清除敏感信息的报告。
- 在调试时使用不可识别的自定义密钥来维护用户隐私。

Capgo 集成

Capgo 实时更新控制台界面

Streamline the process from crash detection to fix deployment by pairing Capgo’s live update system with Crashlytics.

关于 Capgo

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

主要功能包括：

端到端加密 确保安全更新
一键回滚 到上一个版本
基于频道的分发 为目标发布
无缝的CI/CD集成
100%开源平台 Crashlytics和__CAPGO_KEEP_0__一起使用

使用Crashlytics与Capgo创建高效的工作流程，快速识别和解决问题。

使用Crashlytics与Capgo可以快速识别和解决问题，提高工作效率。

这里是如何工作的：

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

安全和应用商店规则

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

全球更新成功率达82% [1]
自动版本控制，提高组织化
遵守应用商店实时更新指南

为Crashlytics安全集成：

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

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

插件选项

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

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

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

Crashlytics尤其适合使用Firebase的团队，因为它具有smooth的集成和免费层。

概要

以下是您完成的快速回顾和下一步的概要：

设置步骤回顾

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

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

为什么要整合这些工具？

Pairing Firebase Crashlytics with Capgo gives you a powerful system for error tracking and __CAPGO_KEEP_0__管理系统。以下是这个组合的优势：

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

What's Next?

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

在 Crashlytics 和 Capgo 的帮助下，您可以确保您的应用程序能够长期稳定并不断改进。

Capacitor应用的Firebase Crashlytics