Easy Share

Easy Share 是一款兼容互传联盟协议的 Android 本地文件互传应用，可通过蓝牙发现附近的互传联盟设备，并使用 Wi‑Fi Direct 建立高速点对点连接。文件仅在设备之间直接传输，不依赖云端中转。

Easy Share 基于 kmod-midori/CatShare 开发，并在 Codex 协助下完成全面重构。项目在保留互传联盟兼容能力的基础上，重新设计了界面、交互与传输流程，并增强了设备识别、传输稳定性与安全性。感谢 CatShare 原作者及所有贡献者。

功能

• 支持单文件、多文件和文本分享
• 兼容互传联盟 BLE/GATT 发现与协商流程
• 使用 Wi‑Fi Direct、HTTPS 和 WebSocket 完成点对点传输
• 支持接收确认、拒绝、取消、进度显示和结果通知
• 自动识别 Pixel、Samsung、Xiaomi、Redmi、OnePlus、OPPO、vivo、Meizu 等设备品牌
• 支持自定义设备名称、品牌和下载位置
• 提供“互传联盟”快速设置磁贴
• 发送前通过 Shizuku 获取本机 P2P MAC 地址
• 会话级 TLS 证书校验、随机令牌和安全传输元数据
• 针对 Android 16/17 及不同厂商 Wi‑Fi Direct 路由行为做了兼容处理

使用要求

• Android 12（API 31）或更高版本
• 发送和接收双方均需开启 Wi‑Fi 与蓝牙
• 发送文件前必须启动 Shizuku 并完成授权，用于获取本机 Wi‑Fi Direct MAC 地址；仅接收文件不依赖 Shizuku
• 默认接收目录为 Downloads/Easy Share

本地构建

项目使用 Gradle Wrapper，建议使用 JDK 21：

./gradlew testDebugUnitTest lintDebug assembleDebug

Release 构建会优先使用环境变量或用户级 Gradle 属性提供的正式签名；凭据缺失时自动回退到 debug 签名，确保新 clone 的项目仍可直接编译。GitHub Actions 只在临时目录恢复 release keystore，并在签名后立即删除，私钥不会进入仓库或构建产物。

自动发布

• 推送到 main：执行测试、Lint、Release 构建，并生成正式签名 APK artifact
• 创建 v* 标签：在完成验证和签名后自动创建 GitHub Release
• 产物包含通用版和仅保留 arm64-v8a 的精简版 APK，并附带 SHA-256 校验文件

详细流程见 发布说明。

参与贡献

提交代码前请阅读 贡献指南。安全问题请按 安全策略 私下报告。

开源许可

本项目基于 MIT License 发布，并保留 CatShare 原项目的版权声明。详见 LICENSE。