sane_flog 是一个用于 Flutter 应用的日志管理插件，它提供了一种简单且灵活的方式来记录和管理应用程序中的日志。以下是如何在 Flutter 项目中使用 sane_flog 的基本步骤和示例。

1. 添加依赖

首先，在你的 pubspec.yaml 文件中添加 sane_flog 依赖：

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

然后运行 flutter pub get 来安装依赖。

2. 初始化日志

在你的 Flutter 应用中初始化 sane_flog。通常在主文件（如 main.dart）中进行初始化：

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

void main() {
  // 初始化日志
  SaneFlog.initialize(
    logLevel: LogLevel.verbose,  // 设置日志级别
    loggers: [
      ConsoleLogger(),  // 输出日志到控制台
      FileLogger(),     // 输出日志到文件
    ],
  );

  runApp(MyApp());
}

3. 使用日志

在你的应用程序中使用 SaneFlog 来记录日志。sane_flog 提供了不同级别的日志记录方法：

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

class MyApp extends StatelessWidget {
  [@override](/user/override)
  Widget build(BuildContext context) {
    // 记录不同级别的日志
    SaneFlog.v('Verbose log');  // 详细日志
    SaneFlog.d('Debug log');    // 调试日志
    SaneFlog.i('Info log');     // 信息日志
    SaneFlog.w('Warning log');  // 警告日志
    SaneFlog.e('Error log');    // 错误日志
    SaneFlog.wtf('WTF log');    // 严重错误日志

    return MaterialApp(
      title: 'Flutter Demo',
      theme: ThemeData(
        primarySwatch: Colors.blue,
      ),
      home: MyHomePage(),
    );
  }
}

class MyHomePage extends StatelessWidget {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text('Sane Flog Demo'),
      ),
      body: Center(
        child: Text('Check the logs!'),
      ),
    );
  }
}

4. 配置日志级别

在初始化时，你可以通过 logLevel 参数来设置日志级别。只有等于或高于该级别的日志才会被记录。例如，如果你设置 LogLevel.warning，那么只有警告、错误和严重错误日志会被记录。

5. 自定义日志记录器

sane_flog 允许你自定义日志记录器。你可以通过实现 Logger 接口来创建自己的日志记录器，并在初始化时将其添加到 loggers 列表中。

class CustomLogger implements Logger {
  [@override](/user/override)
  void log(LogLevel level, String message, {String? tag}) {
    // 自定义日志处理逻辑
    print('[$level] $tag: $message');
  }
}

void main() {
  SaneFlog.initialize(
    logLevel: LogLevel.debug,
    loggers: [
      ConsoleLogger(),
      CustomLogger(),  // 使用自定义日志记录器
    ],
  );

  runApp(MyApp());
}

6. 日志输出到文件

sane_flog 提供了 FileLogger，可以将日志输出到文件中。你可以通过配置 FileLogger 来指定日志文件的路径和名称。

void main() {
  SaneFlog.initialize(
    logLevel: LogLevel.debug,
    loggers: [
      ConsoleLogger(),
      FileLogger(
        filePath: '/path/to/logfile.log',  // 指定日志文件路径
      ),
    ],
  );

  runApp(MyApp());
}

7. 日志格式化

sane_flog 还支持自定义日志格式。你可以通过实现 LogFormatter 接口来定义自己的日志格式，并在初始化时将其传递给日志记录器。

class CustomLogFormatter implements LogFormatter {
  [@override](/user/override)
  String format(LogLevel level, String message, {String? tag}) {
    return '[$level] $tag: $message';
  }
}

void main() {
  SaneFlog.initialize(
    logLevel: LogLevel.debug,
    loggers: [
      ConsoleLogger(
        formatter: CustomLogFormatter(),  // 使用自定义日志格式化器
      ),
    ],
  );

  runApp(MyApp());
}