快速进入正文

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+ 和 安卓 studio 电击电鳐.
    • 下载 Firebase 配置文件 (GoogleService-Info.plist iOS google-services.json Android
    • 更新 iOS 和 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 开发
  • Capacitor 应用程序的最新版本 CocoaPods (iOS 必须)

平台配置文件

对于iOS:

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

获取

  • 文件 google-services.json 从 Firebase 控制台获取文件。
  • 同时修改项目级别和应用级别的文件。 build.gradle 文件。
  • 更新到包含所需权限的文件。 AndroidManifest.xml Firebase

Firebase 控制台设置 Firebase 平台控制台

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

创建 Firebase 项目并启用 Crashlytics。

  1. 注册您的应用 file from the Firebase Console.

  2. Make changes to both the project-level and app-level files. 在 Firebase 控制台中:

    • 使用 iOS 的 ID 和 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'
    }

    For iOS (Podfile):

    pod 'Firebase/Crashlytics'
    pod 'Firebase/Analytics'

完成以下步骤后,您可以进入插件安装部分。

安装步骤

插件安装

然后,同步插件与您的原生平台并查看 @capgo/capacitor-firebase-crashlytics Capacitor 插件页面,完整的API参考:

npm install @capgo/capacitor-firebase-crashlytics && npx cap sync

@code app.component.ts or main.ts:

import { FirebaseCrashlytics } from '@capgo/capacitor-firebase-crashlytics';
await FirebaseCrashlytics.initialize();

或

平台配置

设置 Android 和 iOS 平台所需的配置项

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

    buildscript { 
        dependencies { 
            classpath 'com.google.firebase:firebase-crashlytics-gradle:2.9.5' 
        } 
    }
    apply plugin: 'com.google.firebase.crashlytics'
  2. 在 iOS 设定中启用崩溃收集 AndroidManifest.xml:

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

配置 Firebase

  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'});
  • 包括堆栈跟踪、设备详细信息和自定义键的报告,应该在大约 5 分钟内出现在 Firebase 控制台。

    await FirebaseCrashlytics.log({message: 'Test crash triggered'});

重要:

file 在发布应用之前,移除崩溃调用。要在开发期间禁用崩溃收集,请使用:

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

监控指南

一旦你确认了设置并通过测试崩溃,使用 Firebase 控制台来跟踪实际崩溃和错误在您的在线应用中:

阅读崩溃报告

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

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

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

专业提示:

Error Management Tips

  • Prioritize by Impact:

  • Use Custom Keys: Add context to your crash reports with custom keys. For example:

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

Protecting User Privacy

To ensure compliance and safeguard user data, follow these guidelines:

  • : :

    • 请在隐私政策中提及崩溃报告。
    • 在遵守GDPR法规的地区获取用户同意以收集数据。
    • 向用户提供崩溃报告的选项。
  • 数据收集控制:

    await FirebaseCrashlytics.setCrashlyticsCollectionEnabled({enabled: false});
    await FirebaseCrashlytics.setCrashlyticsCollectionEnabled({enabled: true});
  • 数据保留:

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

Capgo 集成

Capgo Live Update 控制台界面

通过将Capgo的live update系统与Crashlytics配对来简化从崩溃检测到修复部署的流程。

关于Capgo

Capgo是一款live update工具,专门为Capgo应用设计 Capacitor应用。通过超过1900个应用的生产和24小时内95%的更新率,它确保了快速修复而无需等待应用商店审批 [1].

关键功能包括:

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

Crashlytics与Capgo集成

Using Crashlytics with Capgo creates an efficient workflow for identifying and resolving issues quickly.

以下是如何实现的:

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

  2. 目标更新

    • 测试测试修复程序以确保它们有效。
    • 阶段性发布逐步发布更新以减少风险。
    • 紧急修复:快速推送关键补丁以解决紧急问题。
  3. 监控和验证
    在部署了Capgo更新后,使用Crashlytics来追踪崩溃率并确认问题已经解决。

安全性和应用商店规则

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

  • 全球成功率82% [1]
  • 自动版本控制以更好地组织
  • 遵守应用商店live update 指南

为与 Crashlytics 安全集成:

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

继续到插件选项部分,探索其他live update工具。

插件选项

选择合适的崩溃报告插件对识别和修复应用程序错误至关重要。

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

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

Crashlytics 对于已经使用 Firebase 的团队来说尤其有吸引力,因为它的整合非常Smooth,并且有免费的层次。

概要

快速回顾一下您已经完成了什么以及接下来要做什么:

设置步骤回顾

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

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

context

Pairing Firebase Crashlytics with Capgo gives you a powerful system for error tracking and crash reporting. 为什么要整合这些工具?将 Firebase Crashlytics 与 __CAPGO_KEEP_0__ 配对起来,可以为您提供一个强大的错误跟踪和更新管理系统。

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

接下来是什么?

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

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

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

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

Capacitor 应用程序的实时更新

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

最新博客文章

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