📦 Android SmsSDK 集成

Android SMSSDK（短信验证）集成 Skill 适用场景 当用户提到以下任一主题时，使用本 Skill： android smssdk 短信验证集成 / 短信验证码 / 语音验证码 / SMSSDK SDK 接入 / 我要在 app 中增加短信验证 / 我要在 Android 项目中接入短信验证码功能 / 帮我配置短信验证 / 一键集成 SMSSDK / 快速接入短信验证 / 自动配置 SMSSDK

若用户问题明确与 Android 短信验证接入、工程配置、验证码功能、自定义 UI 有关，优先使用本 Skill。

6 步交互式集成工作流 用户表达集成 SMSSDK 意图时，执行以下 6 步，每步需用户确认后再继续。

步骤 1：启动流程 1-1 触发识别 用户可能说： “我要在 app 中增加短信验证” “帮我集成 SMSSDK 到 Android 项目” “配置短信验证” “一键集成短信验证” “Android 短信验证码功能怎么接入”

1-2 询问项目路径 我来帮你集成 SMSSDK 短信验证功能。 请提供需要集成的 Android 项目根路径，例如： /Users/xxx/your-android-project 请确保项目包含 app/build.gradle 文件。

1-3 验证路径合法性 检查路径是否存在、含 app/build.gradle、为有效 Android 结构。 不合法： 路径验证失败，可能原因：

• 路径不存在：{path}
• 未找到 app/build.gradle，请确认这是 Android 项目根目录

步骤 2：注册 SMSSDK 配置信息 2-1 生成配置模板 运行脚本生成 SMSSDK_Config_Template.xlsx → 复制到项目根目录并改名为 SMSSDK_Config.xlsx 已在你项目根目录生成 {path}/SMSSDK_Config.xlsx。 请打开并按以下步骤填写：

• “基础信息”Sheet 填写 MobTech 的 appKey、appSecret（https://www.mob.com/ 注册获取）
• 填写 Android 包名
• “短信签名审核”Sheet 填写短信签名（企业需审核，个人可用默认【掌淘科技】）
• “填写说明”Sheet 有详细指引

2-2 等待用户回复“填好了”

2-3 读取并验证配置 验证 appKey、appSecret、包名等字段；不通过给出具体提示并让用户修正后再次回复“填好了”。 合法：提取配置，进入步骤 3

步骤 3：完成 SDK 集成 3-1 Gradle 环境配置 按 AGP 版本选择配置方式： AGP 7.0+： settings.gradle 添加 pluginManagement & dependencyResolutionManagement 中增加 maven { url "https://mvn.mob.com/android" } 项目级 build.gradle 添加 classpath "com.mob.sdk:MobSDK2:+" （可选）classpath 'com.google.gms:google-services:4.3.14' AGP <7.0： 项目级 build.gradle 的 allprojects & buildscript 添加 maven { url "https://mvn.mob.com/android" } 及 classpath "com.mob.sdk:MobSDK2:+" gradle.properties： 上架 GooglePlay → MobSDK.spEdition=GPP 否则 → MobSDK.spEdition=FP app/build.gradle： apply plugin: 'com.mob.sdk' 或 plugins { id 'com.mob.sdk' } 末尾添加 MobSDK { appKey "{用户appKey}" appSecret "{用户appSecret}" SMSSDK {} } 询问：“以上内容将写入 app/build.gradle，是否确认？”

3-2 执行 Gradle Sync 说明需同步，尝试命令行 ./gradlew --refresh-dependencies 成功：提示再手动 IDE Sync 失败：提示手动 IDE Sync 完成后进入步骤 4

步骤 4：补充隐私合规 4-1 说明隐私授权 需首次启动展示《隐私政策》弹窗，用户点击“同意”后调用 MobSDK.submitPolicyGrantResult(true); 请告知回调代码所在文件及方法，如 MainActivity.java 的 onPrivacyAgreed()

4-2 展示插入代码并询问确认

4-3 用户确认后插入，进入步骤 5

步骤 5：插入短信验证代码 5-1 询问集成方式

• 自带 UI 页面（快速，一行代码拉起默认注册页）
• 自定义集成（灵活，自己写 UI + 调用底层接口）

5-2 方式一：自带 UI 页面 等待用户给出要插入代码的文件路径与方法名，展示： // === SMSSDK 自带 UI 页面 === RegisterPage page = new RegisterPage(); page.setTempCode(null); page.setRegister...