Flutter日志记录插件folivora_logger的使用

Flutter日志记录插件folivora_logger的使用

Features

此插件提供了多种日志记录功能,包括普通日志、警告、信息、调试、构建日志、HTTP请求日志等,并支持异常和错误的日志记录。


Getting started

在开始使用 folivora_logger 插件之前,请确保将其添加到项目的 pubspec.yaml 文件中:

dependencies:
  folivora_logger: ^版本号

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

flutter pub get

Usage

以下是 folivora_logger 的使用示例,展示如何记录不同类型的日志。

示例代码

import 'package:folivora_logger/folivora_logger.dart';

// 忽略:依赖包
import 'package:http/http.dart' as http;
import 'package:flutter/material.dart';
import 'package:twostrings_palette/twostrings_palette.dart';

void main() {
  runApp(const MyApp());
}

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

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      debugShowCheckedModeBanner: false,
      title: 'Two Strings Package Test App',
      theme: ThemeData(
        primarySwatch: MaterialColor(
          TwoStringsColor.primaryMaterialColor.colorHex,
          TwoStringsColor.primaryMaterialColor.swatch,
        ),
      ),
      home: const MyHomePage(title: 'Two Strings Home Page'),
    );
  }
}

class MyHomePage extends StatefulWidget {
  const MyHomePage({Key? key, required this.title}) : super(key: key);
  final String title;

  [@override](/user/override)
  State<MyHomePage> createState() => _MyHomePageState();
}

class _MyHomePageState extends State<MyHomePage> {
  Uri _generateUri() {
    // 生成测试API的URI
    return Uri(scheme: "https", host: "api.agify.io", path: null, queryParameters: null, query: "name=dhkim");
  }

  Future<http.Response> _httpRequest({required http.Request request}) async {
    // 发送HTTP请求并返回响应
    final streamedResponse = await request.send();
    return await http.Response.fromStream(streamedResponse);
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: const Text('Package example app'),
      ),
      body: Center(
        child: ElevatedButton(
          onPressed: () async {
            // 使用FvLogger记录不同类型日志
            FvLogger("Default Logger");
            FvLogger("You can use this for even Object ${_TestObjectPrint()}");
            FvLogger.warning("Warning");
            FvLogger.info("Info");
            FvLogger.debug("Debugging");
            FvLogger.log("log1\nlog2\nlog3\nlog4\nlog5");
            FvLogger.build("build start\nbuilding...\nbuilding...\nbuilding...\nbuild done");

            // 使用FvFunLogger记录趣味性日志
            FvFunLogger.heart("I Love You.");
            FvFunLogger.poop("Shit Code");

            // 记录异常和错误
            FvLogger.exception(_FvException("Exception Message"));
            FvLogger.error(FvError.example());

            // HTTP请求和响应日志
            http.Request request = http.Request("GET", _generateUri());
            request.headers.addAll({'Content-Type': 'application/json'});

            FvLogger.httpRequest(httpRequest: request);
            http.Response response = await _httpRequest(request: request);
            FvLogger.httpResponse(httpResponse: response);
            FvLogger.httpResponse(httpResponse: response, printHeaders: true);
          },
          child: const Text("Test"),
        ),
      ),
    );
  }
}

class _TestObjectPrint {
  final String str = "Instance";
  final int integer = 3;
}

class _FvException implements Exception {
  _FvException(this.message);

  final String? message;

  [@override](/user/override)
  String toString() {
    return "FvException: $message";
  }
}

class FvError implements Error {
  final String? type;
  final String? message;
  final String? title;
  final String? detail;

  FvError({this.type, this.message, this.title, this.detail});

  [@override](/user/override)
  String toString() {
    return "$type\n$message\n$title\n$detail";
  }

  [@override](/user/override)
  StackTrace? get stackTrace => throw UnimplementedError();

  factory FvError.example({String? type, String? message, String? title, String? detail}) = _Example;
}

class _Example extends FvError {
  _Example({String? type, String? message, String? title, String? detail})
      : super(
            type: type ?? "TEST_ERROR",
            message: message ?? 'Error occurred',
            title: title ?? 'Error Title',
            detail: detail ?? 'Error Message');
}
1 回复

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


folivora_logger 是一个用于 Flutter 应用的日志记录插件,它提供了简单且灵活的日志记录功能。以下是如何在 Flutter 项目中使用 folivora_logger 的基本步骤:

