📦 Android Moblink Integration

Android MobLink 集成 技能 适用场景

当用户提到以下任一主题时，使用本 技能：

android moblink MobLink 集成 Link 集成 MobTech MobLink 接入 Android 深度链接 / Deeplink 场景还原 MobLink 的 Gradle 配置 MobLink uriScheme / 应用Link Host 配置 获取MobID / 设置恢复Scene列出ener / SceneRestorable MobLink 隐私合规 MobCustom控制器 扩展业务功能控制 我要在应用中增加深度链接能力 我要在Android项目中接入MobLink 帮我配置场景还原 一键集成 MobLink 自动配置 MobLink

如果用户问题明确与 Android 的 MobLink 接入、工程配置、场景还原、隐私合规有关，应优先使用本 技能。

官方文档依据

使用以下官方文档作为事实来源：

文档入口：https://www.mob.com/wiki/detAIled?wiki=661&id=34 Android 集成指南：https://www.mob.com/wiki/detAIled?wiki=115&id=34 Android SDK API：https://www.mob.com/wiki/detAIled?wiki=116&id=34 Android 合规指南：https://www.mob.com/wiki/detAIled?wiki=222&id=34 MobLink 扩展业务功能设置：https://www.mob.com/wiki/detAIled?wiki=660&id=34

关键事实：

官方 Android 集成方式：Android Studio + Gradle 在线集成。 Android 最低版本：minSdkVersion 19。 Maven 地址：https://mvn.mob.com/android。 MobSDK 插件：classpath "com.mob.sdk:MobSDK2:+"。 应用 模块需要应用 com.mob.sdk 插件。 MobSDK { 应用Key "..."; 应用Secret "..."; MobLink { uriScheme "..."; 应用LinkHost "..." } } 是核心配置。 Google Play 版本使用 MobSDK.spEdition=GPP。 文档集成指南中出现 MobSDK.spEdition=IZNAO；合规指南中说明隐私协议适配版本为 MobSDK.spEdition=FP。生成时必须向用户确认上架渠道与版本选择。 用户同意隐私政策后调用 MobSDK.submitPolicyGrant结果(true)，或使用 MobSDK.submitPolicyGrant结果(MobCustom控制器 cont, true)。 6 步交互式集成工作流

每步操作前都需要展示内容给用户确认，获得明确同意后再执行。

步骤 1：启动流程 1-1 询问项目路径 我来帮你集成 MobLink 场景还原功能。

请提供需要集成的 Android 项目根路径，例如： /path/to/your-android-project

请确保项目包含 设置tings.gradle 或 应用/build.gradle 文件。

1-2 验证路径合法性

验证逻辑：

检查路径是否存在。 检查路径下是否有 设置tings.gradle 或 设置tings.gradle.kts。 检查是否存在 应用 模块 Gradle 文件，例如 应用/build.gradle 或 应用/build.gradle.kts。 检查是否为有效 Android 项目结构。

如果路径不合法：

路径验证失败，可能原因：

• 路径不存在：{path}
• 未找到 设置tings.gradle / 设置tings.gradle.kts
• 未找到 应用/build.gradle / 应用/build.gradle.kts

请重新提供正确的 Android 项目根路径。

如果路径合法：进入步骤 2。

步骤 2：注册 MobLink 配置信息 2-1 生成配置模板文件

操作：

执行 as设置s/生成_excel_template.py，生成 as设置s/MobLink_Config_Template.xlsx 将生成的 as设置s/MobLink_Config_Template.xlsx 复制到 {path} 下 在 {path} 下命名为 MobLink_Config.xlsx

告知用户：

已在你项目的根目录生成 {path}/MobLink_Config.xlsx 配置文件。

请打开该文件，按以下步骤填写：

• 在"基础信息"Sheet 中填写 MobTech 的 应用Key、应用Secret、包名和签名 MD5
• 在"MobLink配置"Sheet 中填写 uriScheme、应用LinkHost 和默认场景路径
• 在"隐私合规"Sheet 中确认隐私政策、授权回调和扩展采集控制配置
• "填写说明"Sheet 中有官方文档链接和字段说明

填写完成后告诉我"填好了"，我将继续下一步。

2-2 等待用户填写完成

等待用户回复“填好了”“已填写”或类似表达。

