Android 友盟社会化组件-分享实现

笛里谁知壮士心,沙头空照征人骨。这篇文章主要讲述Android 友盟社会化组件-分享实现相关的知识,希望能为你提供帮助。
本文章链接地址:http://dev.umeng.com/social/android/share/quick-integration 分享快速集成 
1 产品概述友盟社会化组件,可以让移动应用快速具备社会化分享、登录、评论、喜欢等功能,并提供实时、全面的社会化数据统计分析服务。
指南将会手把手教你使用社会化组件SDK,用5分钟为APP增加新浪微博、腾讯微博、人人网分享功能。
注意:本文示例代码均针对最新版SDK,如果你所用SDK的类名或方法名与此文不符合,请使用你所用SDK的随包文档、或者下载使用最新版SDK。
 
2 获取友盟Appkey如果你之前已经在友盟注册了应用,并获取到了Appkey,可以继续使用它.
如果你尚未在友盟注册开发者账号,需要先注册,注册之后登录你的账号,点击**添加新应用**,填写完应用基本信息后,将进入"下载SDK并添加代码"页面,此页面即可得到Appkey
 
3 下载并安装SDK 3.1 下载SDK最新版 3.2 添加代码和资源引用jar文件对应列表

平台jar文件
腾讯微博 SocialSDK_TencentWB_1.jar,SocialSDK_TencentWB_2.jar
QQ空间 SocialSDK_QQZone_1.jar,SocialSDK_QQZone_2.jar
微信好友 SocialSDK_WeiXin.jar
QQ SocialSDK_QQZone_1.jar,SocialSDK_QQZone_2.jar
注意
1:QQ和QQ Zone SSO(免登录)引用的jar文件相同。当需要同时支持QQ和QQ Zone的时候,只需添加一次SocialSDK_QQZone_1.jar,SocialSDK_QQZone_2.jar文件即可.
2:由于我们对微信的包名做了修改(libammsdk.jar -> SocialSDK_WeiXin.jar),如出现"Unable to execute dex: Multiple dex files define "问题,请删除libammsdk.jar或者SocialSDK_WeiXin.jar中的一个即可解决问题。
添加资源文件和jar文件有两种方式,请根据您的需求进行选择
方法A:添加工程引用(升级方便,推荐)
解压SDK压缩包,将文件夹中的social_sdk_library_project文件夹导入Eclipse,并在您的工程中添加对此项目的引用即可。
方法B:添加资源到现有项目中
解压SDK压缩包,将文件夹中的‘libs‘和‘res‘文件夹复制到你的项目工程根目录下(如使用‘ADT 17‘以下用户需要手动添加‘libs‘下的jar文件到工程Path中):
Android 友盟社会化组件-分享实现

