ShareSDK 社会化分享 集成步骤

时间:2023-03-08 22:00:24

第一步 :获取ShareSDK

官网:http://www.mob.com

完整的集成文档:http://wiki.mob.com/android-sharesdk%E5%AE%8C%E6%95%B4%E7%9A%84%E9%9B%86%E6%88%90%E6%96%87%E6%A1%A3/

下载资源 http://www.mob.com/#/downloadDetail/ShareSDK/android

ShareSDK 社会化分享 集成步骤

右边的比较全,左边为简洁版

解压以后可以得到如下图的目录结构:

ShareSDK 社会化分享 集成步骤   ShareSDK 社会化分享 集成步骤  ShareSDK 社会化分享 集成步骤
  • “ShareSDK for Android”目录中的“Libs”包含“MainLibs”和“OnekeyShare”,分别是ShareSDK的核心库和“快捷分享”的源码库,说明文档也在此目录下,集成ShareSDK前请务必仔细阅读。
  • “ShareSDK for Android ApiDoc”包含Mainlibs和OnekeyShare的JavaDoc,供开发者开发时查阅。
  • “ShareSDK for Android Sample”包含ShareSDK的功能演示代码和apk文件,Sample源码的JavaDoc在http://wiki.mob.com/docs/sharesdk/android/中。
  • “ShareSDK for Android Services”包含ShareSDK已经发布的“插件服务”,暂时我们只提供了“评论与赞”服务,压缩包中已经提供了此插件服务的依赖库、示例代码、JavaDoc和apk文件。

第二步:导入相关jar包和资源

有三种集成方式,只介绍一种

在Windows下可以直接右键使用JAVA执行ShareSDK for Android目录下的快速集成工具QuickIntegrater.jar,这个程序会自动搜集集成SDK所需要的jar和资源,完成以后可以通过复制目标目录中的文件到您项目中覆盖就行了。
如果右键不行,直接到命令行中【java -jar 】然后把此文件拉到命令行中就可以运行了
ShareSDK 社会化分享 集成步骤   ShareSDK 社会化分享 集成步骤
ShareSDK 社会化分享 集成步骤

ShareSDK 社会化分享 集成步骤


第三步:配置第三方应用信息

有三种方式,只介绍一种

  • 通过“assets/ShareSDK.xml”文件来配置,此方式会以明文存在,优先级最低,但是最为方便、集中;
ShareSDK.xml以XML格式存储数据,每一个平台一个块,除了社交平台外,开发者在ShareSDK注册应用时得到的Appkey需要填写在块“ShareSDK”中,如果此Appkey不是开发者自己的Appkey,则将来在ShareSDK应用后台的统计数据将不正确。
ShareSDK的每一个平台都具备SortId、Id、Enable四个字段,除此之外的字段(如新浪微博的AppKey、AppSecret、RedirectUrl、ShareByAppClient等字段)需要到目标平台上注册应用以后得到,请正确填写这些字段的数据,否则ShareSDK无法完成授权,则后续的其它操作也将无法执行。

第四步:配置清单文件

1、添加权限

<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.GET_ACCOUNTS"/>
<uses-permission android:name="android.permission.MANAGE_ACCOUNTS"/>
<uses-permission android:name="android.permission.READ_PHONE_STATE"/>
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"/>
<uses-permission android:name="android.permission.GET_TASKS"/>

<uses-permission android:name="android.permission.INTERNET"/>

2、注册Activity

<activity

            android:name="com.mob.tools.MobUIShell"
            android:configChanges="keyboardHidden|orientation|screenSize"
            android:screenOrientation="portrait"
            android:theme="@android:style/Theme.Translucent.NoTitleBar"

android:windowSoftInputMode="stateHidden|adjustResize" />

3、如果您的项目集微信或者微信朋友圈,需要在package目录下创建【wxapi】目录再放置WXEntryActivity。在微信分享后回调时会检查是否有此activity,没有将会报错。注:在第二步中如果勾选了微信,那么会自动生成了此目录及此文件。

另外,微信要求签名和包名绑定,具体详见微信官方文档。

这个Activity同样需要清单文件中注册。

<activity

            android:name=".wxapi.WXEntryActivity"
            android:configChanges="keyboardHidden|orientation|screenSize"
            android:exported="true"
            android:screenOrientation="portrait"

android:theme="@android:style/Theme.Translucent.NoTitleBar" />

使用易信时也有同样的问题,其目录为yxapi,类名为YXEntryActivity。


第五步:添加代码

打开您项目的入口Activity,在其onCreate中插入代码:ShareSDK.initSDK(this);代码会初始化ShareSDK,此后对ShareSDK的操作都以此为基础。

如果需要统计应用被打开次数,可以在出口activity中的onDestroy方法的第一行加入ShareSDK.stopSDK(this);代码会结束Share SDK的统计功能并释放资源。
InitSDK是可以重复调用的,其实Share SDK建议在您不确定的时候调用这个方法,来保证Share SDK被正确初始化。
而stopSDK一旦调用了,就必须重新调用InitSDK才能使用Share SDK的功能,否则会出现空指针异常。
完成SDK初始化以后,就可以调用授权、获取资料、分享等操作了,详细的使用方法,请参考。
    //onekeyshare分享调用九宫格方法
    private void showShare() {
        ShareSDK.initSDK(this);
        OnekeyShare oks = new OnekeyShare();
        oks.disableSSOWhenAuthorize();//关闭sso授权
        String path = Environment.getExternalStorageDirectory().getPath();
        oks.setTitle("我是分享标题");// title标题,印象笔记、邮箱、信息、微信、人人网和QQ空间使用
        oks.setTitleUrl("http://sharesdk.cn");// titleUrl是标题的网络链接,仅在人人网和QQ空间使用
        oks.setText("我是分享文本");// text是分享文本,所有平台都需要这个字段
        oks.setImagePath(path + "test.jpg");//图片的本地路径,Linked-In以外的平台都支持此参数
        oks.setUrl("http://sharesdk.cn");// url仅在微信(包括好友和朋友圈)中使用
        oks.setComment("我是评论");// comment是我对这条分享的评论,仅在人人网和QQ空间使用
        oks.setSite(getString(R.string.app_name));// site是分享此内容的网站名称,仅在QQ空间使用
        oks.setSiteUrl("http://sharesdk.cn");// siteUrl是分享此内容的网站地址,仅在QQ空间使用
        oks.show(this);// 启动分享GUI

}


我草草,基本上所有私人信息全部暴露了
包括:账号信息,分享信息,终端属性,网络信息,以及时间地点性别……我去!
ShareSDK 社会化分享 集成步骤