# 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:7788`
- `apiKey`：后端 `.env` 里的 `SMS_GATEWAY_API_KEY`
- （不再需要 `deviceId`：由后端根据 `apiKey` 自动归属任务/短信）

保存后 App 会：

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

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

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

## 注意事项

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