示例工程移动开发【免费下载链接】flutter-examples[Examples] Simple basic isolated apps, for budding flutter devs.项目地址https://gitcode.com/gh_mirrors/fl/flutter-examples点击查看免费下载导读本篇文章基于 flutter-examples 仓库中的 firebase_crash_reporting 示例模块完整讲解如何在 Flutter 应用中集成 Firebase Crashlytics包括依赖与平台配置、应用启动时的 Firebase 初始化、通过runZonedGuarded捕获全局未处理异常并上报、以及如何在业务代码中写入自定义日志和主动触发崩溃验证链路。读完本文你将掌握一套可直接复制的 Crashlytics 接入范式并理解其中每个 API 在真实项目中的落地方式。一、模块定位一个最小可运行的崩溃上报示例该模块在仓库中的定位正如其 README 所述A Flutter module to demonstrate how to integrate Firebase crashlytics——一个专门演示 Firebase Crashlytics 集成方式的独立示例应用。它不像其他示例那样堆叠复杂业务而是刻意收敛到两条核心链路捕获并上报框架/异步产生的未捕获异常提供按钮主动记录日志、主动制造崩溃方便开发者在 Firebase 控制台验证上报是否成功。示例应用运行后的界面只有一个 AppBar标题 Crash App和两个按钮Custom Log写入自定义日志与 Crash the app强制崩溃全部实现集中在 lib/main.dart。这种极简设计非常适合作为接入 Crashlytics 的第一份参考代码。二、Getting Started项目是标准 Flutter 应用起点重点在 Firebase 依赖README 的 Getting Started 部分说明这是一个常规 Flutter 应用的起点工程同时点出三个学习入口方向Flutter 官方入门 Lab、常用示例 Cookbook以及 FlutterFireFirebase 官方 Dart 插件体系文档。换句话说接入 Firebase 本质上是在标准 Flutter 工程之上叠加 Firebase 插件而不是引入新的工程结构。与本模块主题强相关的第一步是依赖声明见 pubspec.yamlenvironment: sdk: 2.12.0 3.0.0 dependencies: flutter: sdk: flutter firebase_core: 0.5.0 firebase_crashlytics: ^0.2.1 cupertino_icons: ^1.0.0需要说明的是本仓库中的版本号firebase_core 0.5.0、firebase_crashlytics ^0.2.1属于 FlutterFire 早期的稳定版本与本仓库提交时代一致。当前新建项目请以 FlutterFire 发布的最新稳定版本为准但接入思路与 API 形态Firebase.initializeApp()、FirebaseCrashlytics.instance一脉相承本节示例仍具有直接的迁移参考价值。两个依赖的分工是firebase_core所有 Firebase 服务的公共底座负责Firebase.initializeApp()初始化firebase_crashlytics崩溃采集、上报与查询的本体。三、Android 侧平台配置两个 Gradle 插件 配置文件Firebase Crashlytics 在 Android 上依赖两个层面的配置本模块均已落地1. 根级构建脚本声明插件版本在 android/build.gradle 的buildscript.dependencies中声明classpath com.google.gms:google-services:4.3.3 classpath com.google.firebase:firebase-crashlytics-gradle:2.2.0其中google-services插件负责读取 Google 服务配置文件firebase-crashlytics-gradle插件负责在构建期生成 Crashlytics 所需的映射文件与上传元数据。2. 应用级构建脚本应用插件在 android/app/build.gradle 中除标准 Flutter 工程插件外额外应用apply plugin: com.android.application apply plugin: com.google.gms.google-services apply plugin: kotlin-android apply from: $flutterRoot/packages/flutter_tools/gradle/flutter.gradle ... apply plugin: com.google.firebase.crashlytics该文件还展示了与本功能相关的其他关键项minSdkVersion 16、targetSdkVersion 29、compileSdkVersion 29本仓库构建时的 SDK 基线multiDexEnabled true并引入com.android.support:multidex:1.0.3由于 Firebase Android SDK 体积较大启用 multidex 避免方法数超限android.enableR8true见 android/gradle.properties启用 R8 代码收缩。3. Firebase 配置文件仓库中已放置 android/app/google-services.json其关键内容与 AndroidManifest.xml 中的包名github.nisrulz.firebase_crash_reporting一一对应package_name字段。这是 Firebase 控制台为你的 Android 应用生成的专属文件包含project_id、mobilesdk_app_id、api_key等凭据实际项目必须替换为自己 Firebase 项目生成的文件并且该文件不应纳入版本库避免泄漏 API Key。从源码结构看Flutter 的 Android 侧插件注册由FlutterEngine自动完成Manifest 中的flutterEmbedding2元数据开发者无需手写 Java/Kotlin 注册代码FirebaseCrashlytics.instance在 Dart 侧即可直接使用。四、iOS 侧配置要点本模块的 ios/Podfile 采用 Flutter 标准模板platform :ios, 9.0 ... use_frameworks! use_modular_headers! flutter_install_all_ios_pods File.dirname(File.realpath(__FILE__))即 CocoaPods 会在flutter pub get之后自动把firebase_core、firebase_crashlytics等 Dart 插件对应的 iOS 原生 Pod 装入 Runner 工程。需要提醒的是iOS 侧还需要在 Xcode 中把 Firebase 控制台生成的GoogleService-Info.plist添加到 Runner 工程本仓库未包含该文件这与 Android 侧的google-services.json是同一配置动作的 iOS 版本。五、初始化与全局异常捕获读懂 main() 的骨架示例的核心逻辑集中在 lib/main.dart 的入口函数中它是 Crashlytics 接入的标准姿势main() { WidgetsFlutterBinding.ensureInitialized(); runZonedGuarded(() { runApp(App()); }, (error, stackTrace) { // Pass all uncaught errors from the framework to Crashlytics. FirebaseCrashlytics.instance.recordError(error, stackTrace); }); }逐行拆解其作用WidgetsFlutterBinding.ensureInitialized()确保在runApp之前完成 Flutter 引擎绑定初始化否则异步初始化 Firebase 可能报错runZonedGuarded为整个应用运行区域建立错误保护区凡是该区域内未被捕获的异常包括异步回调、Future 内部错误、Timer 回调等都会统一流入(error, stackTrace)回调FirebaseCrashlytics.instance.recordError(error, stackTrace)在回调中把错误与堆栈直接交给 Crashlytics 上报。这是本示例最有价值的实践Crashlytics 不仅能记录crash()制造的显式崩溃更能通过runZonedGuarded兜住 Dart 侧难以捕获的异步异常将框架级错误也纳入崩溃报表。随后App组件在build中通过FutureBuilder驱动 Firebase 初始化流程Futurevoid _initializeFirebase() async { await Firebase.initializeApp(); await FirebaseCrashlytics.instance.setCrashlyticsCollectionEnabled(true); }Firebase.initializeApp()使用默认配置初始化 Firebase 核心读取平台侧配置文件Android 的google-services.json/ iOS 的GoogleService-Info.plistsetCrashlyticsCollectionEnabled(true)显式开启崩溃采集。默认情况下 Crashlytics 自动采集但在某些场景如合规要求用户授权后可先关闭再按需开启本示例演示了明确开启的写法。FutureBuilder的三种界面状态也值得留意初始化出错时提示 Unable to initialise Firebase初始化中展示CircularProgressIndicator与 Initialising Firebase完成后才渲染CrashApp主界面。这保证崩溃上报能力在 UI 可用之前就已经就绪。六、业务侧两个关键动作自定义日志与主动崩溃主界面CrashApp提供了两个验证 Crashlytics 链路的按钮ElevatedButton( onPressed: () { //custom Crashlytics log message FirebaseCrashlytics.instance.log(Its a bug); }, child: Text(Custom Log)), const SizedBox(height: 10), ElevatedButton( child: Text(Crash the app), onPressed: () { FirebaseCrashlytics.instance.crash(); }, ),两个 API 的语义与用途FirebaseCrashlytics.instance.log(Its a bug)在崩溃事件中附加一条自定义日志。它不会触发崩溃而是作为上下文随崩溃报告一起上传——当用户反馈点这里就闪退时用log记录关键操作路径能极大加速问题定位FirebaseCrashlytics.instance.crash()立即抛出一个原生级崩溃由插件在底层触发用于在开发/联调阶段验证崩溃 → 采集 → 上传 → 控制台可见的完整链路。生产代码中不应出现该调用。从源码结构推断这两个按钮刻意与初始化逻辑分离App管初始化、CrashApp管触发正是为了让读者看清初始化阶段与业务上报阶段各自的职责边界。七、运行与验证把崩溃送到 Firebase 控制台要在本地跑通本示例并看到崩溃报告可按以下流程操作仓库为只读以下均为本地开发动作替换配置文件将你的 Firebase 项目生成的google-services.json放入 android/app 目录iOS 侧放入 Runner 工程并确保应用包名/Bundle ID 与 Firebase 控制台记录一致拉取依赖在模块目录执行flutter pub get运行应用flutter run等待初始化完成进入 Crash App 界面触发链路先点 Custom Log 写入一条日志再点 Crash the app 制造崩溃查看报告在 Firebase 控制台 → Crashlytics 面板中稍候应能看到本次崩溃事件及其附带的 Its a bug 自定义日志。首次崩溃上报通常需要一点时间且真机Release 构建行为与模拟器存在差异建议以 Release 模式验证。八、小结从本示例可迁移的接入清单综合 README 定位与源码实现本示例为 Flutter 开发者沉淀了一份可复用的 Crashlytics 接入清单环节做法仓库依据依赖添加firebase_core与firebase_crashlyticspubspec.yamlAndroid 构建应用google-services与firebase-crashlytics-gradle插件android/build.gradle、android/app/build.gradle平台凭据放置google-services.jsoniOS 为GoogleService-Info.plistandroid/app/google-services.json全局兜底runZonedGuardedrecordError捕获未处理异步异常lib/main.dart初始化Firebase.initializeApp()setCrashlyticsCollectionEnabled(true)lib/main.dart业务埋点log()记录上下文、crash()主动验证lib/main.dart接入 Crashlytics 的核心并不复杂平台配置决定能否连通初始化决定何时就绪而runZonedGuarded决定崩溃能否被完整兜住。本示例以最小成本同时演示了这三件事是理解 Flutter 崩溃监控闭环的绝佳起点。赞分享示例工程移动开发【免费下载链接】flutter-examples[Examples] Simple basic isolated apps, for budding flutter devs.项目地址https://gitcode.com/gh_mirrors/fl/flutter-examples点击查看免费下载相关推荐3分钟搞定Flutter崩溃监控Firebase Crashlytics无缝集成指南3分钟搞定Flutter崩溃监控Firebase Crashlytics无缝集成指南 你还在为Flutter应用崩溃束手无策用户反馈应用闪退却拿不到具体移动开发从SSM到线性注意力zebra_qwen3_7MLA21GDN_noT_SFT_1M_combined_fCE中Gated DeltaNet实现原理代码级解析从SSM到线性注意力zebra_qwen3_7MLA21GDN_noT_SFT_1M_combined_fCE中Gated DeltaNet实现原理代码级解析PocketHub Android App崩溃监控Firebase Crashlytics集成实践PocketHub Android App崩溃监控Firebase Crashlytics集成实践 作为Android开发者你是否还在为应用崩溃问题头疼用移动开发开发工具上一篇3个问题选对音频格式spotDL 下载不再白费下一篇数据分类体系实战指南用 GitHub Copilot 的>创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考