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');
}
更多关于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.init
的 level
参数来设置日志级别。
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.e
或 Logger.wtf
来记录错误日志,并附带堆栈跟踪信息:
try {
// 一些可能抛出异常的代码
} catch (e, stackTrace) {
Logger.e("Error occurred", error: e, stackTrace: stackTrace);
}
13. 日志性能
folivora_logger
在设计时考虑了性能问题,因此它不会对应用的性能产生显著影响。
14. 日志清理
你可以通过 Logger.clear
来清理所有日志:
Logger.clear();