app/README.md

app-dev

🚀 基于 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
• 公云存储 后端服务

安装依赖

flutter pub get

运行项目

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

构建发布

# 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 文件。

---