bling-yshs/sync-clipboard-flutter
Android 客戶端用於 Jeric-X/SyncClipboard
- Stars
- 121
- Forks
- 13
- 最近推送(UTC)
- 2026年8月28日
- 專案狀態
- 未封存
語言DartKotlin
使用的依賴
依賴清單 34 項
- flutter
{"sdk":"flutter"} - flutter_localizations
{"sdk":"flutter"} - cupertino_icons
^1.0.8 - dio
^5.9.0 - shared_preferences
^2.5.3 - logger
^2.6.2 - flutter_riverpod
^3.0.3 - riverpod_annotation
^3.0.3 - riverpod_generator
^3.0.3 - go_router
^17.0.0 - freezed
^3.2.3 - freezed_annotation
^3.1.0 - json_annotation
^4.9.0 - json_serializable
^6.11.2 - path_provider
^2.1.5 - fluttertoast
^9.0.0 - dynamic_color
^1.8.1 - archive
^4.0.7 - intl
^0.20.2 - package_info_plus
^9.0.0 - file_picker
^10.3.7 - pub_semver
^2.2.0 - android_package_installer
^0.0.3 - flutter_markdown_plus
^1.0.5 - crypto
^3.0.7 - uuid
^4.5.2 - path
^1.9.1 - permission_handler
^12.0.1 - super_clipboard
^0.9.1 - uri_content
^3.1.2 - build_runner開發依賴
^2.10.4 - flutter_test開發依賴
{"sdk":"flutter"} - flutter_lints開發依賴
^6.0.0 - flutter_launcher_icons開發依賴
^0.14.4
所在榜單
原始 README
以下為英文專案原文快照,最新內容請造訪 GitHub。
展開 / 收合專案 README
📋 Sync Clipboard Flutter
跨设备剪贴板同步 · 即用即走 · 安卓原生体验
Sync Clipboard Logo
[!IMPORTANT] 本项目原先使用 Tauri + Vue 开发,现已迁移至 Flutter。如需查看 Tauri 版本的代码,请切换到
archive-tauri分支。
✨ 项目简介
本项目是一个使用 Flutter 构建的 Material 3 风格的安卓客户端应用,作为 Jeric-X/SyncClipboard 项目的配套应用,实现跨设备的剪贴板内容同步功能。
🚀 功能特性
- 📤 剪贴板上传 - 将剪贴板内容上传到 SyncClipboard 服务器
- 📥 剪贴板下载 - 从 SyncClipboard 服务器下载文本并写入到剪贴板
- 📁 文件同步 - 支持单个图片/文件的上传和下载
- 📦 文件组下载 - 支持 group 类型的下载(但不支持 group 的上传)
- 📲 安卓原生分享 - 支持从其他应用分享文本或文件到本应用进行上传
- ⚡ 即用即走 - 上传/下载剪贴板后,将自动退出 app
📖 使用步骤
1️⃣ 下载安装
下载最新版本的 Sync Clipboard Flutter 并安装
2️⃣ 配置服务器
打开 app,进入设置页面,填写 SyncClipboard 服务器配置(支持 WebDAV 服务器)
设置页面
3️⃣ 添加磁贴
打开控制中心,添加磁贴「上传剪贴板」与「下载剪贴板」
添加磁贴
4️⃣ 开始使用
点击磁贴开始使用
使用磁贴
[!TIP] 您可以从相册或文件管理器中长按图片/文件,选择 分享 到本 App 来上传文件。或把图片/文件复制到剪贴板内再上传。
📂 项目结构
sync-clipboard-flutter/
├── lib/ # 📱 Flutter 源码
│ ├── main.dart # 🚀 应用入口
│ ├── page/ # 📄 页面组件
│ │ ├── main_page.dart # 🏠 主页面(底部导航)
│ │ ├── home_page.dart # 🏡 首页
│ │ ├── config_page.dart # ⚙️ 设置页面
│ │ ├── debug_page.dart # 🐛 调试页面
│ │ ├── tile_page.dart # 🔲 磁贴透明页面
│ │ └── share_upload_page.dart # 📤 分享上传页面
│ ├── model/ # 📦 数据模型
│ │ ├── app_settings/ # ⚙️ 应用设置
│ │ ├── server_config/ # 🌐 服务器配置
│ │ └── clipboard/ # 📋 剪贴板数据
│ ├── router/ # 🛣️ go_router 路由配置
│ ├── dio/ # 🌐 网络请求客户端
│ └── constants/ # 📌 常量定义
├── android/ # 🤖 Android 平台代码
│ └── app/src/main/kotlin/ # 📝 Kotlin 原生代码
│ ├── MainActivity.kt
│ ├── TileActionActivity.kt # 🔲 磁贴动作活动
│ ├── UploadClipboardTileService.kt # ⬆️ 上传磁贴服务
│ └── DownloadClipboardTileService.kt # ⬇️ 下载磁贴服务
└── pubspec.yaml # 📦 Flutter 依赖配置
🛠️ 开发环境
| 环境 | 版本要求 |
|---|---|
| 🐦 Flutter | 3.38.3 |
| 🎯 Dart SDK | ^3.10.1 |
| 🤖 Android SDK | 21+ |
🔨 构建指南
# 📦 安装依赖
flutter pub get
# 🚀 运行开发版本
flutter run
# 📱 构建 ARM64 Release APK
flutter build apk --release --target-platform android-arm64
📄 许可证
本项目采用 MIT 开源许可证。