1. 添加依赖

首先,在 pubspec.yaml 文件中添加 folivora_logger 依赖:

dependencies:
  flutter:
    sdk: flutter
  folivora_logger: ^1.0.0  # 请使用最新版本

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

2. 初始化 Logger

在你的 Dart 文件中导入 folivora_logger 并初始化 Logger 实例:

import 'package:folivora_logger/folivora_logger.dart';

void main() {
  // 初始化 Logger
  Logger.init(
    level: Level.ALL,  // 设置日志级别
    printer: PrettyPrinter(),  // 使用 PrettyPrinter 打印日志
  );

  runApp(MyApp());
}

3. 记录日志

你可以使用 Logger 实例来记录不同级别的日志:

class MyApp extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    // 记录不同级别的日志
    Logger.v("Verbose log");  // 详细日志
    Logger.d("Debug log");    // 调试日志
    Logger.i("Info log");     // 信息日志
    Logger.w("Warning log");  // 警告日志
    Logger.e("Error log");    // 错误日志
    Logger.wtf("WTF log");    // 严重错误日志

    return MaterialApp(
      title: 'Flutter Demo',
      theme: ThemeData(
        primarySwatch: Colors.blue,
      ),
      home: MyHomePage(),
    );
  }
}

4. 自定义日志输出

你可以通过自定义 Printer 来改变日志的输出格式。例如,使用 PrettyPrinter 可以让日志输出更加美观:

Logger.init(
  level: Level.ALL,
  printer: PrettyPrinter(
    methodCount: 2,  // 显示的方法调用栈数量
    errorMethodCount: 8,  // 错误日志显示的方法调用栈数量
    lineLength: 120,  // 每行的最大长度
    colors: true,  // 是否使用颜色
    printEmojis: true,  // 是否打印表情符号
    printTime: false,  // 是否打印时间
  ),
);

5. 日志级别

folivora_logger 支持以下日志级别:

  • Level.ALL: 记录所有日志
  • Level.VERBOSE: 记录详细日志
  • Level.DEBUG: 记录调试日志
  • Level.INFO: 记录信息日志
  • Level.WARNING: 记录警告日志
  • Level.ERROR: 记录错误日志
  • Level.WTF: 记录严重错误日志
  • Level.NONE: 不记录任何日志

你可以通过 Logger.initlevel 参数来设置日志级别。

6. 日志过滤

你还可以通过 Logger.addFilter 来添加日志过滤器,以便只记录特定条件的日志:

Logger.addFilter((log) {
  return log.level >= Level.WARNING;  // 只记录警告及以上级别的日志
});

7. 日志输出到文件

如果你需要将日志输出到文件,可以使用 FileOutput

import 'package:folivora_logger/folivora_logger.dart';
import 'dart:io';

void main() {
  Logger.init(
    level: Level.ALL,
    printer: PrettyPrinter(),
    output: FileOutput(File('log.txt')),  // 将日志输出到文件
  );

  runApp(MyApp());
}

8. 日志输出到控制台

默认情况下,日志会输出到控制台。如果你需要自定义控制台输出,可以使用 ConsoleOutput

Logger.init(
  level: Level.ALL,
  printer: PrettyPrinter(),
  output: ConsoleOutput(),  // 将日志输出到控制台
);

9. 日志输出到其他目标

你还可以通过实现 LogOutput 接口来将日志输出到其他目标,例如网络、数据库等。

10. 日志格式化

你可以通过实现 LogFormatter 接口来自定义日志的格式化方式。

11. 日志标签

你可以为每条日志添加标签,以便更好地组织和过滤日志:

Logger.d("Debug log", tag: "MyTag");

12. 日志堆栈跟踪

你可以通过 Logger.eLogger.wtf 来记录错误日志,并附带堆栈跟踪信息:

try {
  // 一些可能抛出异常的代码
} catch (e, stackTrace) {
  Logger.e("Error occurred", error: e, stackTrace: stackTrace);
}

13. 日志性能

folivora_logger 在设计时考虑了性能问题,因此它不会对应用的性能产生显著影响。

14. 日志清理

你可以通过 Logger.clear 来清理所有日志:

Logger.clear();
回到顶部
AI 助手
你好,我是IT营的 AI 助手
您可以尝试点击下方的快捷入口开启体验!