Flutter日志着色插件color_log的使用

Flutter日志着色插件color_log的使用

color_log 是一个Flutter插件，它提供了带有颜色和表情符号的日志输出，使得日志更加醒目和易于阅读。通过使用这个插件，开发者可以自定义日志输出，避免了默认的蓝色文本带来的混乱。

功能特性

color_log 提供了8种不同类型的日志输出：

• info：用于记录信息性日志。
• warning：用于记录警告信息。
• error：用于记录错误信息，通常在API调用或异常捕获时使用。
• debug：用于调试时的日志输出。
• checkSuccess：用于检查布尔值，并根据结果打印相应的日志（true或false）。
• custom：允许用户自定义颜色、表情符号和日志类型。

使用步骤

1. 添加依赖

   在 pubspec.yaml 文件中添加 color_log 依赖：

   dependencies:
     color_log: ^latest_version
   

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

2. 导入包

   在 Dart 文件中导入 color_log 包：

   import 'package:color_log/color_log.dart';
   

3. 使用示例

   下面是一个完整的示例代码，展示了如何在Flutter应用中使用 color_log 插件。该示例创建了一个包含多个按钮的页面，每个按钮点击时会触发不同类型的日志输出。

   import 'package:color_log/color_log.dart';
   import 'package:flutter/material.dart';
   
   void main() {
     runApp(const MyApp());
   }
   
   class MyApp extends StatelessWidget {
     const MyApp({super.key});
   
     @override
     Widget build(BuildContext context) {
       return MaterialApp(
         debugShowCheckedModeBanner: false,
         theme: ThemeData(
           primarySwatch: Colors.blue,
         ),
         home: const Home(),
       );
     }
   }
   
   class Home extends StatelessWidget {
     const Home({super.key});
   
     @override
     Widget build(BuildContext context) {
       return Scaffold(
         appBar: AppBar(
           title: const Text('Color Log Example'),
         ),
         body: Center(
           child: Column(
             mainAxisAlignment: MainAxisAlignment.center,
             crossAxisAlignment: CrossAxisAlignment.center,
             children: [
               Button(
                 onTap: () {
                   clog.info("This is an info log");
                 },
                 text: "Info",
                 color: Colors.cyan,
               ),
               Button(
                 onTap: () {
                   clog.warning("This is a warning log");
                 },
                 text: "Warning",
                 color: Colors.yellow,
               ),
               Button(
                 onTap: () {
                   clog.error("This is an error log");
                 },
                 text: "Error",
                 color: Colors.red,
               ),
               Button(
                 onTap: () {
                   try {
                     throw Exception("This is an exception");
                   } catch (e) {
                     clog.error(e.toString());
                     rethrow;
                   }
                 },
                 text: "Error with Stacktrace",
                 color: Colors.red,
               ),
               Button(
                 onTap: () {
                   clog.debug("This is a debug log");
                 },
                 text: "Debug",
                 color: Colors.yellow,
               ),
               Button(
                 onTap: () {
                   clog.checkSuccess(1 == 1, "Check if 1 == 1");
                 },
                 text: "Check Success (True)",
                 color: Colors.green,
               ),
               Button(
                 onTap: () {
                   clog.checkSuccess(1 != 1, "Check if 1 != 1");
                 },
                 text: "Check Success (False)",
                 color: Colors.red,
               ),
               Button(
                 onTap: () {
                   clog.todo("This is a TODO log");
                 },
                 text: "TODO",
                 color: Colors.pink,
               ),
               Button(
                 onTap: () {
                   clog.custom(
                       ansiColor: "\x1b[38;5;205m", // 自定义ANSI颜色
                       emoji: "🤓", // 自定义表情符号
                       logType: "custom", // 自定义日志类型
                       message: "This is a custom log");
                 },
                 text: "Custom",
                 color: Colors.pink,
               ),
             ],
           ),
         ),
       );
     }
   }
   
   class Button extends StatelessWidget {
     const Button({super.key, this.onTap, this.text, this.color});
     final VoidCallback? onTap;
     final String? text;
     final Color? color;
   
     @override
     Widget build(BuildContext context) {
       return Container(
         height: 50,
         margin: const EdgeInsets.all(16),
         width: MediaQuery.of(context).size.width,
         child: ElevatedButton(
           style: ElevatedButton.styleFrom(
             backgroundColor: color,
           ),
           onPressed: onTap,
           child: Text(
             text!,
             style: const TextStyle(color: Colors.white),
           ),
         ),
       );
     }
   }