在现在的APP或者游戏中,分享功能几乎已经成为标配。分享功能不但能够满足用户的需求,也能够为产品带来更多的用户,甚至可以对用户的行为、活跃度、年龄段等情况进行数据统计,使得软件公司可以对产品进行更精准的定位。今天我们就来简单剖析市场上一款优秀的分享SDK以及其集成过程,这款分享SDK就是友盟的社会化分享组件。
友盟社会化分享,帮助移动应用快速具备分享、登录、评论、喜欢等社交功能,提升用户粘度、助力产品推广,并提供实时、全面的社会化数据统计分析服务。
根据友盟的集成文档,我们对于友盟社会化分享SDK的操作主要是通过UMSocialService接口来进行操作,一些相关的配置则需要通过SocialzieConfig类来进行配置,这个配置类通过UMSocialService的getConfig()函数来获得。在友盟社会化分享SDK中一个社交平台通过SHARE_MEDIA枚举来标识,比如新浪微博就是SHARE_MEDIA.SINA,微信就是SHARE_MEDIA.WEIXIN。通过这个平台枚举我们就知道了用户是要将内容分享到哪个社交平台,至于为什么是用枚举,我想可能是因为老代码的遗留问题吧。而为了增强平台的可扩展性,友盟又增加了一个UMSsoHandler ,通过这个类来包装社交平台的分享、SSO登录等操作。
因此,我们得到如下几张结构图:
图1
从图1中可以看出,SDK的核心控制类中含有一个配置类,该配置类管理SDK中的各个社交平台,因此如果我们要支持分享到某个平台,必须将该平台添加到SDK的配置类中。如果不需要某个平台,就将该平台从SDK配置类中删除即可。
图2 图3
图2和图3分别是授权和分享的基本流程。对于授权来说,如果该平台只有webview授权,那么就是用webview进行授权。如果该平台既支持webview授权又支持SSO授权 ( 即通过客户端来授权 ),在用户没有配置SSO授权的情况下是用webview授权,否则是用SSO授权。如果该平台只是SSO授权,那么在客户端的版本支持的情况就会是用SSO授权。而SSO授权都是通过UMSsoHandler这个类来进行操作的。再看图3,分享也是两个分支,即通过API进行分享和通过社交平台客户端分享,例如豆瓣只支持API分享,而微信只支持通过客户端进行分享。通过客户端进行分享也是通过UMSsoHandler这个类。
总结一下:
SDK中含有配置类,配置类管理各个社交平台。当用户要把内容分享到某个社交平台时,SDK内部进行处理,如果是通过API分享,那么直接底层分享。如果是通过客户端分享,那么通过平台找到对应的UMSsoHandler对象,然后再通过UMSsoHandler的相应方法跳转到社交平台或者IM软件的客户端进行分享。授权也是同样的原理。
下面,我们就以新浪微博为例来讲解一下集成过程。
首先到新浪微博开放平台中创建一个新的应用,新浪微博开放平台。
图 4
然后填写应用的相关信息后会进入到APP详细信息的配置页面。如下图所示:
图 5
在这里主要配置的是应用的包名和签名。应用的包名在AndroidManifest.xml中查看,package属性的值就是。
<manifest xmlns:android="http://schemas.android.com/apk/res/android" package="com.example.sharedemo" android:versionCode="1" android:versionName="1.0" >应用签名即是应用的keystore的MD5值,但也不一定,比如facebook的签名就是keystore的SHA1加上分号,然后再加上应用包名。这里我们只讲解新浪微博的设置,我们可以通过eclipse查看应用的签名。如下图 :
图6
下图中的MD5 fingerprint的值就是我们的APP签名,这个值不是直接填写到新浪开发平台官网的,而是需要将冒号去掉,并且将字母转换为小写。如上图5所示。然后填写完其它的信息,提交审核即可。此时,我们就有了新浪微博的app id和app key了。
通过审核我们可以到友盟官网创建应用并且绑定新浪微博的app id和app key了。如图7.
图 7
此时,我们就可以在工程中集成友盟社会化分享组件SDK了。
首先,下载SDK并且解压缩SDK。SDK目录如下。
图8
其中main文件夹下的为核心sdk的jar和资源,将jar包拷贝到libs目录下,并且添加到编译路径中,然后将res目录下的资源拷贝到你工程中对应的目录下即可。platforms目录下即为各个社交平台的jar包和资源。SDK默认添加了新浪微博、豆瓣、人人网、腾讯微博这几个平台,其他平台需要手动添加jar包、资源 ( 存放在platforms中对应的目录中 ),然后手写代码添加到SDK中。
图9
先看上图9 的左边,确保你所需要的jar包和资源都拷贝进了对应的目录,然后看右边的代码。首先声明一个UMSocialService的对象,这个对象就是整个SDK的控制器,通过这个控制器我们可以进行授权、分享等操作。我们通过相应的方法设置分享内容,然后设置各个平台在分享面板上的显示顺序( 不是必须 ), 最后我们在一个按钮的点击事件中调用了UMSocialService的openShare(context, listener)方法,这个方法就是打开分享面板。用户点击这个面板上的平台时就会将分享内容分享到这个平台( 如果没有授权则需要先授权一次 )。
最后,不要忘了将你获取到的友盟appkey等信息配置AndroidManifest.xml。配置AndroidManifest.xml参考友盟文档,友盟社会化组件文档。
运行程序后,会得到如下的效果图。点击某个平台就可以进行授权,然后分享。
// 微信平台 UMWXHandler wxHandler = new UMWXHandler(getActivity(), "你的微信app id", "你的微信 app secret") ; wxHandler.addToSocialSDK(); // 微信朋友圈平台, 与微信共用一个app id, app secret UMWXHandler circleHandler = new UMWXHandler(getActivity(), "你的微信app id", "你的微信 app secret") ; circleHandler.addToSocialSDK();
<activity android:name=".wxapi.WXEntryActivity" android:theme="@android:style/Theme.Translucent.NoTitleBar" android:configChanges="keyboardHidden|orientation|screenSize" android:exported="true" android:screenOrientation="portrait" />这样,集成就完成了。但是想要成功分享还得微信开放平台的审核通过,这需要一些时间,因此为了节省时间,填写包名和签名时尽量保证没有问题。审核通过后,即可分享成功。
// 构造平台,参数1为平台名字,参数2为平台图标 CustomPlatform myCustomPlatform = new CustomPlatform("我的平台", R.drawable.ic_launcher); // 平台点击事件处理 myCustomPlatform.mClickListener = new OnSnsPlatformClickListener() { @Override public void onClick(Context arg0, SocializeEntity arg1, SnsPostListener arg2) { // 在这里处理平台的点击事件,一般为调用目标设计平台的分享或者授权方法. } }; // 将平台添加到SDK中 mController.getConfig().addCustomPlatform(myCustomPlatform);这样就添加成功了。注意,此时如果你需要设置各个平台在分享面板中的顺序,那么你就不要使用
mController.getConfig().setPlatforms(SHARE_MEDIA.SINA, SHARE_MEDIA.TENCENT, SHARE_MEDIA.DOUBAN, SHARE_MEDIA.RENREN)来进行排序了,因为你有了自定义平台,通过上面的设置方法的话自定义平台则无法显示在分享面板上。此时,应该使用如下方法。
mController.getConfig().setPlatforms(SHARE_MEDIA.SINA.toString(), SHARE_MEDIA.TENCENT.toString(),, SHARE_MEDIA.DOUBAN.toString(),"我的平台" ) ;效果如下 :
在Android中使App快速、简单地支持新浪微博、微信、QQ、facebook等十几个主流社交平台的分享功能
原文地址:http://blog.csdn.net/bboyfeiyu/article/details/40400023