SyncClipboard Android 安卓剪贴板同步

898 字
4 分钟
SyncClipboard Android 安卓剪贴板同步

📋 SyncClipboard Android#

jacksen168sub
/
SyncClipboard-Android
Waiting for api.github.com...
00K
0K
0K
Waiting...

Jeric-X/SyncClipboard 的 Android 客户端,支持使用 Xposed 在后台自动同步剪贴板 | Android client for Jeric-X/SyncClipboard, supports using Xposed to automatically sync the clipboard in the background

使用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.00 ~ 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操作系统
Terminal window
# 克隆代码
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操作系统
Terminal window
# 克隆代码
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. 由于安卓系统限制,在Android10及以上的系统应用无法在后台读取剪贴板,但可以使用基于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 - 随便用

文章分享

如果这篇文章对你有帮助,欢迎分享给更多人!

SyncClipboard Android 安卓剪贴板同步
https://blog.jacksen168.top/posts/syncclipboard-android/
作者
jacksen168
发布于
2025-08-24
许可协议
CC BY-NC-SA 4.0

评论区

Profile Image of the Author
jacksen168
Hello, I'm jacksen168.
音乐
封面

音乐

暂未播放

0:00 0:00
暂无歌词
分类
标签
站点统计
文章
19
分类
4
标签
46
总字数
21,887
运行时长
0
最后活动
0 天前
访问统计
当前在线
-
今日访问
-
今日浏览
-
昨日访问
-
昨日浏览
-
本月访问
-
累计访问
-

文章目录