Flutter里面错误捕获的正确方法
背景
我们知道，在软件开发过程中，错误和异常总是在所难免。
不管是客户端的逻辑错误导致的，还是服务器的数据问题导致的，只要出现了异常，我们都需要一个机制来通知我们去处理。
在 APP 的开发过程中，我们通过一些第三方的平台，比如 Fabric、Bugly 等可以实现异常的日志上报。
Flutter 也有一些第三方的平台，比如 Sentry 可以实现异常的日志上报。
但是为了更加通用一些，本篇不具体讲解配合某个第三方平台的异常日志捕获，我们会告知大家如何在 Flutter 里面捕获异常。
至于具体的上报途径，不管是上报到自家的后台服务器，还是通过第三方的 SDK API 接口进行异常上报，都是可以的。
Demo 初始状态
首先我们新建 Flutter 项目，修改 main.dart 代码如下：
import 'package:flutter/material.dart';
void main() => runApp(MyApp());
class MyApp extends StatelessWidget {
// This widget is the root of your application.
@override
Widget build(BuildContext context) {
return MaterialApp(
home: Scaffold(
appBar: AppBar(title: Text('Flutter Crash Capture'),),
body: MyHomePage(),
),
);
}
}
class MyHomePage extends StatelessWidget {
@override
Widget build(BuildContext context) {
return Container();
}
}
效果如下：
捕获错误
我们修改 MyHomePage，添加一个 List 然后进行越界访问，改动部分代码如下：
class MyHomePage extends StatelessWidget {
@override
Widget build(BuildContext context) {
List<String> numList = ['1', '2'];
print(numList[6]);
return Container();
}
}
可以看到控制台报错如下：
flutter: ══╡ EXCEPTION CAUGHT BY WIDGETS LIBRARY ╞═══════════════════════════════════════════════════════════
flutter: The following RangeError was thrown building MyHomePage(dirty):
flutter: RangeError (index): Invalid value: Not in range 0..1, inclusive: 6
当然这些错误信息在界面上也有显示（debug 模式）。
那么我们如何捕获呢？
其实很简单，有个通用模板，模板为：
import 'dart:async';
import 'package:flutter/material.dart';
Future<Null> main() async {
FlutterError.onError = (FlutterErrorDetails details) async {
Zone.current.handleUncaughtError(details.exception, details.stack);
};
runZoned<Future<void>>(() async {
runApp(MyApp());
}, onError: (error, stackTrace) async {
await _reportError(error, stackTrace);
});
}
Future<Null> _reportError(dynamic error, dynamic stackTrace) async {
// TODO
}
在 TODO 里面就可以执行埋点上报操作或者其他处理了。
完整例子如下：
import 'dart:async';
import 'package:flutter/material.dart';
Future<Null> main() async {
FlutterError.onError = (FlutterErrorDetails details) async {
Zone.current.handleUncaughtError(details.exception, details.stack);
};
runZoned<Future<void>>(() async {
runApp(MyApp());
}, onError: (error, stackTrace) async {
await _reportError(error, stackTrace);
});
}
Future<Null> _reportError(dynamic error, dynamic stackTrace) async {
print('catch error='+error);
}
class MyApp extends StatelessWidget {
// This widget is the root of your application.
@override
Widget build(BuildContext context) {
return MaterialApp(
home: Scaffold(
appBar: AppBar(title: Text('Flutter Crash Capture'),),
body: MyHomePage(),
),
);
}
}
class MyHomePage extends StatelessWidget {
@override
Widget build(BuildContext context) {
List<String> numList = ['1', '2'];
print(numList[6]);
return Container();
}
}
运行可以看到控制台捕获到错误如下：
flutter: catch error=RangeError (index): Invalid value: Not in range 0..1, inclusive: 6
assert 妙用
我们知道，一般错误上报都是在打包发布到市场后才需要。
平时调试的时候如果遇到错误，我们是会定位问题并修复的。
因此在 debug 模式下，我们不希望上报错误，而是希望直接打印到控制台。
那么，这个时候就需要一种方式来区分现在是 debug 模式还是 release 模式，怎么区分呢？
这个时候就需要用到 assert 了。
bool get isInDebugMode {
// Assume you're in production mode.
bool inDebugMode = false;
// Assert expressions are only evaluated during development. They are ignored
// in production. Therefore, this code only sets `inDebugMode` to true
// in a development environment.
assert(inDebugMode = true);
return inDebugMode;
}
从注释也可以知道，assert 表达式只在开发环境下会起作用，在生产环境下会被忽略。
因此利用这一个，我们就可以实现我们的需求。
上面的结论要验证也很简单，我们就不演示了。
完整模板
import 'dart:async';
import 'package:flutter/material.dart';
Future<Null> main() async {
FlutterError.onError = (FlutterErrorDetails details) async {
if (isInDebugMode) {
FlutterError.dumpErrorToConsole(details);
} else {
Zone.current.handleUncaughtError(details.exception, details.stack);
}
};
runZoned<Future<void>>(() async {
runApp(MyApp());
}, onError: (error, stackTrace) async {
await _reportError(error, stackTrace);
});
}
Future<Null> _reportError(dynamic error, dynamic stackTrace) async {
// TODO
}
bool get isInDebugMode {
// Assume you're in production mode.
bool inDebugMode = false;
// Assert expressions are only evaluated during development. They are ignored
// in production. Therefore, this code only sets `inDebugMode` to true
// in a development environment.
assert(inDebugMode = true);
return inDebugMode;
}
debug 模式下，直接将错误打印到控制台，方便定位问题。
release 模式下，将错误信息收集起来，上传到服务器。
参考链接：
总结
以上就是这篇文章的全部内容了，希望本文的内容对大家的学习或者工作具有一定的参考学习价值，谢谢大家对脚本之家的支持。
相关文章
本篇文章是对关于android创建快捷方式会启动两个应用的问题进行了详细的分析介绍，需要的朋友参考下2013-06-06
这篇文章主要为大家详细介绍了Android自定义StepView仿外卖配送进度，具有一定的参考价值，感兴趣的小伙伴们可以参考一下2018-05-05
这篇文章主要给大家介绍了关于Android中AOP（面向切向编程）的相关资料，文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值，需要的朋友们下面随着小编来一起学习学习吧2018-09-09
Flutter Widget开发Shortcuts快捷键实例
这篇文章主要为大家介绍了Flutter Widget开发Shortcuts快捷键实例，有需要的朋友可以借鉴参考下，希望能够有所帮助，祝大家多多进步，早日升职加薪2022-12-12
这篇文章主要为大家详细介绍了Android获取网络图片并显示的方法，具有一定的参考价值，感兴趣的小伙伴们可以参考一下2018-11-11
这篇文章主要为大家介绍了Android原生集成RN最新版教程，有需要的朋友可以借鉴参考下，希望能够有所帮助，祝大家多多进步，早日升职加薪2022-12-12
这篇文章主要介绍了Android仿微信底部菜单栏和顶部菜单栏实现效果，文中示例代码介绍的非常详细，具有一定的参考价值，感兴趣的小伙伴们可以参考一下2015-12-12
Room是一个数据库访问组件； 对SqLite数据库做了友好的封装，使我们在编码的时候，只需要注重逻辑的部分即可，数据库就交给Room去流畅的访问即可2022-08-08
这篇文章主要介绍了Android jni调试打印char阵列的实例详解的相关资料,通过此文希望能帮助到大家实现这样的功能，需要的朋友可以参考下2017-08-08
这篇文章主要介绍了Flutter实现Android滚动悬浮效果，文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值，需要的朋友们下面随着小编来一起学习吧2023-01-01
最新评论