Flutter日志记录插件logly的使用

Flutter日志记录插件logly的使用

特性

  • 日志条目的源代码链接可点击。
  • 使用logging包通过多个严重级别进行日志记录。
  • 每个严重级别都有ANSI颜色编码。
  • 可以移除Flutter打印中的干扰信息（I/flutter (pid):）。
  • 自动调整严重级别阈值：
    • 在debug模式下，所有日志都会被打印。
    • 在profile模式下，从警告及以上级别的日志会被打印。
    • 在release模式下，没有任何日志被打印。
    • 这种行为可以通过手动设置级别来覆盖。
  • 部分可自定义格式。您可以启用或禁用时间戳、图标和到源代码的链接。

安装

在您的pubspec.yaml文件中添加库，并运行flutter pub get来获取库：

dependencies:
  logly: ^0.3.1+readme3

使用

要使用logly插件，只需导入库并调用log函数：

// 导入库
import 'package:logly/logly.dart';

void main() {
  // 默认情况下，级别为 `LogLevel.INFO`。可以简单地调用 `log`
  log("这是日志条目。");

  // 所有级别也可以通过其各自的函数显式调用：
  log.shout("这是一个呼叫，最高可能的严重级别。");
  log.warning("这是一个警告。");
  log.severe("这是一个严重的日志条目。");
  log.fine("这是一个细粒度的日志条目。");
  log.finer("这是一个更细粒度的日志条目。");
  log.finest("这是一个最细粒度的日志条目。");
  log.config("这是一个配置日志条目。");
  log.info("这是常见的信息级别日志条目。");
}

输出结果如下所示：

输出示例

点击链接可以跳转到日志条目的源代码。

模拟print

如果您只是想使用Logly进行常规打印，但希望清除Flutter打印中的干扰信息，可以将log.imitatePrint设置为true。

如果仍然希望保留跳转到源代码的链接，可以将log.addLink也设置为true。

已知问题

  • Android Studio不支持Flutter运行控制台中的ANSI输出。
    • 可以通过在Android Studio内部的终端中使用flutter logs来解决此问题。可以调用log.clear()来清除该终端。
    • 也可以通过将log.useAnsi设置为false来禁用ANSI输出。这会禁用许多logly的主要功能，如颜色和控制台清理。

示例代码

以下是一个完整的示例代码：

import 'package:logly/logly.dart';

void main() {
  // 默认情况下，级别为 `LogLevel.INFO`。可以简单地调用 `log`
  log("这是日志条目。");

  // 所有级别也可以通过其各自的函数显式调用：
  log.shout("这是一个呼叫，最高可能的严重级别。");
  log.warning("这是一个警告。");
  log.severe("这是一个严重的日志条目。");
  log.fine("这是一个细粒度的日志条目。");
  log.finer("这是一个更细粒度的日志条目。");
  log.finest("这是一个最细粒度的日志条目。");
  log.config("这是一个配置日志条目。");
  log.info("这是常见的信息级别日志条目。");
}

更多关于Flutter日志记录插件logly的使用的实战教程也可以访问 https://www.itying.com/category-92-b0.html

1 回复

更多关于Flutter日志记录插件logly的使用的实战系列教程也可以访问 https://www.itying.com/category-92-b0.html


当然，以下是如何在Flutter项目中使用logly插件进行日志记录的示例代码。请注意，由于logly插件可能是一个虚构或较少使用的插件，我将提供一个类似的日志记录插件的使用示例，并假设有一个类似的插件叫做logly。如果logly确实存在，那么其API应该大同小异。

首先，确保你已经在pubspec.yaml文件中添加了logly插件的依赖：

dependencies:
  flutter:
    sdk: flutter
  logly: ^x.y.z  # 替换为实际的版本号

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

接下来，你可以按照以下步骤在Flutter项目中使用logly插件进行日志记录：

  1. 导入插件：

在你的Dart文件中，导入logly插件：

import 'package:logly/logly.dart';
  1. 初始化插件：

通常在应用的入口文件（如main.dart）中初始化日志记录插件：

void main() {
  // 初始化logly插件
  Logly.init(
    level: LogLevel.verbose,  // 设置日志级别
    // 其他初始化参数，如日志文件路径、远程服务器地址等（如果插件支持）
  );

  runApp(MyApp());
}
  1. 记录日志：

在你的应用中的任何位置，使用Logly实例记录日志：

class MyApp extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    // 记录一条信息日志
    Logly.info('This is an info log message.');

    // 记录一条调试日志
    Logly.debug('This is a debug log message.');

    // 记录一条警告日志
    Logly.warn('This is a warning log message.');

    // 记录一条错误日志
    Logly.error('This is an error log message.');

    // 记录一条详细日志
    Logly.verbose('This is a verbose log message.');

    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: Text('Logly Example'),
        ),
        body: Center(
          child: Text('Check your log output for messages.'),
        ),
      ),
    );
  }
}
  1. 处理日志输出：

根据logly插件的具体实现，日志可能会被输出到控制台、文件或远程服务器。你可以查看插件的文档来了解如何配置和处理日志输出。

注意：由于logly可能是一个虚构的插件，上述代码是一个通用的日志记录插件使用示例。如果logly确实存在，请查阅其官方文档以获取准确的API和使用方法。

如果logly插件不存在，你可以考虑使用Flutter社区中广泛使用的日志记录插件，如logger插件，它提供了类似的功能和更详细的文档。

回到顶部