现在很多应用都包含了社会化分享的功能,最近由于项目需要,所以亲自去踩了踩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>添加权限:
<uses-permission android:name="android.permission.GET_TASKS" />
<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.CHANGE_WIFI_STATE" />
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.READ_PHONE_STATE" />
<uses-permission android:name="android.permission.MANAGE_ACCOUNTS"/>
<uses-permission android:name="android.permission.GET_ACCOUNTS"/>
<!-- 蓝牙分享所需的权限 -->
<uses-permission android:name="android.permission.BLUETOOTH" />
<uses-permission android:name="android.permission.BLUETOOTH_ADMIN" />
2>添加ShareSDK必要的activity的配置:(我这里只添加了自己项目中所需要的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" >
<!-- QQ和QQ空间分享 QQ登录的回调必须要配置的 -->
<intent-filter>
<data android:scheme="tencent100371282" />
<action android:name="android.intent.action.VIEW" />
<category android:name="android.intent.category.BROWSABLE" />
<category android:name="android.intent.category.DEFAULT" />
</intent-filter>
<!-- 新浪微博客户端分享回调必须配置 -->
<intent-filter>
<action android:name="com.sina.weibo.sdk.action.ACTION_SDK_REQ_ACTIVITY" />
<category android:name="android.intent.category.DEFAULT" />
</intent-filter>
</activity>
<!--微信分享回调 -->
<activity
android:name=".wxapi.WXEntryActivity"
android:theme="@android:style/Theme.Translucent.NoTitleBar"
android:configChanges="keyboardHidden|orientation|screenSize"
android:exported="true"
android:screenOrientation="portrait" >
</activity>
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的代码,如下所示:
private void showShare(String title,String content,String address,String image,String logo) {
ShareSDK.initSDK(mContext);
OnekeyShare oks = new OnekeyShare();
//关闭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分享:
private void qqShare(String title,String content,String address,String image,String logo) {
ShareSDK.initSDK(mContext);
Platform.ShareParams sp = new Platform.ShareParams();
sp.setTitle(title);
sp.setTitleUrl(address); // 标题的超链接
sp.setText(content);
sp.setImageUrl(logo);
sp.setSite("随便写");
sp.setSiteUrl(address);
Platform qzone = ShareSDK.getPlatform(QQ.NAME);
// 设置分享事件回调(注:回调放在不能保证在主线程调用,不可以在里面直接处理UI操作)
qzone.setPlatformActionListener((PlatformActionListener) mContext);
// 执行图文分享
qzone.share(sp);
}
指定微信分享:
private void wxShare(String title,String content,String address,String image,String logo) {
ShareSDK.initSDK(mContext);
Platform.ShareParams wechat = new Platform.ShareParams();
wechat.setTitle(title);
wechat.setText(content);
wechat.setImageUrl(logo);
wechat.setUrl(address);
wechat.setShareType(Platform.SHARE_WEBPAGE);
Platform weixin = ShareSDK.getPlatform(mContext, Wechat.NAME);
weixin.setPlatformActionListener((PlatformActionListener) mContext);
weixin.share(wechat);
}
指定朋友圈分享:
private void friendShare(String title,String content,String address,String image,String logo) {
ShareSDK.initSDK(mContext);
Platform.ShareParams wechatMoments = new Platform.ShareParams();
wechatMoments.setTitle(title);
wechatMoments.setText(content);
wechatMoments.setUrl(address);
wechatMoments.setImageUrl(logo);
wechatMoments.setShareType(Platform.SHARE_WEBPAGE);
Platform weixin = ShareSDK.getPlatform(mContext, WechatMoments.NAME);
weixin.setPlatformActionListener((PlatformActionListener) mContext);
weixin.share(wechatMoments);
Toast.makeText(mContext, "朋友圈分享", Toast.LENGTH_SHORT).show();
}
我这里只是做简单的分享,如果你每个平台分享的类型不一样,可参考Mob官网的 Android 不同平台分享内容的详细说明。
好了,今天的坑就踩到这里吧!欢迎大家一起来交流!!!!