# app-dev

[![Flutter](https://img.shields.io/badge/Flutter-3.41.6-blue?logo=flutter)](https://flutter.dev)
[![Dart](https://img.shields.io/badge/Dart-3.11.4-blue?logo=dart)](https://dart.dev)
[![License: AGPL v3](https://img.shields.io/badge/License-AGPL%20v3-blue.svg)](https://www.gnu.org/licenses/agpl-3.0)

> 🚀 基于 Flutter 的 公云存储 官方客户端，提供移动端/PC便捷管理体验

::: danger 警告
本分支含有未验证功能！非开发环境请勿使用！
:::

---

## 📖 项目简介

功能丰富的云存储客户端，支持文件上传、下载、管理和分享。针对 公云存储 API 进行了基本完整适配和优化。

### ✨ 特性亮点

- 🎯 现支持的功能基本完整适配 公云存储 API
- 📱 跨平台支持（Android / Linux / Windows / Web）
- 🎨 现代化 Material Design 3 界面
- ⚡ 支持断点续传和下载进度监听
- 🔐 安全的 Token 认证机制

---

## 🛠️ 技术栈

| 组件 | 版本 |
|------|------|
| Flutter | 3.41.6 |
| Dart | 3.11.4 |
| 后端 API | 公云存储 |

**开发环境详情：**

```
Debia
Flutter 3.41.6 • channel stable
Framework • revision db50e20168 • 2026-03-25
Dart 3.11.4 • DevTools 2.54.2
```

**构建环境详情：**

```
Android: compileAPI: 36, targetAPI: 36, miniAPI: 34
Windows: 11
Linux: Debian 12
```

---

## 🚀 快速开始

### 环境要求

- Flutter SDK >= 3.41.6
- Dart SDK >= 3.11.4
- 公云存储 后端服务

### 安装依赖

```bash
flutter pub get
```

### 运行项目

```bash
flutter run  # pdf 和 音视频会再构建过程中下载github上的依赖,自行解决网络问题
```

### 构建发布

```bash
# Android
flutter build apk --release
# Linux
flutter build -d linux --release
# windows
flutter build -d windows --release
```

---

## ⚖️ 开源协议 (License)

本项目采用 **AGPL-3.0 (GNU Affero General Public License v3.0)** 协议开源。

### 核心约束：
1. **传染性**：如果你修改了本项目代码并重新发布，你的项目也必须以 AGPL-3.0 协议开源。
2. **云端公开声明**：如果你在服务器/云真机等上运行本项目并向公众提供网络服务（网盘服务），你必须向用户公开你所使用的源代码（包括任何修改）。
3. **禁止闭源商业化**：未经授权，禁止将本项目代码闭源后作为商业产品销售。

详情请参阅项目根目录下的 [LICENSE](./LICENSE) 文件。

---