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

Capacitor应用的Firebase Crashlytics

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

马丁·多纳迪厄

马丁·多纳迪厄

内容营销
Capacitor应用的Firebase Crashlytics

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_KEEP_0__ Capgo 本指南确保您的应用程序崩溃免费且用户友好。今天开始设置 Firebase Crashlytics！

__CAPGO_KEEP_0__

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：

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

For Android：

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

Firebase 控制台设置

Firebase 平台控制台

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

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

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

    • 包 ID Firebase Console 为 iOS 和 Android 设备开发。 包名 为 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. 在中配置 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 版本、内存）、自定义键、日志和导致崩溃的用户旅程。

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

错误管理提示

  • Prioritize by Impact: 优先处理影响最多用户或发生在应用关键部分的崩溃。跟踪趋势可以帮助您识别紧急问题。

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

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

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

Protecting User Privacy

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

  • Permissions:

    • 在隐私政策中提及崩溃报告。
    • Get user consent for data collection in regions with GDPR regulations.
    • 在遵守 GDPR 法规的地区，向用户获取数据收集的同意。

  • 数据收集控制:

    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 是一款专门为 Capgo 应用设计的实时更新工具。 Capacitor 应用. 在超过 1,900 个应用程序中运行并且在 24 小时内实现 95% 的更新率，确保快速修复而无需等待应用商店审批 [1].

关键功能包括：

  • 端到端加密 为安全更新
  • 一键回滚 到之前的版本
  • 基于通道的分发 为目标发布
  • 无缝 CI/CD 集成
  • A 100% 开源平台

Crashlytics 和 Capgo Together

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

以下是它的工作原理：

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

  2. 目标更新

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

  3. 监控和验证
    After Capgo 发布更新后，使用 Crashlytics 跟踪崩溃率并确认问题已解决。

安全性和应用商店规则

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

  • 全球成功率达 82%，用于交付更新 [1]
  • 自动版本控制，改善组织
  • 遵守应用商店实时更新指南

为了安全地与 Crashlytics 进行集成：

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

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

插件选项

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

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

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

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

概要

以下是您完成的快速查看和下一步是什么：

Setup Steps Recap

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

  • 创建了一个 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?

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

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

从 Firebase Crashlytics 中继续为 Capacitor 应用程序

如果您正在使用 Firebase Crashlytics for Capacitor Apps 来规划原生插件工作，连接它 Capgo 插件目录 在 Capgo 插件目录中为产品工作流程 Capacitor 由 Capgo 提供的插件 在 Capacitor 由 Capgo 提供的插件中实现详细信息 添加或更新插件 在添加或更新插件中实现详细信息 Ionic Enterprise 插件替代品 在 Ionic Enterprise 插件替代品中实现产品工作流程 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 移动应用实时更新的安全最佳实践

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