Flutter错误堆栈追踪插件error_stack的使用

Error Stack for Flutter

Simple to use

Flutter App

要在Flutter项目中添加Error Stack，你需要在main.dart文件中导入并初始化它：

// Add Error Stack to your main.dart file
import 'package:error_stack/error_stack.dart';

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  await ErrorStack.init(); // Initialize Error Stack
  runApp(MyApp());
}

一旦你添加了Error Stack到你的应用程序中，它将覆盖默认的错误处理。

Nylo

如果你使用的是Nylo框架，可以在你的AppProvider类中启用Error Stack：

// Add Error Stack to your Nylo app provider
import 'package:error_stack/error_stack.dart';

class AppProvider {

  @override
  boot(Nylo nylo) async {
    ...
    nylo.useErrorStack(); // enables Error Stack
  }
}

Features

• ✅ Instant Google search to resolve error
• ✅ Copy error message to clipboard
• ✅ Modern UI for debug and release mode
• ✅ Light and Dark mode support
• ✅ Customizable Production Error Page

Getting started

Installation

将以下内容添加到你的pubspec.yaml文件中：

dependencies:
  error_stack: ^1.10.1

或者使用Dart命令行工具：

dart pub add error_stack

How to use

这个包非常容易使用。你可以设置日志级别（Log Level），并在初始化时传递参数来自定义它的行为。

Log Levels

• ErrorStackLogLevel.verbose (default)
• ErrorStackLogLevel.minimal (shows less information)

Flutter App

import 'package:flutter/material.dart';
import 'package:error_stack/error_stack.dart';

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  await ErrorStack.init(logLevel: ErrorStackLogLevel.minimal); // Initialize Error Stack with minimal log level
  runApp(MyApp());
}

Nylo

import 'package:error_stack/error_stack.dart';

class AppProvider {
    
  @override
  boot(Nylo nylo) async {
     ...
     nylo.useErrorStack(logLevel: ErrorStackLogLevel.minimal);
  }
}

Full Parameters

你可以在初始化Error Stack时设置更多参数：

ErrorStack.init(
	level: ErrorStackLogLevel.verbose,  // The ErrorStackLogLevel.verbose | ErrorStackLogLevel.minimal
	initialRoute: "/", // Navigate to this route when tapping "Restart app"
	errorWidget: (errorDetails) { // The error widget you want to show in release mode
    	return Scaffold(
      	    appBar: AppBar(
        	    title: Text("Error"),
      	    ),
      	    body: Center(
        	    child: Text("An error occurred"),
      	    ),
    	);
	}
);

尝试示例应用程序以查看它是如何工作的。

示例代码

以下是完整的示例代码，展示了如何在Flutter应用中使用error_stack插件：

import 'package:flutter/material.dart';
import 'package:error_stack/error_stack.dart';

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  await ErrorStack.init(
    initialRoute: "/",
    level: ErrorStackLogLevel.verbose,
  );
  runApp(MyApp());
}

class MyApp extends StatelessWidget {
  const MyApp({super.key});

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'ErrorStack',
      debugShowCheckedModeBanner: false,
      theme: ThemeData(
        primarySwatch: Colors.blue,
      ),
      home: MyHomePage(title: 'Home Page'),
    );
  }
}

class MyHomePage extends StatefulWidget {
  const MyHomePage({super.key, required this.title});

  final String title;

  @override
  createState() => _MyHomePageState();
}

class _MyHomePageState extends State<MyHomePage> {
  dynamic data = [];

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text(widget.title),
      ),
      body: Center(
        child: Text(data.toString()),
      ),
    );
  }
}

希望这些信息能帮助你在Flutter项目中有效地使用error_stack插件！如果有任何问题或需要进一步的帮助，请随时提问。