Flutter日志管理插件flutter_easy_log的使用

flutter_easy_log

一个非常易于使用的Flutter日志库。它高度受Android默认日志API的启发。

开始使用

以下是一个完整的使用示例：

Log.d('我的调试日志'); // 调试日志
Log.e('我的错误日志'); // 错误日志
Log.i('我的信息日志'); // 信息日志
Log.v('我的详细日志'); // 详细日志
Log.w('我的警告日志'); // 警告日志
Log.wtf('我的糟糕失败日志'); // 极端糟糕的日志

你可以通过标签更好地识别你的日志：

Log.i(tag: '第一个按钮', '按钮被点击了!');

当然，你也可以记录任何你想记录的信息：

Log.e(tag: '按钮点击', Exception('我的异常!'));

就这么简单。

配置

配置会影响插件全局设置，因此可以在应用的main()函数中添加这些配置。

仅在调试模式下显示日志

默认情况下，此设置为启用状态，但可以通过以下全局参数禁用：

Log.debugOnly = false;

在日志中显示日期

默认情况下，此设置为禁用状态，但可以通过以下全局参数启用：

Log.showDate = true;

完整示例代码

以下是完整的示例代码：

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

void main() {
  WidgetsFlutterBinding.ensureInitialized();

  // Easy Log 配置
  Log.debugOnly = true; // 默认为true
  Log.showDate = true; // 默认为false

  // 可选，捕获应用的所有异常并记录
  FlutterError.onError = (errorDetails) {
    Log.e(errorDetails.exception);
  };

  runApp(const MyApp());
}

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

  [@override](/user/override)
  State<MyApp> createState() => _MyAppState();
}

class _MyAppState extends State<MyApp> {
  [@override](/user/override)
  void initState() {
    super.initState();

    // 初始化时打印一些日志
    Log.d('我的调试日志');
    Log.e('我的错误日志');
    Log.i('我的信息日志');
    Log.v('我的详细日志');
    Log.w('我的警告日志');
    Log.wtf('我的糟糕失败日志');
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: const Text('Easy Log 示例应用'),
        ),
        body: ListView(
          padding: const EdgeInsets.all(20),
          children: [
            ElevatedButton(
              onPressed: () {
                // 点击按钮时打印带有标签的日志
                Log.i(tag: '第一个按钮', '按钮被点击了!');
              },
              child: const Text('点击我'),
            ),
            const SizedBox(height: 16),
            ElevatedButton(
              onPressed: () {
                // 抛出异常并记录
                throw Exception('我的异常');
              },
              child: const Text('抛出异常'),
            ),
          ],
        ),
      ),
    );
  }
}