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

为Capacitor应用集成Firebase Crashlytics

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

马丁·多纳迪厄

马丁·多纳迪厄

Content Marketer
Firebase Crashlytics 为 Capacitor 应用程序

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

  • 实时崩溃警报

    • 分析详细的崩溃报告，自动分组问题 监控关键错误以保持应用程序稳定.
    • Get real-time crash alerts Analyze detailed crash reports with automatic issue grouping.
    • Monitor critical errors to keep apps stable

  • 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();

  • 附加提示： Combine Crashlytics with 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 更新
  • 以包含Crashlytics依赖项 Podfile 在
  • 添加必要的隐私密钥 Info.plist 对于Android:

__CAPGO_KEEP_0__

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

创建 Firebase 项目并启用 Crashlytics。 在 Firebase 控制台中获取文件。

同时修改项目级别和应用级别的文件。

更新以包含所需权限的

  1. 在 Firebase 控制台中设置 Firebase 平台控制台

  2. 在 Firebase 控制台中注册您的应用： 使用 iOS 的

    • bundle ID 和 Android 的 package name 下载配置文件： (iOS) 和
    • (Android). GoogleService-Info.plist 将 Firebase SDKs google-services.json 集成到您的应用中，通过添加这些依赖项：

  3. __CAPGO_KEEP_0__ __CAPGO_KEEP_1__

    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'

完成这些步骤后，您可以继续阅读插件安装部分

Installation Steps

Plugin Installation

首先，安装插件并 同步它与 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 Setup

  1. 在应用级文件中添加Crashlytics Gradle插件： build.gradle __CAPGO_KEEP_0__:

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

记录自定义事件：

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

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

监控指南

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

阅读崩溃报告

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

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

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

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

Error Management Tips

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

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

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

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

Protecting User Privacy

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

  • Permissions:

    • 在隐私政策中提及崩溃报告。
    • 在遵守GDPR法规的地区获取用户同意进行数据收集。
    • 向用户提供崩溃报告的选项以让他们可以退出。

  • 数据收集控制:

    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%开源平台

Crashlytics和Capgo一起使用

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

这是如何工作的：

  1. 崩溃检测和响应
    Crashlytics检测到崩溃，Capgo允许您立即部署修复程序，而无需等待应用商店的批准。

  2. 目标更新

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

  3. 监控和验证
    After deploying updates with Capgo, use Crashlytics to track crash rates and confirm the issue is resolved.

安全性和应用商店规则

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

  • 全球成功率 82% [1]
  • 自动版本控制
  • 遵守应用商店实时更新指南

为了安全地与 Crashlytics 集成：

  • 在两个系统中启用错误跟踪。
  • 使用 Capgo 的监控工具与 Crashlytics 报告一起使用。
  • Maintain version control for all updates.
  • Keep detailed logs of updates for auditing purposes.

Continue to the Plugin Options section to explore other live update tools.

Plugin Options

Choosing the right crash-reporting plugin can greatly impact how you identify and fix errors in your app.

Here’s a quick comparison of Crashlytics with other popular error-reporting tools for Capacitor:

  • Sentry: Offers a free tier with paid plans starting at $26/month. Supports over 30 platforms and provides real-time error monitoring with detailed context.
  • Bugsnag: Starts at $47/month. Covers both mobile and web platforms, featuring automatic error grouping and release tracking.
  • Rollbar: Priced from $31/month. Works across multiple platforms, with features like deployment tracking and person tracking.

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

概要

这是您完成的快速查看和即将到来的内容：

设置步骤回顾

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

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

为什么集成这些工具？

将 Firebase Crashlytics 与 Capgo 配对起来，给您一个强大的错误跟踪和 更新管理系统。以下是这个组合的优势：

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

接下来是什么?

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

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

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

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

为 Capacitor 应用实时更新

当 web 层 bug 活跃时，通过 Capgo 直接将修复推送给用户，而不是等待几天的 app store 审核。用户在后台接收更新，而原生代码仍然在正常的审查路径中。

立即开始

博客最新文章

Capgo 为您提供了创建真正专业的移动应用所需的最佳见解。

Capacitor 应用中的双向通信
开发,移动,更新
2025年4月26日

双向通信在Capacitor应用中

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

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

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

5 移动应用实时更新的安全最佳实践

查看我们博客中的所有内容