Flutter里面錯(cuò)誤捕獲的正確方法
背景
我們知道,在軟件開發(fā)過程中,錯(cuò)誤和異??偸窃谒y免。
不管是客戶端的邏輯錯(cuò)誤導(dǎo)致的,還是服務(wù)器的數(shù)據(jù)問題導(dǎo)致的,只要出現(xiàn)了異常,我們都需要一個(gè)機(jī)制來通知我們?nèi)ヌ幚怼?/p>
在 APP 的開發(fā)過程中,我們通過一些第三方的平臺(tái),比如 Fabric、Bugly 等可以實(shí)現(xiàn)異常的日志上報(bào)。
Flutter 也有一些第三方的平臺(tái),比如 Sentry 可以實(shí)現(xiàn)異常的日志上報(bào)。
但是為了更加通用一些,本篇不具體講解配合某個(gè)第三方平臺(tái)的異常日志捕獲,我們會(huì)告知大家如何在 Flutter 里面捕獲異常。
至于具體的上報(bào)途徑,不管是上報(bào)到自家的后臺(tái)服務(wù)器,還是通過第三方的 SDK API 接口進(jìn)行異常上報(bào),都是可以的。
Demo 初始狀態(tài)
首先我們新建 Flutter 項(xiàng)目,修改 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(); } }
效果如下:
捕獲錯(cuò)誤
我們修改 MyHomePage,添加一個(gè) List 然后進(jìn)行越界訪問,改動(dòng)部分代碼如下:
class MyHomePage extends StatelessWidget { @override Widget build(BuildContext context) { List<String> numList = ['1', '2']; print(numList[6]); return Container(); } }
可以看到控制臺(tái)報(bào)錯(cuò)如下:
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
當(dāng)然這些錯(cuò)誤信息在界面上也有顯示(debug 模式)。
那么我們?nèi)绾尾东@呢?
其實(shí)很簡單,有個(gè)通用模板,模板為:
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 里面就可以執(zhí)行埋點(diǎn)上報(bào)操作或者其他處理了。
完整例子如下:
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(); } }
運(yùn)行可以看到控制臺(tái)捕獲到錯(cuò)誤如下:
flutter: catch error=RangeError (index): Invalid value: Not in range 0..1, inclusive: 6
assert 妙用
我們知道,一般錯(cuò)誤上報(bào)都是在打包發(fā)布到市場后才需要。
平時(shí)調(diào)試的時(shí)候如果遇到錯(cuò)誤,我們是會(huì)定位問題并修復(fù)的。
因此在 debug 模式下,我們不希望上報(bào)錯(cuò)誤,而是希望直接打印到控制臺(tái)。
那么,這個(gè)時(shí)候就需要一種方式來區(qū)分現(xiàn)在是 debug 模式還是 release 模式,怎么區(qū)分呢?
這個(gè)時(shí)候就需要用到 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 表達(dá)式只在開發(fā)環(huán)境下會(huì)起作用,在生產(chǎn)環(huán)境下會(huì)被忽略。
因此利用這一個(gè),我們就可以實(shí)現(xiàn)我們的需求。
上面的結(jié)論要驗(yàn)證也很簡單,我們就不演示了。
完整模板
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 模式下,直接將錯(cuò)誤打印到控制臺(tái),方便定位問題。
release 模式下,將錯(cuò)誤信息收集起來,上傳到服務(wù)器。
參考鏈接:
總結(jié)
以上就是這篇文章的全部內(nèi)容了,希望本文的內(nèi)容對(duì)大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價(jià)值,謝謝大家對(duì)腳本之家的支持。
相關(guān)文章
Android實(shí)現(xiàn)幾種推送方式解決方案
推送功能在手機(jī)開發(fā)中應(yīng)用的場景是越來起來了,本篇文章主要介紹了Android實(shí)現(xiàn)幾種推送方式解決方案 ,具有一定的參考價(jià)值,有興趣的可以了解一下。2016-12-12Android開發(fā)手冊(cè)TextInputLayout樣式使用示例
這篇文章主要為大家介紹了Android開發(fā)手冊(cè)TextInputLayout樣式使用示例,有需要的朋友可以借鑒參考下,希望能夠有所幫助,祝大家多多進(jìn)步,早日升職加薪2022-06-06Android-Service實(shí)現(xiàn)手機(jī)壁紙自動(dòng)更換
這篇文章主要為大家詳細(xì)介紹了Android-Service實(shí)現(xiàn)手機(jī)壁紙自動(dòng)更換,具有一定的參考價(jià)值,感興趣的小伙伴們可以參考一下2018-11-11解決Android Studio導(dǎo)入項(xiàng)目非常慢的辦法
在使用Android studio的時(shí)候常常遇到這樣的問題,從其他地方導(dǎo)入項(xiàng)目,Android studio呈現(xiàn)非常慢的現(xiàn)象!當(dāng)遇到這種情況時(shí),可以看看是下面這篇文章,再按照方法來解決!2016-09-09Android Studio自動(dòng)排版的兩種實(shí)現(xiàn)方式
這篇文章主要介紹了Android Studio自動(dòng)排版的兩種實(shí)現(xiàn)方式,具有很好的參考價(jià)值,希望對(duì)大家有所幫助。一起跟隨小編過來看看吧2020-03-03Android Handler的postDelayed()關(guān)閉的方法及遇到問題
這篇文章主要介紹了Android Handler的postDelayed()關(guān)閉的方法,本文給大家介紹的非常詳細(xì),對(duì)大家的學(xué)習(xí)或工作具有一定的參考借鑒價(jià)值,需要的朋友可以參考下2021-04-048種android 對(duì)話框(Dialog)使用方法詳解
這篇文章主要介紹了8種android 對(duì)話框(Dialog)使用方法。感興趣的朋友可以參考一下2016-03-03