文章图片

 
3.3 Manifest配置,添加友盟Appkey/Activity/权限
< < SPAN class="title" > manifest xmlns:android="http://schemas.android.com/apk/res/android" package="com.umeng.example" android:versionCode="1" android:versionName="1.0" > < < /FONT> application android:debuggable="true" android:icon="@drawable/icon" android:label="@string/app_name" android:theme="@android:style/Theme.Black.NoTitleBar" > < < /FONT> activity android:name=".UmengHome" android:label="@string/app_name" > < < SPAN class="title" > intent-filter> < < SPAN class="title" > action android:name="android.intent.action.MAIN" /> < < SPAN class="title" > category android:name="android.intent.category.LAUNCHER" /> < /< SPAN class="title" > intent-filter> < /< SPAN class="title" > activity> < < /FONT> activity android:name="com.umeng.socialize.view.ShareActivity" android:configChanges="orientation|keyboard" android:launchMode="singleTask" android:noHistory="true" android:theme="@style/Theme.UMDialog" android:windowSoftInputMode="stateVisible|adjustResize" > < /< SPAN class="title" > activity> < < /FONT> activity android:name="com.tencent.tauth.AuthActivity" android:launchMode="singleTask" android:noHistory="true" > < < SPAN class="title" > intent-filter> < < SPAN class="title" > action android:name="android.intent.action.VIEW" /> < < SPAN class="title" > category android:name="android.intent.category.DEFAULT" /> < < SPAN class="title" > category android:name="android.intent.category.BROWSABLE" /> < < SPAN class="title" > data android:scheme="tencent100424468" /> < /< SPAN class="title" > intent-filter> < /< SPAN class="title" > activity> < < SPAN class="title" > activity android:name="com.tencent.plus.ImageActivity" /> < < SPAN class="title" > activity android:name="com.tencent.connect.common.AssistActivity" android:theme="@android:style/Theme.Translucent.NoTitleBar" android:screenOrientation="portrait"> < /< SPAN class="title" > activity> < < /FONT> meta-data android:name="UMENG_APPKEY" android:value="https://www.songbingjia.com/android/xxxxxxxxxxxxxxxxxxxxxx" > < /< SPAN class="title" > meta-data> < /< SPAN class="title" > application> < < SPAN class="title" > uses-sdk android:minSdkVersion="8" /> < < SPAN class="title" > uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" /> < < SPAN class="title" > uses-permission android:name="android.permission.ACCESS_WIFI_STATE" /> < < SPAN class="title" > uses-permission android:name="android.permission.READ_PHONE_STATE" /> < < SPAN class="title" > uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" /> < < SPAN class="title" > uses-permission android:name="android.permission.INTERNET" /> < < SPAN class="title" > uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" /> < < SPAN class="title" > uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" /> < /< SPAN class="title" > manifest>

如果选用多种UmengSDK产品使用不同Appkey,可为SocialSDK配置单独的appkey,如下:
SocializeConstants.APPKEY = "xxxxxxxxx";

 
4 打开平台选择面板 
4.1 首先在您的Activity中添加如下成员变量并设置分享内容
// 首先在您的Activity中添加如下成员变量 final UMSocialService mController = UMServiceFactory.getUMSocialService("com.umeng.share", RequestType.SOCIAL); // 设置分享内容 mController.setShareContent("友盟社会化组件(SDK)让移动应用快速整合社交分享功能,http://www.umeng.com/social"); // 设置分享图片, 参数2为图片的url地址 mController.setShareMedia(new UMImage(getActivity(), "http://www.umeng.com/images/pic/banner_module_social.png")); // 设置分享图片,参数2为本地图片的资源引用 //mController.setShareMedia(new UMImage(getActivity(), R.drawable.icon)); // 设置分享图片,参数2为本地图片的路径(绝对路径) //mController.setShareMedia(new UMImage(getActivity(), //BitmapFactory.decodeFile("/mnt/sdcard/icon.png"))); // 设置分享音乐 //UMusic uMusic = new UMusic("http://sns.whalecloud.com/test_music.mp3"); //uMusic.setAuthor("GuGu"); //uMusic.setTitle("天籁之音"); // 设置音乐缩略图 //uMusic.setThumb("http://www.umeng.com/images/pic/banner_module_social.png"); //mController.setShareMedia(uMusic); // 设置分享视频 //UMVideo umVideo = new UMVideo( //"http://v.youku.com/v_show/id_XNTE5ODAwMDM2.html?f=19001023"); // 设置视频缩略图 //umVideo.setThumb("http://www.umeng.com/images/pic/banner_module_social.png"); //umVideo.setTitle("友盟社会化分享!"); //mController.setShareMedia(umVideo);

