# flutter_utils

**Repository Path**: djun100/flutter_utils

## Basic Information

- **Project Name**: flutter_utils
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-10-19
- **Last Updated**: 2025-10-19

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Flutter Utils

一个包含网络工具和日志工具的 Flutter 包。

## 功能特性

### 网络工具 (Dio)
- 基于 Dio 的 HTTP 客户端封装

### 日志工具 (LogUtil)
- 日志按大小自动回滚（2MB）
- 日志文件按创建时间命名（年月日时分秒格式）
- 自动清理过期日志（保留14天）
- 支持多种日志级别
- 可选择是否同时输出到控制台

## 使用方法

### 日志工具使用

```dart
import 'package:flutter_utils/utils.dart';
import 'package:logging/logging.dart';

// 初始化日志系统
await LogUtil.init(
  logLevel: Level.INFO,     // 设置日志级别
  enableConsole: true,      // 是否输出到控制台
);

// 使用静态方法记录日志 (Android风格)
LogUtil.d('调试信息');
LogUtil.i('一般信息');
LogUtil.w('警告信息');
LogUtil.e('错误信息', error, stackTrace);
LogUtil.v('详细信息');

// 程序结束时清理资源
await LogUtil.dispose();
```

### 日志配置说明

- **日志文件大小**: 单个日志文件最大 2MB，超过后自动回滚
- **日志文件命名**: `app_YYYYMMDDHHMMSS.log` 格式
- **日志保留时间**: 自动删除 14 天前的日志文件
- **回滚文件数量**: 最多保留 10 个回滚文件

## 依赖

```yaml
dependencies:
  dio: ^5.4.0
  logging: ^1.2.0
  logging_appenders: ^1.2.0
  path: ^1.8.3
```