# cloudflear-r2-flutter

**Repository Path**: yaoyaolei/cloudflear-r2-flutter

## Basic Information

- **Project Name**: cloudflear-r2-flutter
- **Description**: cloudflear-r2-flutter文件管理系统
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-20
- **Last Updated**: 2026-03-20

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# R2文件管理（CloudDrive）

基于 Flutter 的 Cloudflare R2 对象存储文件管理客户端，支持 Android 和 Windows 双平台。

## 功能特性

- 📁 **文件浏览** — 浏览 R2 存储桶中的文件和文件夹
- ⬆️ **文件上传/下载** — 支持文件传输与进度显示
- 👁️ **文件预览** — 图片等文件在线预览
- 🔗 **分享** — 生成文件分享链接和二维码
- 🔐 **认证管理** — 安全存储 R2 访问凭证
- ⚙️ **多服务器配置** — 支持配置多个 R2 存储桶

## 技术栈

| 类别 | 技术 |
|------|------|
| 框架 | Flutter 3.41+ / Dart 3.11+ |
| 状态管理 | Riverpod |
| 路由 | GoRouter |
| 网络请求 | Dio |
| 本地存储 | Hive / FlutterSecureStorage |

## 项目结构

```
lib/
├── main.dart                # 入口
├── app.dart                 # App 根组件
├── core/                    # 核心模块
│   ├── r2/                  # R2 API 对接
│   ├── models/              # 数据模型
│   ├── router/              # 路由配置
│   ├── storage/             # 本地存储
│   ├── theme/               # 主题配置
│   ├── widgets/             # 通用组件
│   └── utils/               # 工具函数
└── features/                # 功能模块
    ├── auth/                # 认证
    ├── browser/             # 文件浏览
    ├── preview/             # 文件预览
    ├── settings/            # 设置
    ├── share/               # 分享
    └── transfer/            # 传输管理
```

## 快速开始

```powershell
# 安装依赖
flutter pub get

# 调试运行（Android 模拟器）
flutter run -d emulator-5554

# 调试运行（Windows）
flutter run -d windows
```

## 打包发布

详见 [BUILD.md](BUILD.md)。