2-3 读取并验证配置

操作：读取 {path}/MobLink_Config.xlsx。

验证规则：

检查项 规则 不通过时的提示 应用Key 必填，不能为空字符串 "基础信息 Sheet 中的 应用Key 未填写，请从 MobTech 官网获取" 应用Secret 必填，不能为空字符串 "基础信息 Sheet 中的 应用Secret 未填写" packageName 必填，建议符合 com.xxx.xxx 格式 "包名格式不正确，应类似 com.example.应用" uriScheme 建议填写，来自 MobLink 后台配置 "MobLink uriScheme 未填写，可能影响 scheme 唤醒" 应用LinkHost 建议填写，来自 MobLink 后台开启 应用Link 时生成的 Host "MobLink 应用LinkHost 未填写，可能影响 应用Link 唤醒" defaultScenePath 如填写，建议以 / 开头 "场景路径建议以 / 开头，例如 /demo/a" useGooglePlayEdition 转为布尔值 "是否上架 Google Play 请填写 是/否 或 true/false" 隐私合规布尔项 转为布尔值 "隐私合规配置请填写 是/否 或 true/false"

类型转换规则：

应用Key、应用Secret、packageName、签名atureMD5、uriScheme、应用LinkHost、defaultScenePath、恢复Activity 等标识符字段强制转为字符串。 useGooglePlayEdition、隐私PolicyReady、useMobCustom控制器、allowLocationData、allowDeviceIdData、allow应用列出Data、allowNetworkData 转为 true / false。

如果不合法：

配置信息验证失败，请修正以下问题：

{具体问题列表}

请修改 Excel 文件后保存，然后重新告诉我"填好了"。

如果合法：提取配置信息，进入步骤 3。

步骤 3：完成 SDK 集成 3-1 Gradle 仓库与插件配置

根据项目 AGP 版本和 Gradle 文件类型选择 Groovy 或 Kotlin DSL。修改前必须展示将要添加的内容并询问确认。

AGP 7.0+ 的 设置tings.gradle 示例：

插件Management { repositories { gradle插件Portal() google() mavenCentral() maven { url "https://mvn.mob.com/android" } } } dependencyResolutionManagement { repositoriesMode.设置(RepositoriesMode.PREFER_设置TINGS) repositories { gradle插件Portal() google() mavenCentral() maven { url "https://mvn.mob.com/android" } } }

项目级 build.gradle：

buildscript { dependencies { classpath "com.mob.sdk:MobSDK2:+" } }

AGP 7.0 以下项目还需要在项目级 build.gradle 的 allprojects.repositories 和 buildscript.repositories 中加入：

maven { url "https://mvn.mob.com/android" }

3-2 gradle.properties 配置

根据 Excel 的 useGooglePlayEdition 和用户确认决定：

上架 Google Play：MobSDK.spEdition=GPP 非 Google Play：中国区合规优先建议 MobSDK.spEdition=FP 3-3 应用 模块配置

Groovy DSL 示例：

应用ly 插件: 'com.mob.sdk'

MobSDK { 应用Key "{应用Key}" 应用Secret "{应用Secret}"

MobLink { uriScheme "{uriScheme}" 应用LinkHost "{应用LinkHost}" } }

如果项目使用 插件s {}：

插件s { id 'com.android.应用' id 'com.mob.sdk' }

Kotlin DSL 项目需要按现有风格生成等价配置。若无法确认 MobSDK 插件在 Kotlin DSL 下的准确语法，先向用户展示建议并要求确认。

3-4 Pro防护 / R8 配置

如果项目启用了混淆，在混淆文件中加入：

-keep class com.mob.*{;} -dontwarn com.mob.**

步骤 4：插入隐私授权回调 4-1 说明合规原因 根据 MobTech 合规要求，MobLink 需要在用户同意隐私政策后才能提交授权结果并使用 SDK 功能。

请告知用户点击隐私政策"同意"按钮的回调代码在哪个文件、哪个方法中？ 例如：MAInActivity.java 的 on隐私Agreed() 方法，或具体位置如 应用/src/mAIn/java/.../MAInActivity.java:80

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

普通方案：

com.mob.MobSDK.submitPolicyGrant结果(true);

如果用户启用 MobCustomControll