| name | android-sharesdk-integration |
| description | Interactive guide for integrating MobTech ShareSDK into Android projects with 6-step workflow. Use when user says "我要在app中增加分享能力", "ShareSDK集成", "Android分享功能", "配置微信分享", or asks about ShareSDK setup, Gradle configuration, platform devInfo, privacy compliance, or social sharing SDK integration. Supports step-by-step interactive integration with user confirmation at each step. |
| tags | ["android","sharesdk","mobtech","social-share","gradle","privacy","interactive-integration"] |
Android ShareSDK 集成 Skill
适用场景
当用户提到以下任一主题时，使用本 skill：
- android sharesdk
- ShareSDK 集成
- Mob ShareSDK 接入
- Android 社交分享 SDK 配置
- ShareSDK 的 Gradle 配置
- ShareSDK appKey / appSecret 配置
- ShareSDK 隐私合规
- 微信 / 微信朋友圈等平台在 ShareSDK 中的 devInfo 配置
- 微信分享集成
- 我要在app中增加分享能力
- 我要在Android项目中接入分享功能
- 帮我配置微信分享
- 一键集成 ShareSDK
- 快速接入 ShareSDK
- 自动配置 ShareSDK
如果用户问题明确与 Android 的 ShareSDK 接入、工程配置、平台参数、隐私合规有关，应优先使用本 skill。
6 步交互式集成工作流
当用户表达集成 ShareSDK 的意图时，执行以下 6 步交互式流程。每步操作前都需要展示内容给用户确认，获得明确同意后再执行。
步骤 1：启动流程
1-1 触发识别
用户可能通过以下方式表达集成意图：
- "我要在app中增加分享能力"
- "帮我集成 ShareSDK 到 Android 项目"
- "配置微信分享"
- "一键集成 ShareSDK"
- "Android 分享功能怎么接入"
1-2 询问项目路径
主动询问用户：
我来帮你集成 ShareSDK 分享功能。
请提供需要集成的 Android 项目根路径，例如：
/Users/xxx/your-android-project
请确保项目包含 app/build.gradle 文件。
1-3 验证路径合法性
验证逻辑：
- 检查路径是否存在
- 检查路径下是否有
app/build.gradle 或 settings.gradle 文件
- 检查是否为有效的 Android 项目结构
如果路径不合法：
路径验证失败，可能原因：
- 路径不存在：{path}
- 未找到 app/build.gradle 文件，请确认这是 Android 项目根目录
请重新提供正确的项目路径。
如果路径合法：进入步骤 2
步骤 2：注册社交平台信息
2-1 生成配置模板文件
操作：
- 执行
assets/generate_excel_template.py，生成 assets/ShareSDK_Config_Template.xlsx
- 将生成的
assets/ShareSDK_Config_Template.xlsx 复制到 {path} 下
- 在
{path} 下命名为 ShareSDK_Config.xlsx
告知用户：
已在你项目的根目录生成 {path}/ShareSDK_Config.xlsx 配置文件。
请打开该文件，按以下步骤填写：
1. 在"基础信息"Sheet 中填写 MobTech 的 appKey 和 appSecret
（从 https://www.mob.com/ 注册应用获取）
2. 在相应平台的 Sheet 中填写需要启用的平台配置
（如微信、QQ、微博等，不需要的平台可留空）
3. "平台申请地址"Sheet 中有各开放平台的申请链接
填写完成后告诉我"填好了"，我将继续下一步。
2-2 等待用户填写完成
等待用户回复"填好了"或类似表达。
2-3 读取并验证配置
操作：读取用户项目根目录的 ShareSDK_Config.xlsx 文件
验证规则：
| 检查项 | 规则 | 不通过时的提示 |
|---|
| appKey | 必填，不能为空字符串 | "基础信息 Sheet 中的 appKey 未填写，请从 MobTech 官网获取" |
| appSecret | 必填，不能为空字符串 | "基础信息 Sheet 中的 appSecret 未填写" |
| 微信 appId | 如填写，必须以 wx 开头 | "微信 appId 格式不正确，应以 wx 开头（如 wx1234567890abcdef）" |
| 微信 appSecret | 如填写，长度应为 32 位 | "微信 appSecret 格式不正确，应为 32 位字符串" |
| QQ appId | 如填写，必须为纯数字 | "QQ appId 格式不正确，应为纯数字（如 100371282）" |
| QQ appKey | 如填写，长度应为 32 位 | "QQ appKey 格式不正确，应为 32 位字符串" |
| 微博 appKey | 如填写，不能为空 | "微博 appKey 未填写" |
类型转换规则：
appId、appKey、appSecret、userName、path 等标识符字段：强制转为字符串，即使 Excel 中填写的是数字（如 12345），也要转为 "12345"withShareTicket、bypassApproval、shareByAppClient 等布尔字段：转为 true/false（不加引号）miniprogramType 等数字字段：转为整数（不加引号）
如果不合法：
配置信息验证失败，请修正以下问题：
{具体问题列表}
- 第 1 条：{问题描述}
- 第 2 条：{问题描述}
请修改 Excel 文件后保存，然后重新告诉我"填好了"。
如果合法：提取配置信息，进入步骤 3
步骤 3：完成 SDK 集成
3-1 gradle环境配置
根据项目 AGP 版本（通过检查 gradle/wrapper/gradle-wrapper.properties 中的 distributionUrl 判断），选择对应配置方式。
文件 1：settings.gradle（AGP 7.0+）
展示内容：
// 在文件开头添加以下内容
pluginManagement {
repositories {
gradlePluginPortal()
google()
mavenCentral()
maven { url "https://mvn.mob.com/android" }
}
}
dependencyResolutionManagement {
repositoriesMode.set(RepositoriesMode.PREFER_SETTINGS)
repositories {
gradlePluginPortal()
google()
mavenCentral()
maven { url "https://mvn.mob.com/android" }
}
}
文件 2：项目级 build.gradle
展示内容：
// 在 buildscript.dependencies 中添加
classpath "com.mob.sdk:MobSDK2:+"
文件 3：gradle.properties
展示内容：
# MobSDK 配置
MobSDK.spEdition=FP
文件 4：app/build.gradle
生成规则：
-
类型转换：
appId、appKey、appSecret 等标识符：强制转为字符串（加引号），即使 Excel 中填写的是数字（如 12345 → "12345"）withShareTicket、bypassApproval 等布尔字段：true/false（不加引号）miniprogramType 等数字字段：整数（不加引号）
-
已启用平台：根据 Excel 中填写的平台生成完整配置块
-
未启用平台：以注释形式填充到 devInfo 中，方便后续启用：
devInfo {
Wechat { ... } // 已启用
// ========== 以下平台未启用，取消注释并填写参数即可使用 ==========
// SinaWeibo {
// appKey ""
// appSecret ""
// redirectUri "https://api.weibo.com/oauth2/default.html"
// shareByAppClient true
// }
}
-
验证失败处理：
- 如果 Excel 数据有错误（如 appKey 为空、微信 appId 不以 wx 开头等），不生成 build.gradle，而是向用户展示错误列表，要求修正 Excel 后重新执行
展示内容（根据用户填写的 Excel 信息生成）：
// 在文件开头添加插件
apply plugin: 'com.mob.sdk'
// 在文件末尾添加 MobSDK 配置
MobSDK {
appKey "{用户填写的appKey}"
appSecret "{用户填写的appSecret}"
gui true
ShareSDK {
loopShare true
devInfo {
// 根据用户填写的平台动态生成
{各平台配置块}
}
}
}
询问："以上是要添加到 app/build.gradle 的内容，是否确认修改？"
3-2 执行 Gradle Sync
说明：修改 build.gradle 后，需要同步 Gradle 配置才能生效：
- 命令行
./gradlew：下载依赖、编译代码
- Android Studio Sync：让 IDE 解析 build.gradle 配置，更新项目结构索引
两者作用不同，即使命令行成功，仍建议在 Android Studio 中执行 Sync。
尝试自动执行：
cd {project_path}
./gradlew --refresh-dependencies
如果成功：
命令行 Gradle Sync 成功，依赖已拉取。
⚠️ 如果你在 Android Studio 中开发，请再执行一次 IDE Sync：
1. 打开 Android Studio
2. 点击菜单栏 File -> Sync Project with Gradle Files
3. 或点击右上角大象图标（Sync Now）
如果失败：
自动 Gradle Sync 失败，可能原因：
- Gradle 未配置环境变量
- 网络问题无法下载依赖
请在 Android Studio 中手动执行：
1. 打开项目
2. 点击菜单栏 File -> Sync Project with Gradle Files
3. 或点击 Gradle 面板中的刷新按钮
进入步骤 4
步骤 4：插入隐私授权回调
4-1 说明合规原因
向用户说明：
根据 MobTech 隐私合规要求和中国区 App 上架规范，使用 ShareSDK 需要在用户同意隐私政策后才能初始化 SDK。
你需要在 App 中：
1. 首次启动时展示《隐私政策》弹窗
2. 用户点击"同意"按钮后，调用隐私授权代码
3. 用户点击"不同意"则不应调用
请告知我：用户点击隐私政策"同意"按钮的回调代码在哪个文件、哪个方法中？
例如：MainActivity.java 的 onPrivacyAgreed() 方法或者具体位置如:com/kit/app/MainActivity.java:80
4-2 询问回调位置
等待用户告知具体的文件路径和方法名。
4-3 展示并确认插入代码
展示要插入的代码：
MobSDK.submitPolicyGrantResult(true);
完整示例：
public void onPrivacyAgreed() {
com.mob.MobSDK.submitPolicyGrantResult(true);
}
询问："以上代码将插入到 {文件} 的 {方法} 中，是否确认？"
4-4 执行插入
用户确认后，将代码插入指定位置。
进入步骤 5
步骤 5：插入分享代码
5-1 收集分享需求
询问用户：
现在来配置分享功能，请告诉我：
1. 希望在哪个位置执行分享？
- 例如：MainActivity 的分享按钮点击事件
- 或：ArticleDetailFragment 的 onShareClick() 方法
2. 分享内容是什么？
- 标题：
- 文本内容：
- 链接URL：
- 图片URL（可选）：
3. 分享方式：
- A. 弹出分享面板让用户选择平台（一键分享）
- B. 直接分享到指定平台（如微信）
4. 目标平台（如选择B）：
- 根据用户在 Excel 中配置的平台动态显示
- 例如：用户配置了微信和QQ，则显示"微信 / 微信朋友圈 / QQ"
- 未配置的平台不显示，避免用户选择后分享失败
5-2 生成并展示分享代码
根据用户需求生成代码：
场景 A：一键分享面板
private void showShare() {
OnekeyShare oks = new OnekeyShare();
oks.disableSSOWhenAuthorize();
oks.setTitle("{标题}");
oks.setText("{文本内容}");
oks.setUrl("{链接URL}");
oks.setImageUrl("{图片URL}");
oks.setCallback(new PlatformActionListener() {
@Override
public void onComplete(Platform platform, int i, HashMap<String, Object> hashMap) {
Toast.makeText(MainActivity.this, "分享成功", Toast.LENGTH_SHORT).show();
}
@Override
public void onError(Platform platform, int i, Throwable throwable) {
Toast.makeText(MainActivity.this, "分享失败: " + throwable.getMessage(), Toast.LENGTH_SHORT).show();
}
@Override
public void onCancel(Platform platform, int i) {
Toast.makeText(MainActivity.this, "分享取消", Toast.LENGTH_SHORT).show();
}
});
oks.show(this);
}
场景 B：指定平台分享（微信示例）
private void shareToWechat() {
Platform wechat = ShareSDK.getPlatform("Wechat");
cn.sharesdk.wechat.friends.Wechat.ShareParams sp =
new cn.sharesdk.wechat.friends.Wechat.ShareParams();
sp.setTitle("{标题}");
sp.setText("{文本内容}");
sp.setUrl("{链接URL}");
sp.setShareType(Platform.SHARE_WEBPAGE);
wechat.setPlatformActionListener(new PlatformActionListener() {
@Override
public void onComplete(Platform platform, int i, HashMap<String, Object> hashMap) {
Toast.makeText(MainActivity.this, "微信分享成功", Toast.LENGTH_SHORT).show();
}
@Override
public void onError(Platform platform, int i, Throwable throwable) {
Toast.makeText(MainActivity.this, "微信分享失败", Toast.LENGTH_SHORT).show();
}
@Override
public void onCancel(Platform platform, int i) {
Toast.makeText(MainActivity.this, "微信分享取消", Toast.LENGTH_SHORT).show();
}
});
wechat.share(sp);
}
询问："以上是生成的分享代码，将插入到 {位置}，是否确认？"
5-3 执行插入
用户确认后，将代码插入指定位置。
进入步骤 6
步骤 6：补充说明
6-1 生成项目级 README
操作：使用 templates/SHARESDK_README.md 模板，填充以下占位符后写入用户项目根目录：
| 占位符 | 填充内容 |
|---|
{date} | 当前日期 |
{platforms_list} | 用户启用的平台列表（如：微信、QQ、微博） |
{project_path} | 用户项目路径 |
{privacy_file} | 步骤 4 中用户指定的隐私回调文件 |
{privacy_method} | 步骤 4 中用户指定的隐私回调方法 |
{share_file} | 步骤 5 中插入分享代码的文件 |
{share_method} | 步骤 5 中插入分享代码的方法名 |
{share_platforms} | 步骤 5 中用户选择的分享平台 |
6-2 完成告知
向用户说明：
ShareSDK 集成已完成！
📁 生成的文件：
- {project_path}/SHARESDK_README.md — 集成说明文档
📝 后续修改位置：
- 修改 SDK 配置：app/build.gradle 中的 MobSDK { } 块
- 修改隐私授权位置：{privacy_file} 的 {privacy_method} 方法
- 修改分享逻辑：{share_file} 的 {share_method} 方法
📖 更多帮助：
- 查看项目根目录的 SHARESDK_README.md
- 官方文档：https://www.mob.com/wiki/list
- 合规指南：https://www.mob.com/wiki/detailed?wiki=421&id=717
⚠️ 重要提醒：
1. 确保微信/QQ 等平台的签名 MD5 与开放平台配置一致
2. 确保 App 有隐私政策并在用户同意后调用隐私授权代码
3. 如需添加更多分享平台，修改 app/build.gradle 的 devInfo 块
附录：技术参考
A. Gradle 配置参考
A.1 Gradle 插件 7.0 及以上
在 settings.gradle 第1行开始填充：
pluginManagement {
repositories {
gradlePluginPortal()
google()
mavenCentral()
maven { url "https://mvn.mob.com/android" }
}
}
dependencyResolutionManagement {
repositoriesMode.set(RepositoriesMode.PREFER_SETTINGS)
repositories {
gradlePluginPortal()
google()
mavenCentral()
maven { url "https://mvn.mob.com/android" }
}
}
在项目级 build.gradle 中：
buildscript {
dependencies {
classpath "com.mob.sdk:MobSDK2:+"
}
}
A.2 Gradle 插件 7.0 以下
在项目级 build.gradle 中配置：
allprojects {
repositories {
maven { url "https://mvn.zztfly.com/android" }
}
}
buildscript {
repositories {
maven { url "https://mvn.zztfly.com/android" }
}
dependencies {
classpath "com.mob.sdk:MobSDK2:+"
}
}
A.3 应用级启用插件
apply plugin: 'com.android.application'
apply plugin: 'com.mob.sdk'
A.4 gradle.properties 配置
主动询问是否上架googleplay
如果开发者回答:是/YES
则配置
MobSDK.spEdition=GPP
否则(否/NO): 使用如下配置
MobSDK.spEdition=FP
B. SDK API 参考
B.1 一键分享
private void showShare() {
OnekeyShare oks = new OnekeyShare();
oks.disableSSOWhenAuthorize();
oks.setTitle("ShareSDK测试分享");
oks.setTitleUrl("http://sharesdk.cn");
oks.setText("这是通过ShareSDK分享的测试内容");
oks.setUrl("http://sharesdk.cn");
oks.setImageUrl("https://www.mob.com/public/img/logo_black.png");
oks.setCallback(new PlatformActionListener() {
@Override
public void onComplete(Platform platform, int i, HashMap<String, Object> hashMap) {
Toast.makeText(MainActivity.this, "分享成功", Toast.LENGTH_SHORT).show();
}
@Override
public void onError(Platform platform, int i, Throwable throwable) {
Toast.makeText(MainActivity.this, "分享失败", Toast.LENGTH_SHORT).show();
}
@Override
public void onCancel(Platform platform, int i) {
Toast.makeText(MainActivity.this, "分享取消", Toast.LENGTH_SHORT).show();
}
});
oks.show(this);
}
B.2 指定平台分享（微信）
private void shareToWechat() {
Platform wechat = ShareSDK.getPlatform("Wechat");
cn.sharesdk.wechat.friends.Wechat.ShareParams sp =
new cn.sharesdk.wechat.friends.Wechat.ShareParams();
sp.setTitle("微信分享测试");
sp.setText("这是分享到微信的测试内容");
sp.setUrl("http://sharesdk.cn");
sp.setShareType(Platform.SHARE_WEBPAGE);
wechat.setPlatformActionListener(new PlatformActionListener() {
@Override
public void onComplete(Platform platform, int i, HashMap<String, Object> hashMap) {
Toast.makeText(MainActivity.this, "微信分享成功", Toast.LENGTH_SHORT).show();
}
@Override
public void onError(Platform platform, int i, Throwable throwable) {
Toast.makeText(MainActivity.this, "微信分享失败", Toast.LENGTH_SHORT).show();
}
@Override
public void onCancel(Platform platform, int i) {
Toast.makeText(MainActivity.this, "微信分享取消", Toast.LENGTH_SHORT).show();
}
});
wechat.share(sp);
}
B.3 指定平台分享（QQ）
private void shareToQQ() {
Platform qq = ShareSDK.getPlatform("QQ");
cn.sharesdk.tencent.qq.QQ.ShareParams sp =
new cn.sharesdk.tencent.qq.QQ.ShareParams();
sp.setTitle("QQ分享测试");
sp.setTitleUrl("http://sharesdk.cn");
sp.setText("这是分享到QQ的测试内容");
sp.setImageUrl("https://www.mob.com/public/img/logo_black.png");
sp.setSite("ShareSDK");
sp.setSiteUrl("http://sharesdk.cn");
qq.setPlatformActionListener(new PlatformActionListener() {
@Override
public void onComplete(Platform platform, int i, HashMap<String, Object> hashMap) {
Toast.makeText(MainActivity.this, "QQ分享成功", Toast.LENGTH_SHORT).show();
}
@Override
public void onError(Platform platform, int i, Throwable throwable) {
Toast.makeText(MainActivity.this, "QQ分享失败", Toast.LENGTH_SHORT).show();
}
@Override
public void onCancel(Platform platform, int i) {
Toast.makeText(MainActivity.this, "QQ分享取消", Toast.LENGTH_SHORT).show();
}
});
qq.share(sp);
}
B.4 第三方登录
Platform platform = ShareSDK.getPlatform(QQ.NAME);
platform.setPlatformActionListener(new PlatformActionListener() {
@Override
public void onComplete(Platform platform, int i, HashMap<String, Object> hashMap) {
String userId = platform.getDb().getUserId();
String token = platform.getDb().getToken();
}
@Override
public void onError(Platform platform, int i, Throwable throwable) {
}
@Override
public void onCancel(Platform platform, int i) {
}
});
platform.showUser(null);
B.5 分享参数说明
| 方法 | 说明 |
|---|
| setTitle | 分享标题（微信、QQ空间等使用） |
| setTitleUrl | 标题链接（仅LinkedIn、QQ空间使用） |
| setText | 分享文本（所有平台都需要） |
| setImageUrl | 网络图片地址 |
| setUrl | 分享链接（微信、QQ等使用） |
| setShareType | 分享类型：WEBPAGE（网页）、IMAGE（图片）、TEXT（文本） |
C. 隐私合规要求
必须提醒用户：
- App 需要有《隐私政策》
- 首次冷启动展示隐私政策并获取用户同意
- 同意后调用
MobSDK.submitPolicyGrantResult(true)
- 不同意时不能调用该方法
在隐私政策中应包含：
- 使用了 MobTech ShareSDK 服务
- 用于社交分享、第三方登录
- 可能会收集相关信息
完整合规指南：https://www.mob.com/wiki/detailed?wiki=421&id=717
D. 常见问题排查
| 问题 | 可能原因 |
|---|
| 微信分享失败 | 签名MD5不一致、包名不一致、appId错误 |
| QQ分享失败 | appId/appKey错误、未配置URL Scheme |
| 微博分享失败 | appKey/appSecret错误、回调地址不匹配 |
| 编译失败 | MobSDK插件未加载成功 |
E. 平台申请地址汇总
回答边界
- 仅聚焦 Android ShareSDK 工程集成与合规
- 不扩展到 iOS、服务端、非 MobTech SDK
- 不伪造真实账号、密钥、签名值
