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

Firebase Crashlytics for Capacitor Apps

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

Martin Donadieu

Martin Donadieu

内容创作者
Firebase Crashlytics for Capacitor Apps

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

  • 为什么使用 Crashlytics?

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

  • 设置要求：

    • 安装 Node.js (v16+), Capacitor (v4+), 和工具类 Xcode 14+ 和 Android Studio 电鳐.
    • 下载 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 Guide: Firebase Crashlytics - custom crash …

Firebase Crashlytics

Setup Requirements

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

Required Software and Accounts

您需要安装以下软件:

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

平台配置文件

对于 iOS：

  • 从 Firebase 控制台下载 GoogleService-Info.plist 更新您的
  • 以包含 Crashlytics 依赖项。 Podfile 将必要的隐私密钥添加到您的
  • 对于 Android： Info.plist 从 Firebase 控制台获取

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

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

Firebase 控制台设置

Firebase 平台仪表板

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

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

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

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

  3. 将 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_0__

插件安装

然后，同步插件与您的原生平台并查看 @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. 在 {__CAPGO_KEEP_0__} 中配置 Firebase AppDelegate.swift:

    import Firebase
FirebaseApp.configure()

测试您的配置

通过运行测试崩溃并检查 Firebase 控制台来确认 Crashlytics 是否正常工作:

  • 使用自定义 key 触发测试崩溃:

    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 控制台中，包括堆栈跟踪、设备详细信息和自定义 key 的报告，约 5 分钟内就会出现。

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

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

监控指南

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

阅读崩溃报告

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

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

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

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

错误管理提示

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

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

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

  • : 确保遵守法规并保护用户数据，请遵循以下指南：: 在隐私政策中提及崩溃报告。

: 在遵守 GDPR 法规的地区获取用户对数据收集的同意。

: 为用户提供崩溃报告的选项，允许他们退出崩溃报告。

  • Protecting User Privacy:

    • Permissions
    • Get user consent for data collection in regions with GDPR regulations.
    • Provide users with an option to opt-out of crash reporting.

  • 数据收集控制:

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

  • 数据保留:

    • 自动删除数据后 90 天。
    • 清除敏感信息
    • 使用非识别的自定义键来在调试时维护用户隐私。

Capgo 集成

Capgo Live Update Dashboard Interface

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

关于 Capgo

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

关键功能包括：

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

Crashlytics 和 Capgo Together

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

以下是如何工作的:

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

  2. 目标更新

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

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

安全性和应用商店规则

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

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

为了安全地与Crashlytics集成:

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

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

插件选项

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

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

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

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

总结

: 以下是你已经完成的快速概览以及下一步是什么:

快速设置概述

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

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

为什么集成这些工具?

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

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

下一步是什么?

  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 应用

当 web 层 bug 活跃时，通过 Capgo 将修复推送，而不是等待几天的应用商店审批。用户在后台接收更新，而原生更改仍在正常审批路径中。

来自 Martin 的人性化支持

立即开始

最新博客文章

Capgo 给您需要创建真正专业的移动应用所需的最佳见解。

双向通信在 Capacitor 应用中
开发 移动 +1
2025年4月26日

Capacitor应用中的双向通信

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

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

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

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

查看我们博客的所有内容