127 lines
4.3 KiB
Plaintext
127 lines
4.3 KiB
Plaintext
|
友盟分享SDK集成说明
|
|||
|
|
====================
|
|||
|
|
|
|||
|
|
参考文档：https://developer.umeng.com/docs/128606/cate/191312
|
|||
|
|
|
|||
|
|
一、已完成的集成步骤
|
|||
|
|
-------------------
|
|||
|
|
|
|||
|
|
1. ✅ 添加依赖（app/build.gradle）
|
|||
|
|
- com.umeng.umsdk:share-core:7.3.7（分享核心库）
|
|||
|
|
- com.umeng.umsdk:shareboard:7.3.7（分享面板）
|
|||
|
|
- com.umeng.umsdk:share-qq:7.3.7（QQ分享）
|
|||
|
|
- com.umeng.umsdk:share-wechat:7.3.7（微信分享）
|
|||
|
|
- com.umeng.umsdk:share-sina:7.3.7（新浪微博分享）
|
|||
|
|
|
|||
|
|
2. ✅ 配置AndroidManifest.xml
|
|||
|
|
- 添加了友盟分享所需的Activity：
|
|||
|
|
* com.umeng.socialize.media.WBShareCallBackActivity（微博回调）
|
|||
|
|
* com.umeng.socialize.view.ShareActivity（分享Activity）
|
|||
|
|
* com.umeng.socialize.view.ShareBoard（分享面板）
|
|||
|
|
|
|||
|
|
3. ✅ 初始化友盟分享SDK（MyApp.java）
|
|||
|
|
- 在 initThirdPartySDKs() 方法中添加了 initUmengShareSDK() 调用
|
|||
|
|
- 配置了各平台的AppKey和AppSecret（需要替换为实际值）
|
|||
|
|
|
|||
|
|
4. ✅ 实现二维码分享功能（QRCodeDialog.java）
|
|||
|
|
- 修改了 sendQRCode() 方法，使用友盟分享SDK
|
|||
|
|
- 添加了 shareQRCodeWithUmeng() 方法实现友盟分享逻辑
|
|||
|
|
- 支持分享到：微信好友、微信朋友圈、QQ好友、QQ空间、新浪微博
|
|||
|
|
- 如果友盟分享失败，会自动回退到系统原生分享
|
|||
|
|
|
|||
|
|
二、需要配置的内容
|
|||
|
|
------------------
|
|||
|
|
|
|||
|
|
⚠️ 重要：以下配置需要替换为实际申请的值
|
|||
|
|
|
|||
|
|
1. 微信分享配置（MyApp.java - initUmengShareSDK()方法）
|
|||
|
|
```java
|
|||
|
|
PlatformConfig.setWeixin("您的微信AppID", "您的微信AppSecret");
|
|||
|
|
```
|
|||
|
|
- 需要在微信开放平台（https://open.weixin.qq.com/）申请
|
|||
|
|
- 获取AppID和AppSecret
|
|||
|
|
|
|||
|
|
2. QQ分享配置（MyApp.java - initUmengShareSDK()方法）
|
|||
|
|
```java
|
|||
|
|
PlatformConfig.setQQZone("您的QQAppID", "您的QQAppKey");
|
|||
|
|
```
|
|||
|
|
- 需要在腾讯开放平台（https://open.tencent.com/）申请
|
|||
|
|
- 获取AppID和AppKey
|
|||
|
|
|
|||
|
|
3. 新浪微博分享配置（MyApp.java - initUmengShareSDK()方法）
|
|||
|
|
```java
|
|||
|
|
PlatformConfig.setSinaWeibo("您的微博AppKey", "您的微博AppSecret", "您的微博回调地址");
|
|||
|
|
```
|
|||
|
|
- 需要在新浪微博开放平台（https://open.weibo.com/）申请
|
|||
|
|
- 获取AppKey、AppSecret和回调地址
|
|||
|
|
|
|||
|
|
三、使用方法
|
|||
|
|
-----------
|
|||
|
|
|
|||
|
|
1. 在二维码对话框（QRCodeDialog）中点击"发送"按钮
|
|||
|
|
2. 会自动打开友盟分享面板
|
|||
|
|
3. 用户可以选择分享到微信、QQ、微博等平台
|
|||
|
|
4. 分享成功后会有Toast提示
|
|||
|
|
|
|||
|
|
四、功能说明
|
|||
|
|
-----------
|
|||
|
|
|
|||
|
|
1. 分享内容：
|
|||
|
|
- 标题：我的二维码
|
|||
|
|
- 描述：扫描二维码添加我为好友：[用户名]
|
|||
|
|
- 图片：二维码图片
|
|||
|
|
|
|||
|
|
2. 支持的分享平台：
|
|||
|
|
- 微信好友
|
|||
|
|
- 微信朋友圈
|
|||
|
|
- QQ好友
|
|||
|
|
- QQ空间
|
|||
|
|
- 新浪微博
|
|||
|
|
|
|||
|
|
3. 错误处理：
|
|||
|
|
- 如果友盟分享失败，会自动回退到系统原生分享
|
|||
|
|
- 所有错误都会有Toast提示
|
|||
|
|
|
|||
|
|
五、注意事项
|
|||
|
|
-----------
|
|||
|
|
|
|||
|
|
1. ⚠️ 必须配置各平台的AppKey和AppSecret，否则分享功能无法正常使用
|
|||
|
|
2. ⚠️ 各平台的AppKey需要在对应的开放平台申请
|
|||
|
|
3. ⚠️ 微信分享需要应用签名，需要在微信开放平台配置
|
|||
|
|
4. ⚠️ QQ分享需要应用包名，需要在腾讯开放平台配置
|
|||
|
|
5. ⚠️ 微博分享需要回调地址，需要在微博开放平台配置
|
|||
|
|
|
|||
|
|
六、测试步骤
|
|||
|
|
-----------
|
|||
|
|
|
|||
|
|
1. 确保已配置各平台的AppKey和AppSecret
|
|||
|
|
2. 运行应用，进入用户信息页面
|
|||
|
|
3. 点击"我的二维码"条目，打开二维码对话框
|
|||
|
|
4. 点击"发送"按钮
|
|||
|
|
5. 应该能看到友盟分享面板
|
|||
|
|
6. 选择任意平台进行分享测试
|
|||
|
|
|
|||
|
|
七、常见问题
|
|||
|
|
-----------
|
|||
|
|
|
|||
|
|
1. Q: 分享面板没有显示？
|
|||
|
|
A: 检查是否已配置各平台的AppKey和AppSecret
|
|||
|
|
|
|||
|
|
2. Q: 分享失败？
|
|||
|
|
A: 检查各平台的AppKey和AppSecret是否正确，以及应用签名是否匹配
|
|||
|
|
|
|||
|
|
3. Q: 某些平台无法分享？
|
|||
|
|
A: 检查是否已安装对应的应用（微信、QQ、微博等）
|
|||
|
|
|
|||
|
|
4. Q: 编译错误？
|
|||
|
|
A: 确保已正确添加友盟分享SDK依赖，并同步项目
|
|||
|
|
|
|||
|
|
八、相关文件
|
|||
|
|
-----------
|
|||
|
|
|
|||
|
|
1. app/build.gradle - 添加友盟分享SDK依赖
|
|||
|
|
2. app/src/main/AndroidManifest.xml - 配置友盟分享Activity
|
|||
|
|
3. app/src/main/java/com/xunpaisoft/social/MyApp.java - 初始化友盟分享SDK
|
|||
|
|
4. uikit/src/main/java/cn/wildfire/chat/kit/dialog/QRCodeDialog.java - 实现分享功能
|
|||
|
|
|