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