Flutter日志管理插件flutter_mxlogger的使用

MXLogger 是一个基于mmap内存映射机制的跨平台日志库，支持AES CFB 128位加密，适用于iOS、Android和Flutter。其核心代码使用C/C++实现，并通过Flutter的ffi调用，确保性能几乎与原生一致。底层序列化使用Google开源的flat_buffers实现，保证了高效性和稳定性。

更多关于MXLogger的详细信息，请访问GitHub。

快速开始

首先，在你的Flutter项目中添加flutter_mxlogger依赖：

dependencies:
  flutter_mxlogger: ^latest_version

然后，初始化并配置MXLogger实例：

import 'package:flutter_mxlogger/flutter_mxlogger.dart';

void main() async {
  WidgetsFlutterBinding.ensureInitialized();

  MXLogger logger = await MXLogger.initialize(
      nameSpace: "flutter.mxlogger",
      storagePolicy: "yyyy_MM_dd_HH", // 按小时存储日志
      cryptKey: "abcuioqbsdguijlk", // 加密密钥
      iv: "bccuioqbsdguijiv"); // 初始化向量

  // 设置最大磁盘日志保存时间（一周）
  logger.setMaxDiskAge(60 * 60 * 24 * 7);
  // 设置最大磁盘日志大小（10MB）
  logger.setMaxDiskSize(1024 * 1024 * 10);
  // 设置文件级别为调试级
  logger.setFileLevel(0);

  // 记录不同级别的日志
  logger.debug("this is debug message", name: "mxlogger", tag: "net,response");
  logger.info("this is info message", name: "mxlogger", tag: "tag1,tag2,tag3");
  logger.warn("this is warn message", name: "mxlogger", tag: "tag1,tag2,tag3");
  logger.error("this is error message", name: "mxlogger", tag: "tag1,tag2,tag3");
  logger.fatal("this is fatal message", name: "mxlogger", tag: "tag1,tag2,tag3");

  runApp(MyApp());
}

解析日志文件

MXLogger生成的日志文件是二进制格式的，可以使用专门的解析器进行查看。你可以下载mxlogger_analyzer来解析这些日志文件。更多关于解析器的信息，请参阅GitHub上的说明。

示例Demo

以下是一个完整的示例应用，展示了如何在Flutter应用中集成和使用MXLogger：

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

final navkey = GlobalKey<NavigatorState>();

void main() async {
  WidgetsFlutterBinding.ensureInitialized();

  runApp(const MyApp());
}

class MyApp extends StatefulWidget {
  const MyApp({Key? key}) : super(key: key);

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

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

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      navigatorKey: navkey,
      home: Builder(builder: (context) {
        return Scaffold(
          appBar: AppBar(
            title: const Text('Plugin example app'),
          ),
          body: Center(
              child: Column(
                children: [
                  ElevatedButton(
                    onPressed: () {
                      Navigator.of(context).push(MaterialPageRoute(builder: (context) {
                        return LogPage();
                      }));
                    },
                    child: Text("进入日志页面"),
                  ),
                ],
              )),
        );
      }),
    );
  }
}