# flutterApp

**Repository Path**: yaoshanli/flutter-app

## Basic Information

- **Project Name**: flutterApp
- **Description**: flutter脚手架
- **Primary Language**: Dart
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-02
- **Last Updated**: 2026-03-27

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README



# Flutter 应用脚手架项目

一个基于 Flutter 开发的跨平台移动应用脚手架项目，支持 Android、iOS、Linux、macOS、Windows 和 Web 平台。

## 项目简介

本项目采用 Clean Architecture 架构设计，模块化程度高，便于维护和扩展。集成了常用的开发组件和最佳实践，帮助开发者快速启动新项目。

## 技术栈

- **框架**: Flutter 3.x
- **状态管理**: Provider
- **网络请求**: Dio + 拦截器
- **本地存储**: SharedPreferences
- **数据库**: SQLite
- **路由管理**: 手动路由配置

## 项目结构

```
lib/
├── app.dart                    # 应用入口配置
├── main.dart                   # 程序主入口
├── core/                       # 核心模块
│   ├── config/                 # 环境配置
│   ├── constants/             # 常量定义
│   ├── database/              # 数据库操作
│   ├── di/                    # 依赖注入
│   ├── error/                 # 错误处理
│   ├── network/               # 网络请求 (Dio)
│   │   └── interceptors/      # 拦截器
│   ├── router/                # 路由管理
│   ├── theme/                 # 主题配置
│   └── utils/                 # 工具类
├── features/                  # 功能模块
│   ├── chat/                  # 聊天功能
│   ├── home/                  # 首页功能
│   │   ├── models/            # 数据模型
│   │   ├── providers/        # 状态管理
│   │   ├── repositories/     # 数据仓库
│   │   ├── services/         # 服务层
│   │   ├── views/            # 页面视图
│   │   └── widgets/          # 自定义组件
│   ├── login/                 # 登录功能
│   ├── my/                    # 个人中心
│   └── second/                # 第二页面
└── shared/                    # 共享资源
    └── widgets/               # 共享组件
```

## 功能特性

- **用户认证**: 登录页面及认证拦截器
- **首页展示**: 包含抽屉导航、底部栏和内容区域
- **聊天功能**: 聊天页面视图
- **个人中心**: 用户个人页面
- **网络层**: 封装好的 Dio 请求和认证拦截
- **本地存储**: SharedPreferences 持久化
- **权限管理**: 权限工具类
- **主题切换**: 支持明暗主题

## 环境要求

- Flutter SDK: 3.x 或更高版本
- Dart SDK: 2.x 或更高版本
- Android: API 21+
- iOS: 12.0+
- 其他平台需要相应环境支持

## 安装运行

```bash
# 克隆项目
git clone https://gitee.com/yaoshanli/flutter-app.git
cd flutter-app

# 获取依赖
flutter pub get

# 运行项目
flutter run
```

## 构建 APK

```bash
# Debug 版本
flutter build apk --debug

# Release 版本
flutter build apk --release
```

## 构建 iOS

```bash
flutter build ios
```

## 核心模块说明

### 网络层 (`lib/core/network/`)
- `dio_client.dart`: Dio 实例封装
- `auth_interceptor.dart`: 认证拦截器，处理 Token

### 路由 (`lib/core/router/`)
- `app_router.dart`: 应用路由配置

### 数据库 (`lib/core/database/`)
- `database_helper.dart`: SQLite 数据库助手

### 主题 (`lib/core/theme/`)
- `app_theme.dart`: 应用主题配置

## 开发指南

1. 新增功能模块时，在 `lib/features/` 下创建对应目录
2. 遵循 MVC/Provider 模式：models → repositories → providers → views
3. 共用组件放在 `lib/shared/widgets/` 目录
4. 工具类放在 `lib/core/utils/` 目录

## 许可证

本项目基于 LICENSE 文件中指定的许可证开源。

## 参考资源

- [Flutter 官方文档](https://docs.flutter.dev/)
- [Flutter 中文文档](https://flutter.cn/)
- [Dart 语言教程](https://dart.cn/)