Flutter里面錯(cuò)誤捕獲的正確方法

更新時(shí)間：2019年10月15日 08:32:11 作者：安卓小煜

這篇文章主要給大家介紹了關(guān)于Flutter里面錯(cuò)誤捕獲的正確方法，文中通過(guò)示例代碼介紹的非常詳細(xì)，對(duì)大家學(xué)習(xí)或者使用Flutter具有一定的參考學(xué)習(xí)價(jià)值，需要的朋友們下面來(lái)一起學(xué)習(xí)學(xué)習(xí)吧

背景

我們知道，在軟件開(kāi)發(fā)過(guò)程中，錯(cuò)誤和異?？偸窃谒y免。

不管是客戶(hù)端的邏輯錯(cuò)誤導(dǎo)致的，還是服務(wù)器的數(shù)據(jù)問(wèn)題導(dǎo)致的，只要出現(xiàn)了異常，我們都需要一個(gè)機(jī)制來(lái)通知我們?nèi)ヌ幚怼?/p>

在 APP 的開(kāi)發(fā)過(guò)程中，我們通過(guò)一些第三方的平臺(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ù)器，還是通過(guò)第三方的 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)行越界訪問(wè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í)很簡(jiǎn)單，有個(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ā)布到市場(chǎng)后才需要。

平時(shí)調(diào)試的時(shí)候如果遇到錯(cuò)誤，我們是會(huì)定位問(wèn)題并修復(fù)的。

因此在 debug 模式下，我們不希望上報(bào)錯(cuò)誤，而是希望直接打印到控制臺(tái)。

那么，這個(gè)時(shí)候就需要一種方式來(lái)區(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á)式只在開(kāi)發(fā)環(huán)境下會(huì)起作用，在生產(chǎn)環(huán)境下會(huì)被忽略。

因此利用這一個(gè)，我們就可以實(shí)現(xiàn)我們的需求。

上面的結(jié)論要驗(yàn)證也很簡(jiǎ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)，方便定位問(wèn)題。

release 模式下，將錯(cuò)誤信息收集起來(lái)，上傳到服務(wù)器。

參考鏈接：

Report errors to a service

總結(jié)

以上就是這篇文章的全部?jī)?nèi)容了，希望本文的內(nèi)容對(duì)大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價(jià)值，謝謝大家對(duì)腳本之家的支持。

您可能感興趣的文章: