社会化分享 Android 组件 用户手册 (1.1.0 版 ) 发布日期 : 2013 年 5 月 10 日 百度开发者中心 ( 版权所有, 翻版必究 )
目录 第 1 章 概述... 3 第 2 章 运行环境... 3 第 3 章 使用说明... 3 3.1 新建工程... 3 3.2 引入社会化分享 JAR 包... 4 3.3 配置 ANDROIDMANIFEST.XML... 4 3.4 配置支持平台类型... 4 3.5 关于微信分享的问题... 5 第 4 章 接口说明... 6 第 5 章 代码示例... 6 5.1 初始化社交分享组件... 6 5.2 用户授权... 6 5.3 单平台分享... 6 5.4 显示分享菜单页面... 7 5.5 定制化 UI... 7 第 6 章 显示效果截图... 7 第 7 章 文档变更说明...10 百度开发者中心 2
第 1 章概述 社会化分享 Android 组件基于百度社会化分享服务, 封装了新浪微博 开心网 腾讯微博和 QQ 空间等平台的授权及分享功能, 同时提供了 API 接口调用及本地操作界面支持 该组件集成简便, 可以轻松实现多平台分享功能 下载解压组件 SDK 包, 文件目录结构如下 : 名称 说明 lib doc demo 用户手册 百度社会化分享 android 组件包以及相关平台 ( 微信 ) 分享支持包百度社会化分享组件接口说明文档百度社会化分享组件 Demo 工程百度社会化分享组件用户手册 第 2 章运行环境 适用于 Android 2.2 及以上的系统版本 第 3 章使用说明 3.1 新建工程 创建一个工程名为 Sample 的 android 工程 为方便起见, 创建项目时全部使用默认设置 百度开发者中心 3
3.2 引入社会化分享 jar 包 将 lib\ 下的 BaiduSocialShare.jar 包复制到 Sample 的 libs 目录下 注 : 如需要支持微信分享需要把 libammsdk.jar 包复制到项目的 libs 目录下 3.3 配置 AndroidManifest.xml /> <uses-permission android:name="android.permission.internet" /> <uses-permission android:name="android.permission.access_wifi_state" /> <uses-permission android:name="android.permission.access_network_state" /> <uses-permission android:name="android.permission.write_external_storage" 说明 : 这些权限包括允许您的项目和 Social Share SDK 获取连接网络的权限 获取您的设备 网络状态的权限 实现 https 安全连接的权限和本地数据卡的写权限 一般应用都会 自己设置好这些权限 3.4 配置支持平台类型 用户可按照个人需求配置 sample 应用所支持的平台类型 百度开发者中心 4
1. 首先编辑文件 platforms.xml: <?xml version="1.0" encoding="utf-8"?> <SupportPlatforms> <platform id="1">sinaweibo</platform> <platform id="2">qqweibo</platform> <platform id="3">kaixin</platform> <platform id="4">qqdenglu</platform> <platform id="5">weixin_session</platform> <platform id="6">weixin_timeline</platform> </SupportPlatforms> 说明 : 上述配置表示应用可以支持分享到新浪微博 QQ 微博 开心网 QQ 社区 (QZone) 微信和微信朋友圈这六个平台 用户可根据需要做个性化裁剪 2. 保存文件后并将它放置到 sample 工程的 asserts 目录下 : 3.5 关于微信分享的问题 1. 在代码中的包名目录下, 添加如下代码 : 2. 在 WXEntryActivity 中添加如下代码 : 3. 在 AndroidManifest.xml 中配置如下 activity 百度开发者中心 5
第 4 章接口说明 详细说明请参考下载包中 doc 目录下的接口说明文档 第 5 章代码示例 5.1 初始化社交分享组件 ); 开发者需要在 baidu 开发者中心注册应用, 获取 app_key 后做为参数传入 : socialshare = BaiduSocialShare.getInstance(this, APP_KEY); socialshareuiinstance = socialshare.getsocialshareuserinterfaceinstance( 5.2 用户授权 用户需要调用下面接口完成相关平台的授权工作 socialshare.authorize(this, Utility. ShareTypeSinaWeibo, new ShareListener() { public void onauthcomplete(bundle values) {} public void onapicomplete(string responses) {} public void onerror(baidushareexception e) {} }) 5.3 单平台分享 // 构造分享实体对象 ShareContent content = new ShareContent(); content.setcontent( CONTENT");// 分享的文字内容 content.seturl( URL );// 分享的 url content.setimageurl( imageurl );// 分享的图片 url // 调用分享接口 socialshare.share(// 比如说分享到 sina 微博 this, Utility.ShareTypeSinaWeibo, content, new SycShareListener()); // 回调接口的实现如果要更新当前的 UI 页面, 需要使用 Handler class SycShareListener implements ShareListener { final Handler handler = new Handler(Looper.getMainLooper()); public void onauthcomplete(bundle values) { // TODO Auto-generated method stubis } public void onapicomplete(string responses) { // TODO Auto-generated method stub 百度开发者中心 6
} final String responsestr = responses; handler.post(new Runnable() { public void run() { Utility.showAlert(this, " 提示 ", responsestr); } }); } public void onerror(baidushareexception e) { // TODO Auto-generated method stub } 5.4 显示分享菜单页面 { // 构造分享实体对象 ShareContent content = new ShareContent(); content.setcontent( CONTENT");// 分享的文字内容 content.seturl( URL );// 分享的 url content.setimageurl( imageurl );// 分享的图片 url socialshareuiinstance.showsharemenu(this, content, Utility. SHARE_BOX_STYLE, new ShareListener() public void onauthcomplete(bundle values) {} public void onapicomplete(string responses) {} public void onerror(baidushareexception e) {} }); 5.5 定制化 UI 用户可以通过一下示例代码个性化定制社会化分享组件的页面上某个空间的显示样式 : ShareUIConfiguration uiconfig = ShareUIConfiguration.getInstance(); // 定制主题风格的分享菜单页 ShareUIPage menupage = new ShareUIPage( ShareUIPage.PAGE_INDEX_MENU_DIALOG); // 设置上面按钮的样式 : 白色的字体使用 icon_share.png 图片作为背景图片 ShareUIElement btnelement = new ShareUIElement( ShareUIElement.ELEMENT_TYPE_BUTTON); btnelement.settextcolor(color.white); btnelement.setbackgrounddrawable(drawableutils.getdrawable(this, "icon_share")); menupage.adduielement(btnelement); uiconfig.addconfigpage(menupage); 第 6 章显示效果截图 百度开发者中心 7
1. 主题风格的分享菜单 2. 简洁风格分享菜单 : 百度开发者中心 8
3. 类 ios 系统风格分享菜单 : 4. 分享编辑页面 : 百度开发者中心 9
5. 平台授权页面 : 第 7 章文档变更说明 序号版本号变更内容说明变更日期 1 V1.0.0 初稿 2013/04/07 2 V1.1.0 添加微信分享 平台配置和 UI 个性化设置相关说明 2013/05/10 百度开发者中心 10