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 {
Zone.current.ption, 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 {
Zone.current.ption, 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 {
if (isInDebugMode) {
FlutterError.dumpErrorToConsole(details);
} else {
Zone.current.ption, 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 模式下,将错误信息收集起来,上传到服务器。
flutter开发app参考链接:
总结
以上就是这篇⽂章的全部内容了,希望本⽂的内容对⼤家的学习或者⼯作具有⼀定的参考学习价值,谢谢⼤家对的⽀持。
版权声明:本站内容均来自互联网,仅供演示用,请勿用于商业和其他非法用途。如果侵犯了您的权益请与我们联系QQ:729038198,我们将在24小时内删除。
发表评论