yunzesms/SMS/README.md
2026-03-25 17:15:46 +08:00

1.4 KiB
Raw Blame History

android-gateway安卓短信网关端

使用方式Android Studio 导入)

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

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

配置说明(运行前)

首次进入 App 会让你填写:

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

保存后 App 会:

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

你也可以使用 短信测试 功能:

  • 在输入框填写国际格式号码,例如 +8613712345678
  • 点击“短信测试”发送一条固定测试短信到该号码

注意事项

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