# tk-flutter

**Repository Path**: binglanse/tk-flutter

## Basic Information

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

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-04-10
- **Last Updated**: 2026-04-22

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 仿抖音短视频应用

一个使用 Flutter 开发的仿抖音风格短视频应用，用于学习 Flutter 移动应用开发。

## 功能特性

### 核心功能
- **首页视频流** - 上下滑动切换视频，自动播放，暂停控制
- **视频交互** - 点赞、评论、收藏、分享
- **发现页** - 热门话题、推荐视频网格
- **发布功能** - 拍摄、相册选择入口
- **消息中心** - 系统通知、消息列表
- **个人主页** - 用户信息、作品列表、关注/粉丝

### 技术特点
- 使用 Provider 进行状态管理
- go_router 路由管理
- video_player 视频播放
- 深色主题，仿抖音UI风格
- 模拟数据，无需后端API

## 项目结构

```
lib/
├── main.dart                 # 应用入口
├── app.dart                  # MaterialApp配置
├── config/
│   └── app_theme.dart        # 主题配置
├── models/
│   ├── video.dart            # 视频模型
│   ├── user.dart             # 用户模型
│   └── comment.dart          # 评论模型
├── providers/
│   ├── video_provider.dart   # 视频状态管理
│   └── user_provider.dart    # 用户状态管理
├── services/
│   └── mock_data_service.dart # 模拟数据服务
├── screens/
│   ├── home/                 # 首页
│   ├── discover/             # 发现页
│   ├── publish/              # 发布页
│   ├── message/              # 消息页
│   └── profile/              # 个人主页
├── widgets/
│   ├── video_player_item.dart   # 视频播放组件
│   ├── video_action_bar.dart    # 视频交互栏
│   └── video_info.dart          # 视频信息组件
└── router/
    └── app_router.dart          # 路由配置
```

## 运行项目

### 环境要求
- Flutter SDK >= 3.11.3
- Dart SDK >= 3.11.3

### 运行步骤

1. 安装依赖
```bash
flutter pub get
```

2. 运行应用
```bash
flutter run
```

## 主要依赖

| 包名 | 用途 |
|------|------|
| provider | 状态管理 |
| go_router | 路由导航 |
| video_player | 视频播放 |
| cached_network_image | 图片缓存 |
| shared_preferences | 本地存储 |
| flutter_animate | 动画效果 |
| shimmer | 骨架屏效果 |
| share_plus | 分享功能 |

## 截图

> 应用采用深色主题，界面简洁美观

## 学习要点

1. **状态管理** - Provider 的使用方式，多 Provider 组合
2. **路由管理** - go_router 的 ShellRoute 和嵌套路由
3. **视频播放** - video_player 的初始化、控制、生命周期
4. **UI开发** - Stack 布局、滑动组件、动画效果
5. **数据模型** - 模型设计、JSON序列化

## License

MIT License