filterable_logger 是一个用于 Flutter 的日志过滤插件，它允许你根据日志级别、标签等条件来过滤和控制日志输出。这对于调试和开发过程中管理日志信息非常有用。以下是使用 filterable_logger 的基本步骤和示例。

1. 添加依赖

首先，你需要在 pubspec.yaml 文件中添加 filterable_logger 依赖：

dependencies:
  flutter:
    sdk: flutter
  filterable_logger: ^1.0.0  # 请使用最新版本

然后运行 flutter pub get 来获取依赖。

2. 初始化 Logger

在你的 Flutter 应用程序中初始化 filterable_logger。通常你可以在 main.dart 文件中进行初始化。

import 'package:filterable_logger/filterable_logger.dart';

void main() {
  // 初始化 Logger
  Logger.init(
    level: Level.ALL,  // 设置日志级别
    printer: PrettyPrinter(),  // 使用 PrettyPrinter 打印日志
  );

  runApp(MyApp());
}

3. 使用 Logger

在应用程序中使用 Logger 来记录日志。你可以使用不同的日志级别（如 verbose, debug, info, warning, error, wtf）来记录不同重要性的信息。

import 'package:filterable_logger/filterable_logger.dart';

class MyApp extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    Logger.v('Verbose log');  // 详细日志
    Logger.d('Debug log');    // 调试日志
    Logger.i('Info log');     // 信息日志
    Logger.w('Warning log');  // 警告日志
    Logger.e('Error log');    // 错误日志
    Logger.wtf('WTF log');    // 严重错误日志

    return MaterialApp(
      title: 'Flutter Demo',
      home: Scaffold(
        appBar: AppBar(
          title: Text('Flutter Demo'),
        ),
        body: Center(
          child: Text('Hello, World!'),
        ),
      ),
    );
  }
}

4. 过滤日志

filterable_logger 允许你根据日志级别、标签等条件来过滤日志。你可以通过设置 Logger.init 中的 filter 参数来实现过滤。

void main() {
  // 初始化 Logger 并设置过滤器
  Logger.init(
    level: Level.ALL,
    printer: PrettyPrinter(),
    filter: CustomFilter(),  // 使用自定义过滤器
  );

  runApp(MyApp());
}

// 自定义过滤器
class CustomFilter extends LogFilter {
  @override
  bool shouldLog(LogEvent event) {
    // 只记录级别为 error 或 wtf 的日志
    return event.level == Level.ERROR || event.level == Level.WTF;
  }
}

5. 使用标签过滤

你还可以为日志添加标签，并根据标签进行过滤。

void main() {
  Logger.init(
    level: Level.ALL,
    printer: PrettyPrinter(),
  );

  runApp(MyApp());
}

class MyApp extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    Logger.d('Debug log', tag: 'Network');  // 添加标签
    Logger.e('Error log', tag: 'Database'); // 添加标签

    return MaterialApp(
      title: 'Flutter Demo',
      home: Scaffold(
        appBar: AppBar(
          title: Text('Flutter Demo'),
        ),
        body: Center(
          child: Text('Hello, World!'),
        ),
      ),
    );
  }
}

然后你可以在过滤器中根据标签进行过滤：

class CustomFilter extends LogFilter {
  @override
  bool shouldLog(LogEvent event) {
    // 只记录标签为 'Network' 的日志
    return event.tag == 'Network';
  }
}

6. 自定义打印格式

你可以通过自定义 LogPrinter 来改变日志的打印格式。

class CustomPrinter extends LogPrinter {
  @override
  void log(LogEvent event) {
    final message = event.message;
    final level = event.level;
    final tag = event.tag ?? 'No Tag';

    // 自定义打印格式
    print('[$level] [$tag] $message');
  }
}

void main() {
  Logger.init(
    level: Level.ALL,
    printer: CustomPrinter(),  // 使用自定义打印器
  );

  runApp(MyApp());
}

7. 关闭 Logger

在某些情况下，你可能希望在生产环境中关闭日志记录。你可以通过设置日志级别为 Level.OFF 来实现。

void main() {
  Logger.init(
    level: Level.OFF,  // 关闭日志记录
    printer: PrettyPrinter(),
  );

  runApp(MyApp());
}