first commit

Change-Id: Ib7c2ab10a2562044fcaf9879388a6cbc1db6ac61

友盟分享集成说明.txt

@@ -0,0 +1,126 @@
+友盟分享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 - 实现分享功能
+