搜索插件、代码仓与 APP 分类

quick_log 封面
插件详情v5.5.3

quick_log

一个易于使用且可扩展的 Dart 日志包。特别适用于库中使用,因为它允许应用程序控制导入库的日志记录。

AndroidiOSWebmacOSWindowsLinux
近 30 天下载
4910
喜欢数
21
Pub 分数
150

安装插件

flutter pub add quick_log

插件介绍

基于插件公开信息、社区数据与项目使用情况整理的选型参考。

Quick Log 是一个轻量级、可扩展的 Dart 日志包,旨在实现简单性和灵活性。它使库能够发出日志,这些日志可由宿主应用程序控制,非常适合在共享代码中进行调试和监控。支持所有主要平台,提供一致的日志体验。该包允许开发者自定义日志级别、输出格式和目标位置,同时保持极低的开销。其模块化设计使其易于集成到现有项目中。

适合场景

  • 库级日志记录
  • 跨平台调试
  • 运行时日志控制
  • 应用监控
  • 错误跟踪
  • 开发时诊断

主要特点

  • 可配置的日志级别
  • 可扩展的后端系统
  • 集中式日志管理
  • Platform-agnostic
  • 最小性能影响
  • 可自定义的输出格式

适合对象

  • Dart 库作者
  • 跨平台应用
  • 调试工具
  • 实时监控系统
  • 面向开发人员的实用工具

使用建议

  • 需要应用层配置
  • 可能需要额外设置才能使用高级功能
  • 未针对高吞吐量生产日志记录进行优化
  • 有限的内置分析功能
  • 依赖外部配置文件

原始 README

以下为关联源码仓库的 README 原文快照,最新内容请访问源码仓库。

An easy to use and extendable logging package for Dart. Especially useful for use in libraries, as it allows application to control logging from the imported libraries.

Console Printer Output

Features

  • Ability to filter logs from imported libraries
  • 100% configurable (print logs to console, write to file or send to backend all possible!)
  • Similar to other logging packages, so nothing new to learn

Usage

A simple usage example:

import 'package:quick_log/quick_log.dart';

void main() {
  const log = Logger('LogExample');

  log.debug('this is a debug message');
  log.info('this is an info message');
}

Configuring logger output:

import 'package:quick_log/quick_log.dart';

void main() {
  const log = Logger('LogExample');

  Logger.writer = ConsolePrinter(minLevel: LogLevel.info);

  log.d('this is a debug message');
  log.i('this is an info message');
}

Ignoring logs:

import 'package:quick_log/quick_log.dart';

class ExampleLogger extends Logger {
  const ExampleLogger(String name) : super(name, 'ExampleLogger');
}

void main() {
  const log = ExampleLogger('LogExample');

  Logger.writer = ConsolePrinter(onlyTags: []);
  // Or
  Logger.writer = ConsolePrinter(exceptTags: [log.name]);

  // These messages won't be printed
  log.d('this is a debug message');
  log.i('this is an info message');
}

Can be used in tests by using the LogStreamWriter:

import 'package:quick_log/quick_log.dart';

test('test', () {
  const log = Logger('LogExample');
  final writer = LogStreamWriter();
  Logger.writer = writer;

  log.i('this line was executed');
  
  expect(writer.pastMessages.length, 1);
  expect(writer.lastMessage.message, 'this is an info message');
});

Please file feature requests and bugs at the issue tracker.

所属分类

依赖

依赖清单 3 项

源码仓库

使用此插件的项目