Flutter日志记录插件simple_file_log的使用

simple_file_log 是一个用于在 Flutter 应用中记录日志并将其保存到文件中的工具。它可以帮助开发者轻松地管理应用的日志信息，并在需要时查看详细的日志记录。

使用步骤

以下是使用 simple_file_log 插件的基本步骤：

1. 添加依赖

首先，在 pubspec.yaml 文件中添加 simple_file_log 依赖：

dependencies:
  simple_file_log: ^版本号

然后运行以下命令以安装依赖：

flutter pub get

2. 初始化日志记录器

在应用启动时初始化日志记录器。可以通过设置 debug 参数来启用调试模式，并指定日志保留的天数。

3. 记录日志

使用日志记录器记录不同级别的日志信息，例如 info、fine、severe 等。

完整示例

以下是一个完整的示例代码，展示了如何使用 simple_file_log 插件记录日志。

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

void main() async {
  // 初始化日志记录器，设置为调试模式，日志保留 2 天
  (await MyLogDart.log.init(debug: true, days: 2)).info('app start...');

  // 创建自定义类实例
  final myClassA = MyClassA();
  myClassA.testLog();

  // 关闭日志记录器
  MyLogDart.log.dispose();

  // 再次调用日志方法，此时不会记录日志
  myClassA.testLog();

  // 重新初始化日志记录器，设置为调试模式
  (await MyLogDart.log.init(debug: true)).info('app start2...');

  // 调用日志方法
  myClassA.testLog();

  // 测试错误日志记录
  myClassA.testErr();
}

// 自定义类，实现 LogUtil 接口
class MyClassA with LogUtil {
  // 记录普通日志
  void testLog() {
    logger.fine('testLog');
  }

  // 记录错误日志
  void testErr() {
    try {
      final test = '';
      test.substring(5); // 故意引发异常
    } catch (e, s) {
      logger.severe('test err', e, s);
    }
  }
}

代码说明

1. 初始化日志记录器：

   (await MyLogDart.log.init(debug: true, days: 2)).info('app start...');
   

   这里通过 MyLogDart.log.init 方法初始化日志记录器，并设置为调试模式，日志保留 2 天。

2. 记录日志：

   logger.fine('testLog');
   

   使用 logger.fine 记录细粒度的日志信息。

3. 记录错误日志：

   logger.severe('test err', e, s);
   

   使用 logger.severe 记录错误信息，包括异常对象 e 和堆栈跟踪 s。

4. 关闭日志记录器：

   MyLogDart.log.dispose();