人人网分享时,如果不设置website,点击¨ 应用名称¨ 或者¨ 图片¨ 将跳转到人人网主页;如果设置website将跳转到此website的页面。
设置website的方式如下:
mController.setAppWebSite(SHARE_MEDIA.RENREN, "http://www.umeng.com/social");

 
4.2 通过某个按钮或其他方法弹出分享面板
mController.getConfig().removePlatform( SHARE_MEDIA.RENREN, SHARE_MEDIA.DOUBAN); yourShareButton.setOnClickListener(new OnClickListener() { @Override public void onClick(View v) { // 是否只有已登录用户才能打开分享选择页 mController.openShare(getActivity(), false); } });

 
5 验证效果编译并运行后,点击添加分享功能的View出现如下页面,那么说明你已经集成成功基本的分享功能和平台了!但是,为了使您的用户有更好的分享体验,以及您的应用有更多的分享量,更好地在社交平台上传播,我们建议您按照下面的指引进行SSO(免登录)和新平台的设置。
   
Android 友盟社会化组件-分享实现

文章图片
Android 友盟社会化组件-分享实现

文章图片
选择分享平台面板 分享编辑页
SSO名词解释 : SSO英文全称Single Sign On,单点登录。SSO是在多个应用系统中,用户只需要登录一次就可以访问所有相互信任的应用系统。
例如用户已经登录新浪微博客户端,使用SSO授权登录时则不需要用户手动输入用户名、密码,直接点击登录即可, 因此可成为免登录.
 
6 各平台SSO(免登录)配置 
6.1 如果有使用任一平台的SSO授权或者集成了facebook平台, 则必须在对应的activity中实现onActivityResult方法, 并添加如下代码
@Override protected void onActivityResult(int requestCode, int resultCode, Intent data) { super.onActivityResult(requestCode, resultCode, data); UMSsoHandler ssoHandler = mController.getConfig().getSsoHandler(requestCode) ; if(ssoHandler != null){ ssoHandler.authorizeCallBack(requestCode, resultCode, data); } }

 
6.2 分享到微信和朋友圈 6.2.1 添加微信和朋友圈所依赖的jar文件1.解压已下载的SDK.zip文件,将SocialSDK_WeiXin.jar拷贝到工程的libs(如果没有此目录,新建libs目录)目录中.
2.在libs目录中找到SocialSDK_WeiXin.jar文件,鼠标右键--> Add to Build Path.
6.2.2 添加如下集成代码
// wx967daebe835fbeac是你在微信开发平台注册应用的AppID, 这里需要替换成你注册的AppID String appID = "wx967daebe835fbeac"; // 微信图文分享必须设置一个url String contentUrl = "http://www.umeng.com/social"; // 添加微信平台,参数1为当前Activity, 参数2为用户申请的AppID, 参数3为点击分享内容跳转到的目标url UMWXHandler wxHandler = mController.getConfig().supportWXPlatform(getActivity(),appID, contentUrl); //设置分享标题 wxHandler.setWXTitle("友盟社会化组件很不错"); // 支持微信朋友圈 UMWXHandler circleHandler = mController.getConfig().supportWXCirclePlatform(getActivity(),appID, contentUrl) ; circleHandler.setCircleTitle("友盟社会化组件还不错...");

微信和朋友圈支持纯文字,纯图片(点击查看大图),图文,音乐,视频分享。
注意 
此版本兼容了微信支付的功能,请更新SocialSDK_WeiXin.jar文件。
6.2.3 微信和微信朋友圈的回调如果在您的项目中集成了微信或者微信朋友圈,并且您需要准确的分享回调,则需要在AndroidManifest.xml中下注册下面的回调Activity。
< < /FONT> activity android:name=".wxapi.WXEntryActivity" android:theme="@android:style/Theme.Translucent.NoTitleBar" android:configChanges="keyboardHidden|orientation|screenSize" android:exported="true" android:screenOrientation="portrait" />

然后将SDK包中weixin目录下的wxapi文件夹拷贝到您的工程的包目录下, 然后修改WXEntryActivity的完整路径即可。
例如social_sdk_example的包名为com.umeng.soexample,因此将wxapi文件夹拷贝到com.umeng.soexample下,最终WXEntryActivity的 完整路径为com.umeng.soexample.wxapi.WXEntryActivity。
其中分享的回调接口SnsPostListener的onComplete方法的第二个参数代表分享的状态码,当值为200时表示分享成功; 其余的值则为分享失败。
微信集成相关说明
1.微信集成注意以下几点
  • 正确填写AppID.
  • 工程的包名必须同申请应用的包名一致。
  • 开发者的应用需要通过审核。开发者在申请应用必须要通过微信官网的审核才能进行调试.
2.Demo中集成的微信无法使用?
原因:Demo中使用的微信AppID绑定的签名信息和你打包时所用的签名信息不一致,导致无法响应. 解决办法有两个,您任选其一:
  • 申请一个测试Demo中AppID.(申请地址).
    填写"包名"时请使用Demo的包名"com.umeng.soexample".
    填写"签名"使用签名生成工具(签名工具)生成,签名时填写Demo的包名.
    获取微信AppID后替换Demo中的使用的AppID.
  • 使用SDK中的 debug.keystore编译运行Demo工程.
 
6.3  分享给QQ好友 6.3.1 添加QQ分享所依赖的jar文件
  1. 解压已下载的SocialSDK.zip文件,SocialSDK_QQZone_1.jar,SocialSDK_QQZone_2.jar拷贝到工程的libs(如果没有此目录,新建libs目录)目录中.
  2. 在libs目录中找到SocialSDK_QQZone_1.jar,SocialSDK_QQZone_2.jar文件,鼠标右键--> Add to Build Path.
  3. 在AndroidManifest.xml中注册AuthActivity,QQ空间和QQ共用该授权Activity,具体配置参考上文的AndroidManifest.xml文件.
  4. 请在QQ互联填写签名:移动应用信息-> 平台信息-> apk签名.(签名地址)
6.3.2 添加如下集成代码
//为了避免每次都从服务器获取APP ID、APP KEY,请设置APP ID跟APP KEY。 //参数1为当前Activity, 参数2为开发者在QQ互联申请的APP ID, //参数3为开发者在QQ互联申请的APP kEY,参数4为点击分享nerve跳转的URL地址 mController.getConfig().supportQQPlatform(getActivity(),"APP ID","APP KEY","http://www.umeng.com/social");

注意:
1.此版本集成了QQ的最新jar文件,请更新SocialSDK_QQZone_1.jar,SocialSDK_QQZone_2.jar文件。
2.QQ分享内容为音乐,视频的时候,其形式必须为url; 图片支持url和本地图片类型。
3.QQ SSO授权不会在onActivityResult方法内被调用。
4.未安装手机QQ客户端的情况下,QQ不支持纯图片分享。
5.未安装手机QQ客户端的情况下,QQ取消授权不执行相关回调。
6.QQ和QQ空间授权,对于同一个应用同一个账号返回的uid,openid相同。 7.为了防止QQ授权出现不可预测的问题,请保证添加QQ平台只执行一次(只调用一次mController.getConfig().supportQQPlatform)!
 
6.4  SSO(免登录)分享到QQ空间 6.4.1 添加QQ空间所依赖的jar文件如果已经添加了SocialSDK_QQZone_1.jar,SocialSDK_QQZone_2.jar文件,则不需要再次添加.
1. 解压已下载的SocialSDK.zip文件,SocialSDK_QQZone_1.jar,SocialSDK_QQZone_2.jar拷贝到工程的libs(如果没有此目录,新建libs目录)目录中.
2. 在libs目录中找到SocialSDK_QQZone_1.jar,SocialSDK_QQZone_2.jar文件,鼠标右键--> Add to Build Path.
3. 在AndroidManifest.xml中注册AuthActivity,QQ空间和QQ共用该授权Activity,具体配置参考上文的AndroidManifest.xml文件.
4. 请在QQ互联填写签名:移动应用信息-> 平台信息-> apk签名.(签名地址)
6.4.2 在集成代码中添加如下代码
//为了避免每次都从服务器获取APP ID、APP KEY,请设置APP ID跟APP KEY mController.getConfig().setSsoHandler( new QZoneSsoHandler(Activity activity, "APP ID", "APP KEY") );

注意:
1.本次集成了QZone的最新jar包,升级时请注意更新SocialSDK_QQZone_1.jar,SocialSDK_QQZone_2.jar文件。
2.在进行QZone SSO授权时,请在AndroidManifest.xml中配置相应的Activity。具体参加上文AndroidManifest.xml文件配置。
3.QZone不支持纯图片分享。
4.无手机QQ客户端的情况下,QQ取消授权不执行相关回调。
5.QQ和QQ空间授权,对于同一个应用同一个账号返回的uid,openid相同。
 
6.5  SSO(免登录)分享到新浪微博 **注意一定保证在新浪微博上填写应用签名,原因参考:http://support.umeng.com/1955/ 6.5.1 将SDK目录下的src覆盖到项目工程根目录下,确保已添加‘com/sina/sso/RemoteSSO.aidl‘. 6.5.2 在代码中添加如下代码
//设置新浪SSO handler mController.getConfig().setSsoHandler(new SinaSsoHandler());

 
6.6  SSO(免登录)分享到腾讯微博 6.6.1 添加腾讯微博SSO所依赖的jar文件1.解压已下载的SocialSDK.zip文件,将SocialSDK_tencentWB_1.jar,SocialSDK_tencentWB_2.jar拷贝到工程的libs(如果没有此目录,新建libs目录)目录中.
2.在libs目录中找到SocialSDK_tencentWB_1.jar,SocialSDK_tencentWB_2.jar文件,鼠标右键--> Add to Build Path.
6.6.2 在集成代码中添加如下代码
//设置腾讯微博SSO handler mController.getConfig().setSsoHandler(new TencentWBSsoHandler());

注意:
1.手机中必须安装微博客户端V3.8.1及以上的版本才支持SSO功能.
2.腾讯微博的SSO没有回调。由于腾讯微博SSO没有提供回调,因此腾讯微博SSO不会在onActivityResult方法内被调用(腾讯微博的流程不经过onActivityResult方法).
7 应用信息注册地址列表下面是Social SDK不同平台应用信息注册网站的地址:
平台网址
新浪微博 http://open.weibo.com
腾讯微博 http://dev.t.qq.com
QQ空间 http://connect.qq.com/intro/login/
微信好友 http://open.weixin.qq.com
FaceBook https://developers.facebook.com
Twitter https://dev.twitter.com
人人 http://dev.renren.com
豆瓣 http://developers.douban.com/
8 混淆【Android 友盟社会化组件-分享实现】为了保证引用友盟Social SDK jar文件以及腾讯jar文件被混淆,请在proguard.cfg文件中添加以下代码避免被混淆.
-dontshrink -dontoptimize -dontwarn com.google.android.maps.** -dontwarn android.webkit.WebView -dontwarn com.umeng.** -dontwarn com.tencent.weibo.sdk.** -dontwarn com.facebook.**-libraryjars libs/SocialSDK_QQZone_2.jar-keep enum com.facebook.** -keepattributes Exceptions,InnerClasses,Signature -keepattributes *Annotation* -keepattributes SourceFile,LineNumberTable-keep public interface com.facebook.** -keep public interface com.tencent.** -keep public interface com.umeng.socialize.** -keep public interface com.umeng.socialize.sensor.** -keep public interface com.umeng.scrshot.**-keep public class com.umeng.socialize.* {*; } -keep public class javax.** -keep public class android.webkit.**-keep class com.facebook.** -keep class com.umeng.scrshot.** -keep public class com.tencent.** {*; } -keep class com.umeng.socialize.sensor.**-keep class com.tencent.mm.sdk.openapi.WXMediaMessage {*; }-keep class com.tencent.mm.sdk.openapi.** implements com.tencent.mm.sdk.openapi.WXMediaMessage$IMediaObject {*; }-keep class im.yixin.sdk.api.YXMessage {*; } -keep class im.yixin.sdk.api.** implements im.yixin.sdk.api.YXMessage$YXMessageData{*; }-keep public class [your_pkg].R$*{ public static final int *; }


    推荐阅读