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

Capacitor 应用程序的 Firebase Crashlytics

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

马丁·多纳迪尤

马丁·多纳迪尤

内容营销人员
Capacitor 应用程序的 Firebase Crashlytics

Firebase Crashlytics 帮助您实时跟踪应用程序崩溃，提供详细的报告以快速修复问题。它与 __CAPGO_KEEP_0__ Capacitor helps you track app crashes in real-time, providing detailed reports to fix issues quickly. It integrates seamlessly with __CAPGO_KEEP_0__ for both iOS and Android apps. Here’s what you need to know:

  • 为什么要使用 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的必需)

平台配置文件

用于iOS:

  • 下载 GoogleService-Info.plist 从 Firebase 控制台获取文件。
  • 更新 Podfile 添加 Crashlytics 依赖项。
  • 在文件中添加必要的隐私密钥。 Info.plist 文件。

Android:

  • 从 Firebase 控制台获取文件。 google-services.json 同时修改项目级别和应用级别的
  • 文件。 build.gradle 更新
  • 添加所需的权限。 AndroidManifest.xml For more information, please refer to the official documentation.

Firebase 控制台设置

Firebase 平台控制台

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

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

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

    • iOS 的 包名 for Android package name 为 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'

安装步骤

插件安装

然后，同步插件与您的原生平台并查看结果.

Installation Steps @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 是一种专门为 Capacitor 应用程序设计的实时更新工具。它确保了在 24 小时内实现 95% 的更新率，且有超过 1,900 个应用程序在生产环境中运行，而不受应用商店审批延迟的影响。 [1].

关键功能包括：

  • 端到端加密 安全更新
  • 一键回滚 到上一个版本
  • 基于通道的分发 针对性的发布
  • CI/CD无缝集成
  • A 100%开源平台

Crashlytics和Capgo一起使用

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

这是如何工作的：

  1. 崩溃检测和响应
    Capgo能够立即部署修复程序，而不必等待应用商店的批准，Crashlytics识别崩溃。

  2. 目标更新

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

  3. 部署更新后，使用__CAPGO_KEEP_0__，Crashlytics跟踪崩溃率并确认问题解决。
    After deploying updates with Capgo, use Crashlytics to track crash rates and confirm the issue is resolved.

安全和应用商店规则

Capgo 遵循 Apple 和 Google 的政策，同时提供强大的安全功能：

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

为 Crashlytics 的安全集成提供支持：

  • 在两个系统中启用错误跟踪功能。
  • 使用 Capgo 的监控工具与 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 更新管理系统。以下是这个组合的优势:

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

接下来是什么?

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

在 Crashlytics 和 Capgo 的帮助下，您可以确保您的应用程序能够顺利运行并不断改进。

从 Firebase Crashlytics 中继续使用 Capacitor 应用程序。

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

实时更新 Capacitor 应用

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

立即开始

最新博客文章

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

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

Capacitor 应用中的双向通信

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

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

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

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

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