📋 SyncClipboard Android

基于SyncClipboard api开发的安卓客户端,使用AI coding娱乐的副产物,不过还是有在维护的,自己也有在使用

使用SyncClipboard 作为服务端

✨ 主要功能

🔄 剪贴板同步

• 剪贴板实时同步
• 支持文本、图片和文件
• 可后台自启常驻、多任务页隐藏
• 支持日志功能

✅ 类型支持

类型	上传	下载
文本	🟩读取剪贴板/ROOT后台读取剪贴板/磁贴与常驻通知手动读取	🟩写入剪贴板/后台写入剪贴板
图片	🟩读取剪贴板/ROOT后台读取剪贴板/磁贴与常驻通知手动读取	🟩写入剪贴板/后台写入剪贴板
单文件	🟥暂不支持	🟦支持手动/后台自动保存至本地
多文件	🟥暂不支持	🟥暂不支持

🚀 快速开始

第一次使用

1. 安装应用: 发行版 下载APK直接安装(需下载-signed.apk结尾的已签名安装包)

2. 授权权限: 跟着提示给权限就行

3. 配置服务器: 填入你的SyncClipboard服务器地址

4. 开始同步: 点击右下角开始按钮，然后试试复制点什么

服务端搭建

如果你还没有服务端，请先看看它 SyncClipboard ,Windows客户端自带服务器

⚠️ 版本兼容

客户端版本	兼容服务端	说明
v1.6.0+	v3.1.1+	服务端v3.1.1开始使用了全新的API,你需要使用v3.1.1以上的版本才能正常使用
v1.0.0 ~ v1.5.0	0 ~ v3.1.0	客户端v1.5.0之前的版本均兼容服务端v3.1.0及前版本

🛠️ 技术栈

• Jetpack Compose
• MVVM + Clean Architecture
• Kotlin协程
• Room + DataStore
• Retrofit

📱 支持设备

• 系统要求: Android 9.0 及以上
• Redmi K50: Android 12 测试可用
• Vivo Y5S: Android 9 测试可用
• MEIZU 20 PRO: Android 16 测试可用

🔧 开发相关

想要自己编译？

详细内容请查看 BUILD.md

Windows操作系统

# 克隆代码
git clone https://github.com/jacksen168sub/SyncClipboard-Android.git
cd SyncClipboard-Android

# 先创建个签名&密钥
generate-keystore.bat

# 根目录创建 local.properties 输入SDK路径
sdk.dir=C\:\\Users\\<自己的用户名>\\AppData\\Local\\Android\\Sdk

# 用Android Studio打开build，或者命令行(终端)编译:

# 构建 Debug 版本:
gradlew assembleDebug

# 构建 Release版本:
gradlew assembleRelease

Linux操作系统

# 克隆代码
git clone https://github.com/jacksen168sub/SyncClipboard-Android.git
cd SyncClipboard-Android

# 设置shell文件权限
chmod +x generate-keystore.sh
chmod +x gradlew.sh

# 先创建个签名&密钥
./generate-keystore.sh

# 终端编译:
# 构建 Debug 版本:
./gradlew.sh assembleDebug

# 构建 Release版本:
./gradlew.sh assembleRelease

注意事项

1. 由于安卓系统限制,在安卓10及以上的系统应用无法在后台读取剪贴板,但可以使用基于Root权限的工具(Magisk/Xposed)解除应用后台读取剪贴版的权限,如Riru-ClipboardWhitelist / Clipboard Whitelist。由于在安卓13及以上的系统应用必须由用户手动授权才被允许访问系统日志(剪贴板),也可以使用Xposed自动为应用授权访问系统日志的权限,如DisableLogRequest/禁用日志访问请求 ,项目推荐搭配Clipboard Whitelist使用

项目结构

app/src/main/java/com/jacksen168/syncclipboard/
├── data/           # 数据层：API、数据库、Repository
├── presentation/   # UI层：界面、ViewModel、导航
├── service/        # 服务层：剪贴板监听、后台同步
├── receiver/       # 广播接收器：开机自启等
├── util/          # 工具类：权限管理等
└── work/          # 后台任务：定时同步

开发环境

• Android Studio最新版
• JDK 17+
• 一颗想让同步更方便的心❤️

🤝 协助开发:

• 欢迎提issue报告问题/许下愿望
• 欢迎提PR协助修复问题/实现新功能

📜 开源协议

MIT License - 随便用