Mob之社会化分享集成ShareSDK

接着上篇顺便分享一篇自己使用 ShareSDK 的笔记，上篇我们集成了 SMSSDK 完成了短信接收验证码的功能，请参考Mob 之 短信验证集成 SMSSDK，如何在项目已经集成 SMSSDK 的情况下集成 ShareSDk 到项目中，上一篇中我们集成 SMSSDK 使用的是导入 jar 包的形式，这里我们使用创建 module 的方式引入 ShareSDk，主要内容如下：

1. 下载ShareSDK
2. 引入 ShareSDK
3. 创建 MainLibs Module
4. 创建 OneKeyShare Module
5. 在项目中引入 Module
6. 配置权限
7. 配置 Application
8. 启用 ShareSDK

下载 ShareSDk

官网下载地址：ShareSDK，下载的时候选中要分享的平台，如下图所示：

下载的 ShareSDk 解压缩如下，这里下载的版本是 ShareSDK-Android-3.0.0 ，如下图所示：

引入 ShareSDK

首先，复制 ShareSDk 中的 ShareSDK.xml 文件到项目中的 assets 目录下，
这里使用引入 module 的方式引入 ShareSDk，ShareSDK 里面主要引入如下两个 Libs，如下图所示：

下面演示一下 Module的创建过程：

创建 MainLibs Module

1. 在新建的项目中创建一个 Android Library，如下图所示：
   

2. 删除新创建的 Library 中 main 下面的所有文件，及 java、res两个文件夹和 AndroidManifest.xml 文件，如下图所示：
   

3. 复制要引入的 MainLibs 中的 res 、 AndroidMainfest.xml 、 libs（里面的jar） 到对应的文件夹，如下图所示：
   
   导入 mainLibs 中结构如下：

此时，这个 module 就创建好了，这里使用 ShareSDK 提供的分享页面，故还需引入 OneKeyShare。

创建 OneKeyShare Module

创建 Module 的过程和上述一样，注意的是多了一个 src ，里面是要使用的 java 文件，所以必须也得引用，如下图所示：

将 src 文件夹复制到 main下面即可，build 之后如果不出错，说明 Module 创建成功了，下面根据依赖关系一如对应的 Module 即可。

在项目中引入 Module

这里面 OnKeyShareLibs 依赖 MainLibs ,只需 app 依赖 OnkeyShareLibs 即可，这里演示 OnKeyShareLibs 如何依赖 MainLibs，如下图所示：

然后，同样的方式 app 依赖 OnKeyShareLibs 即可。

配置权限

这里之前配置过 SMSSDK ,只需补充缺少的权限即可，下面是同时集成了 SMSSDK 和 ShareSDK 所需的全部权限，如下：

<!-- 添加必要的权限 -->
<!--SMS SDK-->
    <uses-permission android:name="android.permission.READ_PHONE_STATE" />
    <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
    <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
    <uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
    <uses-permission android:name="android.permission.INTERNET" />
    <uses-permission android:name="android.permission.RECEIVE_SMS" />
    <uses-permission android:name="android.permission.GET_TASKS" />
    <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
    <!--ShareSDK-->
    <uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION"/>
    <uses-permission android:name="android.permission.CHANGE_WIFI_STATE" />
    <uses-permission android:name="android.permission.SYSTEM_ALERT_WINDOW" />

配置 Application

如果之前配置过 SMSSDK ，那么 MobUIShell 是配置过的，只需添加缺少的 IntentFilter ，集成 SMSSDK 和 ShareSDK 可共用 MobUIShell ，如下：

<activity
    android:name="com.mob.tools.MobUIShell"
    android:theme="@android:style/Theme.Translucent.NoTitleBar"
    android:configChanges="keyboardHidden|orientation|screenSize"
    android:windowSoftInputMode="stateHidden|adjustResize">
    <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>

    <!-- 调用新浪原生SDK，需要注册的回调activity -->
    <intent-filter>
        <action android:name="com.sina.weibo.sdk.action.ACTION_SDK_REQ_ACTIVITY" />
        <category android:name="android.intent.category.DEFAULT" />
    </intent-filter>

</activity>

如果您的项目集微信或者微信朋友圈，请查看AndroidManifest.xml配置文件里的package路径,需要在package目录下创建wxapi目录再放置WXEntryActivity。 没有此activity在微信分享后回调会检查是否有此activity,没有将会报错：

<activity     
    android:name=".yxapi.YXEntryActivity"     
    android:theme="@android:style/Theme.Translucent.NoTitleBar"
    android:configChanges="keyboardHidden|orientation|screenSize" 
    android:exported="true"     
    android:screenOrientation="portrait" />

具体请参考：Android ShareSDK完整的集成文档

启用 SDK

通过 AndroidManifest.xml

1. 在 Application 节点下添加以下属性：

android:name="com.mob.MobApplication"

1. 在 Application 标签下添加 meta 参数：

<!-- 通过AndroidManifest配置AppKey和AppSecret，如果你选择通过代码配置，则不需要配置以下meta-data -->
<meta-data android:name="Mob-AppKey" android:value="你的AppKey"/>
<meta-data android:name="Mob-AppSecret" android:value="你的AppSecret"/>

代码配置

// 通过代码注册你的AppKey和AppSecret
MobSDK.init(context, "你的AppKey", "你的AppSecret");

上述两种方式，只使用其中一种即可初始化 ShareSDK 了。

调用分享界面

private void showShare() {
     OnekeyShare oks = new OnekeyShare();
     //关闭sso授权
     oks.disableSSOWhenAuthorize(); 
     // title标题，印象笔记、邮箱、信息、微信、人人网和QQ空间使用
     oks.setTitle(getString(R.string.share));
     // titleUrl是标题的网络链接，仅在人人网和QQ空间使用
     oks.setTitleUrl("http://sharesdk.cn");
     // text是分享文本，所有平台都需要这个字段
     oks.setText("我是分享文本");
     // imagePath是图片的本地路径，Linked-In以外的平台都支持此参数
     oks.setImagePath("/sdcard/test.jpg");//确保SDcard下面存在此张图片
     // url仅在微信（包括好友和朋友圈）中使用
     oks.setUrl("http://sharesdk.cn");
     // comment是我对这条分享的评论，仅在人人网和QQ空间使用
     oks.setComment("我是测试评论文本");
     // site是分享此内容的网站名称，仅在QQ空间使用
     oks.setSite(getString(R.string.app_name));
     // siteUrl是分享此内容的网站地址，仅在QQ空间使用
     oks.setSiteUrl("http://sharesdk.cn");

    // 启动分享GUI
     oks.show(this);
}

本文主要记录了如何以 module 的方式引入 第三方 SDK 以及页面的分享调用。

可以选择关注微信公众号：jzman-blog 获取最新更新，一起交流学习!