现在很多应用都包含了社会化分享的功能,最近由于项目需要,所以亲自去踩了踩Mob社会化分享的坑。接下来就介绍一下怎样集成Share SDK吧!!!
一、集成ShareSDK的步骤:
1)注册ShareSDK应用,获取ShareSDK的appkey
首先进入Mob官网,注册一个账户,然后申请应用得到appkey来使用ShareSDK。
创建好了之后,可以点击下图进入应用概况,就可以看到所申请的AppKey:
具体的注册和申请应用的步骤可以参照官网上的帖子。
2)下载ShareSDK
创建完应用之后,就可以下载ShareSDK,官网上一目了然。
进入ShareSDK for Android页面进行选择SDK的版本,根据个人需要选择即可。
点击SDK下载,就可以进入到选择界面,选择自己所需要的平台,然后点击下载SDK 。
下载完成,解压之后会看见有两个文件夹,如下所示:
3)利用快速集成工具生成所需要的集成文件
点击进入ShareSDK for Android目录下,如图所示,QuickIntegrater.jar就是一个快速集成工具;
双击打开快速集成工具,显示如下所示界面:
这个界面可以看到需要输入项目名称和包名,然后选择自己需要分享的平台,点击确定就可以了。(因为我的项目中只用得到QQ 和微信,所以在下载 SDK的时候只选择了这两个平台,如果你是选择了多个平台的话,上面图中会显示更多的内容。)确定以后,集成工具会帮我们生成一个你所输入的项目名称的文件夹;
处于多方面原因,还是用“Sample”这个名称吧,在实际操作中,最好和你的项目名称一样,这样不容易忘记。打开这个文件之后,可以看见下面所示的文件夹:
其中,libs是jar包列表,res是所需的资源文件,src是onekeyshare界面代码,assets是配置初始化第三方那个key的文件。
4)将生成的文件集成到项目中
首先,我们将“Sample”下的libs文件夹中的jar包全部复制到我们项目中的app下的libs中;
复制进去之后,还需要选择jar包右键选择add as library。由于,我已经操作了,所以就不上图了。执行完“add as library”,之后就会像上图一样,jar前面都多了个三角符号。否则,是没有这个符号的。
其次,将“Sample”下的assets复制到src->main下:
接下来,是将“Sample”下的res文件夹中的全部内容复制到自己项目中的src->main->res下,不需要修改文件夹的名称。和原来的文件夹进行资源的合并。
最后,将“Sample”下的src中的内容复制到自己项目中的src->main->java下,即可。
5)配置清单文件
以上几个步骤,就已经完成了ShareSDK的集成了,下面我们还要在AndroidManifest.xml文件中进行相关的配置:
1>添加权限:
2>添加ShareSDK必要的activity的配置:(我这里只添加了自己项目中所需要的activity,如果你还有其他平台,请到官方文档自行查询并添加)
android:name="com.mob.tools.MobUIShell"
android:theme="@android:style/Theme.Translucent.NoTitleBar"
android:configChanges="keyboardHidden|orientation|screenSize"
android:screenOrientation="portrait"
android:windowSoftInputMode="stateHidden|adjustResize">
android:name=".wxapi.WXEntryActivity"
android:theme="@android:style/Theme.Translucent.NoTitleBar"
android:configChanges="keyboardHidden|orientation|screenSize"
android:exported="true"
android:screenOrientation="portrait">
6)申请配置第三方平台的key
接下来我们需要找到src->main->assets下的ShareSDK.xml文件,将其打开;
这里打开后我们可以看到ShareSDK的appkey,前面注册的时候我们已经介绍过,注册完的appkey替换这里默认的appkey(必要)
其次就是第三方的appid或者appkey等了,这些第三方的key需要开发者去对应的第三方平台去申请。首先是替换ShareSDK的appKey。然后是替换你所需要的分享平台的APPID/APPKey/APPSecret就可以了。是不是很简单呢?
7)初始化ShareSDK
使用ShareSDK必须要进行初始化,代码如下:
ShareSDK.initSDK(Context,"你所申请的sharesdk的appkey");
初始化第一个参数传当前activity的context对象,第二个参数传ShareSDK的appkey,第二个参数可以省略不传,因为sharesdk.xml已经配置,默认会访问的;
初始化的代码尽量放到调用分享的activity的入口oncreat下就好,尽量不要再application里初始化,也可以多次调用初始化ShareSDK,初始化ShareSDK必须放到所有调用ShareSDK的最前端。
8)调用onekeyshare的界面分享
接下来我们配置onekeyshare的代码,如下所示:
privatevoidshowShare(Stringtitle,Stringcontent,Stringaddress,Stringimage,Stringlogo){
ShareSDK.initSDK(mContext);
OnekeyShareoks=newOnekeyShare();
//关闭sso授权
oks.disableSSOWhenAuthorize();
//title标题,印象笔记、邮箱、信息、微信、人人网和QQ空间等使用
oks.setTitle(title);
//titleUrl是标题的网络链接,QQ和QQ空间等使用
oks.setTitleUrl(address);
//text是分享文本,所有平台都需要这个字段
oks.setText(content);
//url仅在微信(包括好友和朋友圈)中使用
oks.setUrl(address);
oks.setSiteUrl(address);
oks.setImageUrl(logo);
//启动分享GUI
oks.show(mContext);
}
这是我自己精简了的方法,和官方上的有不同的地方,但是已经可以能满足我的项目中的需求了。界面如下:
到此为止,我们已经可以实现一键分享的功能了。但是偏偏没那么简单就结束,因为,在我的项目中,还有一个需求就是:
指定平台进行分享,你总不可能,点一个图标还弹出一个popuwindow来吧。所以只能继续踩坑了啊。按照官方文档,和不断的踩踩踩之后,三个平台的分享方法简单如下面所示:
指定QQ分享:
privatevoidqqShare(Stringtitle,Stringcontent,Stringaddress,Stringimage,Stringlogo){
ShareSDK.initSDK(mContext);
Platform.ShareParamssp=newPlatform.ShareParams();
sp.setTitle(title);
sp.setTitleUrl(address);//标题的超链接
sp.setText(content);
sp.setImageUrl(logo);
sp.setSite("随便写");
sp.setSiteUrl(address);
Platformqzone=ShareSDK.getPlatform(QQ.NAME);
//设置分享事件回调(注:回调放在不能保证在主线程调用,不可以在里面直接处理UI操作)
qzone.setPlatformActionListener((PlatformActionListener)mContext);
//执行图文分享
qzone.share(sp);
}
指定微信分享:
privatevoidwxShare(Stringtitle,Stringcontent,Stringaddress,Stringimage,Stringlogo){
ShareSDK.initSDK(mContext);
Platform.ShareParamswechat=newPlatform.ShareParams();
wechat.setTitle(title);
wechat.setText(content);
wechat.setImageUrl(logo);
wechat.setUrl(address);
wechat.setShareType(Platform.SHARE_WEBPAGE);
Platformweixin=ShareSDK.getPlatform(mContext,Wechat.NAME);
weixin.setPlatformActionListener((PlatformActionListener)mContext);
weixin.share(wechat);
}
指定朋友圈分享:
privatevoidfriendShare(Stringtitle,Stringcontent,Stringaddress,Stringimage,Stringlogo){
ShareSDK.initSDK(mContext);
Platform.ShareParamswechatMoments=newPlatform.ShareParams();
wechatMoments.setTitle(title);
wechatMoments.setText(content);
wechatMoments.setUrl(address);
wechatMoments.setImageUrl(logo);
wechatMoments.setShareType(Platform.SHARE_WEBPAGE);
Platformweixin=ShareSDK.getPlatform(mContext,WechatMoments.NAME);
weixin.setPlatformActionListener((PlatformActionListener)mContext);
weixin.share(wechatMoments);
Toast.makeText(mContext,"朋友圈分享",Toast.LENGTH_SHORT).show();
}
我这里只是做简单的分享,如果你每个平台分享的类型不一样,可参考Mob官网的Android 不同平台分享内容的详细说明。