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 - 实现分享功能
|
||
|