log_pixie 是一个用于 Flutter 应用的日志记录与分析插件，它可以帮助开发者更方便地管理和分析应用的日志信息。以下是关于如何使用 log_pixie 的详细介绍。

1. 添加依赖

首先，你需要在 pubspec.yaml 文件中添加 log_pixie 的依赖：

dependencies:
  flutter:
    sdk: flutter
  log_pixie: ^latest_version

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

2. 初始化 LogPixie

在你的 Flutter 应用中，你需要在 main.dart 文件中初始化 LogPixie。通常，你可以在 main 函数中进行初始化：

import 'package:flutter/material.dart';
import 'package:log_pixie/log_pixie.dart';

void main() {
  // 初始化 LogPixie
  LogPixie.initialize(
    enableFileLogging: true, // 是否启用文件日志记录
    logLevel: LogLevel.verbose, // 设置日志级别
    logDirectory: 'logs', // 日志文件存储目录
  );

  runApp(MyApp());
}

3. 记录日志

在你的应用代码中，你可以使用 LogPixie 来记录日志。LogPixie 提供了不同级别的日志记录方法：

import 'package:log_pixie/log_pixie.dart';

void someFunction() {
  LogPixie.v('Verbose log message'); // 详细日志
  LogPixie.d('Debug log message');   // 调试日志
  LogPixie.i('Info log message');    // 信息日志
  LogPixie.w('Warning log message'); // 警告日志
  LogPixie.e('Error log message');   // 错误日志
  LogPixie.wtf('WTF log message');   // 严重错误日志
}

4. 查看日志

4.1 控制台日志

默认情况下，LogPixie 会将日志输出到控制台。你可以在调试时直接在控制台中查看日志信息。

4.2 文件日志

如果你启用了文件日志记录（enableFileLogging: true），日志会被保存到指定的目录中。你可以通过以下方式访问日志文件：

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

Future<void> viewLogs() async {
  final directory = await getApplicationDocumentsDirectory();
  final logDirectory = Directory('${directory.path}/logs');

  if (await logDirectory.exists()) {
    final logFiles = logDirectory.listSync();
    for (var file in logFiles) {
      print('Log file: ${file.path}');
      // 读取并打印日志文件内容
      final content = await File(file.path).readAsString();
      print(content);
    }
  } else {
    print('Log directory does not exist.');
  }
}

5. 高级配置

LogPixie 提供了一些高级配置选项，例如自定义日志格式、日志文件大小限制等。你可以在初始化时进行配置：

LogPixie.initialize(
  enableFileLogging: true,
  logLevel: LogLevel.debug,
  logDirectory: 'logs',
  maxFileSize: 1024 * 1024, // 单个日志文件最大大小（字节）
  maxFiles: 5, // 最大日志文件数量
  logFormat: (level, message, stackTrace) => '[$level] $message', // 自定义日志格式
);

6. 日志分析

LogPixie 本身并不提供日志分析功能，但你可以通过以下方式进行日志分析：

• 导出日志文件：将日志文件导出到外部工具（如 ELK Stack、Splunk 等）进行分析。
• 集成其他日志服务：你可以将 LogPixie 与其他日志服务（如 Firebase Crashlytics、Sentry 等）结合使用，进行更深入的日志分析。

7. 清理日志

你可以定期清理旧的日志文件，以避免日志文件占用过多存储空间：

Future<void> cleanLogs() async {
  final directory = await getApplicationDocumentsDirectory();
  final logDirectory = Directory('${directory.path}/logs');

  if (await logDirectory.exists()) {
    final logFiles = logDirectory.listSync();
    for (var file in logFiles) {
      await file.delete();
    }
    print('Logs cleaned successfully.');
  } else {
    print('Log directory does not exist.');
  }
}