跳过主要内容
Capgo logo
开发 移动 更新

Firebase Crashlytics for Capacitor Apps

了解如何将实时崩溃报告集成到您的移动应用程序中，了解如何设置崩溃日志的步骤指南，适用于iOS和Android。

马丁·多纳迪厄

马丁·多纳迪厄

内容营销
Firebase Crashlytics for Capacitor Apps

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

  • 为什么要使用 Crashlytics?

    • 获取 实时崩溃警报.
    • 分析详细崩溃报告，包括 自动问题分组.
    • 监控关键错误，保持应用程序稳定。

  • 设置要求：

    • 安装 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 以即时实时更新而无需等待应用商店延迟。

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

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

Firebase Crashlytics

设置要求

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

所需软件和帐户

您需要安装以下内容：

  • Node.js (v16 或更高版本) 和 Capacitor （v4 或更高）
  • A Firebase 账户 具有活跃项目的
  • Xcode 14+ 用于 iOS 开发
  • Android Studio Electric Eel 或用于 Android 开发的更新版本
  • 最新版本的 CocoaPods （iOS 需要）

平台配置文件

For iOS：

  • 下载 Firebase 控制台中的 GoogleService-Info.plist Update your
  • 到包含 Crashlytics 依赖项的 Podfile 在文件中添加必要的隐私密钥。
  • For Android： Info.plist 从 Firebase 控制台中获取

修改项目级别和应用级别的

  • files. google-services.json files.
  • files. build.gradle files.
  • 更新 AndroidManifest.xml 以包含所需权限

Firebase 控制台设置

Firebase 平台仪表板

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

  1. 创建 Firebase 项目 并启用 Crashlytics。

  2. 在 Firebase 控制台中注册您的应用程序: 使用

    • 包 ID bundle ID 为 iOS 和 包名 为 Android。
    • 下载配置文件: GoogleService-Info.plist (iOS) 和 google-services.json (Android).

  3. 将 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'
}

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

Android设置

  1. 将Crashlytics Gradle插件添加到您的应用级 build.gradle 文件:

    buildscript { 
    dependencies { 
        classpath 'com.google.firebase:firebase-crashlytics-gradle:2.9.5' 
    } 
}
apply plugin: 'com.google.firebase.crashlytics'

  2. 启用崩溃收集在 AndroidManifest.xml:

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

iOS 配置

  1. 在 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'});

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

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

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

监控指南

您确认了您的设置后，使用 Firebase 控制台来跟踪您的实时应用中的实际崩溃和错误。

查看崩溃报告

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

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

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

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

错误管理技巧

  • 根据影响的程度进行优先排序:关注影响最多用户或发生在应用关键部分的崩溃。跟踪趋势可以帮助您识别紧急问题。

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

    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 Dashboard Interface

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

关于 Capgo

Capgo 是一款专门为 Capgo 应用程序设计的实时更新工具 Capacitor 应用程序拥有超过 1900 个在生产中的应用程序和 95% 的应用程序在 24 小时内更新率，确保快速修复而不受应用商店审批延迟 [1].

关键功能包括：

  • 端到端加密 上下文：Capgo 营销网站。角色：短 UI 标签或导航项。消息键 `end_to_end_encryption` (端到端加密)。
  • 安全更新 一键回滚
  • 到上一个版本 基于频道的分发
  • 为目标发布
  • 无缝 CI/CD 集成 一个

Crashlytics and Capgo Together

使用Capgo与Capgo集成，能够高效地识别和解决问题。

以下是其工作原理：

  1. 故障检测和响应
    Capgo能够识别故障，并且Capgo允许您立即部署修复程序，而无需等待应用商店的批准。

  2. 目标更新

    • 测试测试修复程序以确保它们有效。
    • 分阶段部署逐渐部署更新以减少风险。
    • 紧急修复快速推送关键补丁以解决紧急问题。

  3. 监控和验证
    在部署了Capgo更新后，使用Crashlytics来跟踪崩溃率并确认问题已经解决。

安全性和应用商店规则

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 平台文件。

为什么集成这些工具?

将 Firebase Crashlytics 与 Capgo 集成起来，给您一个强大的错误跟踪和更新管理系统。 更新管理. Here’s what this combo offers:

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

下一步是什么?

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

在使用 Crashlytics 和 Capgo 后，您可以确保您的应用程序能够顺利运行并随着时间的推移而不断改进。

继续使用 Firebase Crashlytics for Capacitor Apps

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

Capacitor 应用实时更新

Capgo 应用实时更新

当 web 层面的 bug 在 live 时，通过 __CAPGO_KEEP_0__ 直接将修复推送给用户，而不必等待几天的 app store 审核。用户在后台接收更新，而 native 的变化仍然在正常的审查路径中。

来自 Martin 的人工支持

立即开始

Capgo gives you the best insights you need to create a truly professional mobile app.

Capacitor 应用双向通信
__CAPGO_KEEP_0__ 应用双向通信 开发 +1
2025年4月26日

双向通信在Capacitor应用中

避免的5种OTA更新常见错误
开发 安全性 +1
2025年4月13日

避免的5种OTA更新常见错误

移动应用实时更新的5种安全最佳实践
开发 移动 +1
2025年1月14日

5条关于移动应用程序实时更新的安全最佳实践

查看我们博客的所有内容