37 lines
1.4 KiB
Markdown
37 lines
1.4 KiB
Markdown
# 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`：例如 `https://yzsms.yunzer.cn`
|
||
- `apiKey`：后端 `.env` 里的 `SMS_GATEWAY_API_KEY`
|
||
- （不再需要 `deviceId`：由后端根据 `apiKey` 自动归属任务/短信）
|
||
|
||
保存后 App 会：
|
||
|
||
- 启动前台服务轮询后端下发发送任务
|
||
- 注册系统短信接收广播，上报短信内容并解析验证码
|
||
|
||
你也可以使用 `短信测试` 功能：
|
||
|
||
- 在输入框填写国际格式号码，例如 `+8613712345678`
|
||
- 点击“短信测试”发送一条固定测试短信到该号码
|
||
|
||
## 注意事项
|
||
|
||
- 需要运行时授权：`接收短信`、`发送短信`
|
||
- 安卓 13+ 还需要授权：`通知`（用于前台服务）
|
||
- 该端用于你自己的合法业务场景，避免违规批量操作
|