yunzesms/SMS

android-gateway（安卓短信网关端）

使用方式（Android Studio 导入）

由于仓库里无法直接提供 gradle-wrapper.jar 这类二进制文件，你需要在 Android Studio 里先创建一个项目，再把本目录里的源码/配置拷贝进去。

1. Android Studio：创建新项目
   • Template：Empty Activity
   • Kotlin：勾选
   • Package name：com.yunzer.sms（建议与本项目一致）
2. 把本目录 app/src/main/... 下的内容复制到你新建项目对应位置（覆盖同名文件）
3. 把本目录根目录下的 build.gradle / settings.gradle / app/build.gradle 复制到对应位置（如需）

配置说明（运行前）

首次进入 App 会让你填写：

• backendUrl：例如 http://192.168.1.10:3000
• apiKey：后端 .env 里的 SMS_GATEWAY_API_KEY
• （不再需要 deviceId：由后端根据 apiKey 自动归属任务/短信）

保存后 App 会：

• 启动前台服务轮询后端下发发送任务
• 注册系统短信接收广播，上报短信内容并解析验证码

你也可以点击 检测心跳 按钮，用于手动验证 App 与后端的网络/鉴权通断。

注意事项

• 需要运行时授权：接收短信、发送短信
• 安卓 13+ 还需要授权：通知（用于前台服务）
• 该端用于你自己的合法业务场景，避免违规批量操作