Logman

一个简单而强大的 Flutter 应用日志包,集成了 UI 和可选的调试页面。

特点

  • 易于使用的日志记录,采用单例模式。
  • 支持多种日志类型:简单日志、导航日志和网络日志。
  • 可自定义的浮动 UI 叠加层,用于在开发中显示日志。
  • 可选的调试页面,用于详细的日志分析。
  • 用于网络日志的 Dio 拦截器。
  • 用于跟踪导航事件的 Navigator observer。

截图

安装

  1. 将 Logman 添加到您的 pubspec.yaml 文件中

dependencies:
  logman: ^[latest_version]

将 [latest_version] 替换为 Logman 的最新版本。

  1. 安装它
flutter packages get
  1. 在您的 Dart 代码中导入它
import 'package:logman/logman.dart';

用法

在您的应用根目录 (MaterialApp 之后) 初始化 Logman,并在整个应用中使用其实例。

  1. 附加叠加层

@override
void initState() {
   super.initState();
   WidgetsBinding.instance.addPostFrameCallback((_) {
      logman.attachOverlay(
         context: context,
         debugPage: // Your optional debug page,
         button: // Your optional custom button,
      );
   });
}
  1. 记录事件

目前有 3 种日志类型(简单、导航和网络)。

final Logman _logman = Logman.instance;

_logman.recordSimpleLog('test');

示例应用中已准备好了一个 Dio 拦截器。此外,Logman 还附带了一个 Navigator Observer。您可以在 MaterialApp 中像这样使用它。

MaterialApp(
  title: 'Logman Demo',
  theme: ...,
  home: const MyHomePage(title: 'Logman Demo Home Page'),
  navigatorObservers: [
    LogmanNavigatorObserver(), // Navigator observer
  ],
)

示例

在此处 查找完整示例

贡献

我们欢迎贡献!请阅读我们的贡献指南以获取更多信息。

许可证

Logman 在 Apache 2.0 许可下发布。

GitHub

查看 Github