ShareSDK集成

第一步：下载SDK：

• 1下载地址：http://www.mob.com/#/downloadDetail/ShareSDK/android
  
• 根据需求选择需要的平台：
  

---

第二步：申请ShareSDK的AppKey

• 把鼠标移到头像上，点击进入后台:
  
• 点击ShareSDK：
  
• 把鼠标移到应用上，点击添加应用:
  
• 根据自己的需求填写:
  
• 这样就得到了ShareSDK的AppKey：
  

---

第三步：快速集成

进入ShareSDK解压目录，打开“Share SDK for Android”目录，可以找到“QuickIntegrater.jar”，这个就是快速集成ShareSDK的工具。
Windows下：
首先确定您已经安装了JDK，并且正确配置了JAVA_HOME和PATH系统变量，此时您可以双击QuickIntegrater启动程序。


然后复制此文件夹中所有文件到自己的项目中覆盖。
Linux/Mac OS下：
同样需要先确保已经正确配置了JDK，之后启动终端，cd进入“Share SDK for Android”目录，输入： java -jar QuickIntegrater.jar 可启动QuickIntegrater

---

第四步：配置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.添加activity信息
  **注意：**tencent后面的appid要保持和自己配置的QQ的appid一致。

<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" >

     <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>

• 3.如果集成了微信，易信，支付宝还需要添加下面回调的activity处理.
  注意：这些avtivity的name。

<!-- 微信分享回调 -->
<activity
     android:name=".wxapi.WXEntryActivity"
     android:theme="@android:style/Theme.Translucent.NoTitleBar"
     android:configChanges="keyboardHidden|orientation|screenSize"
     android:exported="true"
     android:screenOrientation="portrait" /> 

<!--易信分享回调 -->
 <activity
     android:name=".yxapi.YXEntryActivity"
     android:theme="@android:style/Theme.Translucent.NoTitleBar"
     android:configChanges="keyboardHidden|orientation|screenSize"
     android:exported="true"
     android:screenOrientation="portrait" />

 <!-- 支付宝分享回调 -->
<activity
    android:name=".apshare.ShareEntryActivity"
    android:theme="@android:style/Theme.Translucent.NoTitleBar"
    android:configChanges="keyboardHidden|orientation|screenSize"
    android:exported="true"/>

• 4.替换mob后台申请的Appkey与各个平台申请的key。
  

• 5.添加一键分享代码

private void showShare() {
 ShareSDK.initSDK(this);
 OnekeyShare oks = new OnekeyShare();
 //关闭sso授权
 oks.disableSSOWhenAuthorize(); 

// 分享时Notification的图标和文字  2.5.9以后的版本不调用此方法
 //oks.setNotification(R.drawable.ic_launcher, getString(R.string.app_name));
 // title标题，印象笔记、邮箱、信息、微信、人人网和QQ空间使用
 oks.setTitle(getString(R.string.share));
 // titleUrl是标题的网络链接，仅在人人网和QQ空间使用
 oks.setTitleUrl("http://sharesdk.cn");
 // text是分享文本，所有平台都需要这个字段
 oks.setText("我是分享文本");
 //分享网络图片，新浪微博分享网络图片需要通过审核后申请高级写入接口，否则请注释掉测试新浪微博
 oks.setImageUrl("http://f1.sharesdk.cn/imgs/2014/02/26/owWpLZo_638x960.jpg");
 // 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);
 }

---

自定义UI，实现不同平台分享内容差异化

功能说明：点击分享，弹出自定义对话框；根据传入的参数，选择要调起的平台，不同平台分享不同内容。

- 1.dialog的布局（dialog_share.xml）

<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:background="#ffffff" >

    <GridView
        android:id="@+id/dialog_share_gridview" 
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:layout_margin="10dp"
        android:numColumns="auto_fit"
        android:horizontalSpacing="1dp"
        android:verticalSpacing="1dp"
        android:background="#00000000"></GridView>

</RelativeLayout>

• 2.item的布局文件（dialog_share_item.xml）

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:gravity="center"
    android:orientation="vertical"
    android:padding="10dp" >

    <ImageView
        android:id="@+id/image"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:src="@drawable/ic_launcher" />

    <TextView
        android:id="@+id/text"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:layout_marginTop="5dp"
        android:text="文字"
        android:textColor="#000000" />

</LinearLayout>

• 3.shareUtils代码（ShareUtils.java）

import java.util.ArrayList;
import java.util.HashMap;
import java.util.List;
import java.util.Map;

import com.chinalife.gstc.R;
import com.chinalife.gstc.common.data.Const;
import com.mob.tools.utils.UIHandler;

import android.app.Dialog;
import android.content.Context;
import android.os.Handler.Callback;
import android.os.Message;
import android.text.TextUtils;
import android.view.View;
import android.widget.AdapterView;
import android.widget.GridView;
import android.widget.SimpleAdapter;
import android.widget.Toast;
import cn.sharesdk.framework.Platform;
import cn.sharesdk.framework.PlatformActionListener;
import cn.sharesdk.framework.ShareSDK;
import cn.sharesdk.onekeyshare.OnekeyShare;
import cn.sharesdk.sina.weibo.SinaWeibo;
import cn.sharesdk.system.text.ShortMessage;
import cn.sharesdk.tencent.qq.QQ;
import cn.sharesdk.tencent.qq.QQ.ShareParams;
import cn.sharesdk.tencent.qzone.QZone;
import cn.sharesdk.wechat.friends.Wechat;
import cn.sharesdk.wechat.moments.WechatMoments;

public class ShareUtils {
    // 图片封装为一个数组
    private static int[] icon = { R.drawable.ssdk_oks_classic_qq,
            R.drawable.ssdk_oks_classic_qzone,
            R.drawable.ssdk_oks_classic_wechat,
            R.drawable.ssdk_oks_classic_wechatmoments,
            R.drawable.ssdk_oks_classic_sinaweibo,
            R.drawable.ssdk_oks_classic_shortmessage };
    private static String[] iconName = { "QQ", "QQ空间", "微信", "微信朋友圈", "新浪微博",
            "短消息" };
    private static int[] platform = { 1, 2, 3, 4, 5, 6 };
    private static List<Map<String, Object>> data_list = null;
    private static SimpleAdapter sim_adapter;
    private static final int MSG_ACTION_CCALLBACK = 2;
    private static Context mContext;



    /**
     * 自定义分享功能
     * 
     * @param context
     * @param share要调起的平台
     *            （1-QQ, 2-QQ空间, 3-微信, 4-微信朋友圈, 5-新浪微博, 6-短消息）
     * @param title标题
     * @param text分享的文本
     * @param imageUrl分享的图片网址url
     * @param url可点的连接地址url
     */
    public static void showShare(Context context, int[] share,
            final String title, final String text, final String imageUrl,
            final String url) {
        mContext = context;
        ShareSDK.initSDK(context);
        final Dialog dialog = new Dialog(context, R.style.Theme_Transparent);
        dialog.setContentView(R.layout.dialog_share);
        dialog.show();
        GridView gridView = (GridView) dialog
                .findViewById(R.id.dialog_share_gridview);
        // 新建List
        data_list = new ArrayList<Map<String, Object>>();
        // 获取数据
        getData(share);
        // 新建适配器
        String[] from = { "image", "text" };
        int[] to = { R.id.image, R.id.text };
        sim_adapter = new SimpleAdapter(context, data_list,
                R.layout.dialog_share_item, from, to);
        // 配置适配器
        gridView.setAdapter(sim_adapter);
        gridView.setOnItemClickListener(new AdapterView.OnItemClickListener() {

            @Override
            public void onItemClick(AdapterView<?> parent, View view,
                    int position, long id) {
                ShareParams shareParams = new ShareParams();
                // 标题
                if(!TextUtils.isEmpty(title)){
                    shareParams.setTitle(title);
                }
                // 文本
                if(!TextUtils.isEmpty(text)){
                    shareParams.setText(text);
                }
                // 分享网络图片
                if(!TextUtils.isEmpty(imageUrl)){
                    shareParams.setImageUrl(imageUrl);
                }
                // 可点的连接地址ur
                if(!TextUtils.isEmpty(url)){
                    shareParams.setUrl(url);
                }
                // 执行图文分享
                shareParams.setShareType(Platform.SHARE_WEBPAGE);
                if ("QQ".equals(data_list.get(position).get("text"))) {
                    Platform platQQ = ShareSDK.getPlatform(QQ.NAME);
                    platQQ.setPlatformActionListener(listener);
                    platQQ.share(shareParams);
                } else if ("QQ空间".equals(data_list.get(position).get("text"))) {
                    Platform platQZone = ShareSDK.getPlatform(QZone.NAME);
                    platQZone.setPlatformActionListener(listener);
                    platQZone.share(shareParams);
                } else if ("微信".equals(data_list.get(position).get("text"))) {
                    Platform platWechat = ShareSDK.getPlatform(Wechat.NAME);
                    platWechat.setPlatformActionListener(listener);
                    platWechat.share(shareParams);
                } else if ("微信朋友圈".equals(data_list.get(position).get("text"))) {
                    Platform platWechatMoments = ShareSDK
                            .getPlatform(WechatMoments.NAME);
                    platWechatMoments.setPlatformActionListener(listener);
                    platWechatMoments.share(shareParams);
                } else if ("新浪微博".equals(data_list.get(position).get("text"))) {
                    Platform platSinaWeibo = ShareSDK
                            .getPlatform(SinaWeibo.NAME);
                    platSinaWeibo.setPlatformActionListener(listener);
                    platSinaWeibo.share(shareParams);
                } else if ("短消息".equals(data_list.get(position).get("text"))) {
                    shareParams.setShareType(Platform.SHARE_TEXT);
                    Platform platShortMessage = ShareSDK
                            .getPlatform(ShortMessage.NAME);
                    platShortMessage.share(shareParams);
                }

                dialog.dismiss();
            }
        });
    }


    /**
     * 
     * @param platform要分享的平台
     */
    private static List<Map<String, Object>> getData(int[] share) {
        data_list.clear();
        int num;
        for (int i = 0; i < share.length; i++) {
            Map<String, Object> map = new HashMap<String, Object>();
            if (share[i] == 0) {
                break;
            }
            num = share[i] - 1;
            map.put("image", icon[num]);
            map.put("text", iconName[num]);
            map.put("platform", platform[num]);
            data_list.add(map);

        }
        return data_list;

    }

    static PlatformActionListener listener = new PlatformActionListener() {

        @Override
        public void onError(Platform platform, int action, Throwable t) {
            // 失敗
            // 打印错误信息,print the error msg
            t.printStackTrace();
            // 错误监听,handle the error msg
            Message msg = new Message();
            msg.what = MSG_ACTION_CCALLBACK;
            msg.arg1 = 2;
            msg.arg2 = action;
            msg.obj = t;
            UIHandler.sendMessage(msg,mCallback);

        }

        @Override
        public void onComplete(Platform platform, int action,
                HashMap<String, Object> arg2) {
            // 成功
            Message msg = new Message();
            msg.what = MSG_ACTION_CCALLBACK;
            msg.arg1 = 1;
            msg.arg2 = action;//这个是代表操作的类型，9代表是分享8代表操作是获取用户资料
            msg.obj = platform;//这个参数就是进行操作的平台对象啦
            UIHandler.sendMessage(msg,mCallback);

        }

        @Override
        public void onCancel(Platform platform, int action) {
            // 取消
            Message msg = new Message();
            msg.what = MSG_ACTION_CCALLBACK;
            msg.arg1 = 3;
            msg.arg2 = action;
            msg.obj = platform;
            UIHandler.sendMessage(msg,mCallback);

        }
    };


    static Callback mCallback = new Callback() {

        @Override
        public boolean handleMessage(Message msg) {
            switch (msg.arg1) {
            // 成功
            case 1:
                Toast.makeText(mContext, "分享成功", 10000).show();
                break;
            // 失败
            case 2:
                Toast.makeText(mContext, "分享失败", 10000).show();
                break;
            // 取消
            case 3:
                //Toast.makeText(mContext, "分享取消", 10000).show();
                break;
            }
            return false;
        }
    };

}

注意：
- 1.传入的参数根据需求自行增减，shareParams不同平台的差异化参数设置写在if判断里，就实现不同平台分享内容差异化。
- 2.微信平台必须设置shareParams.setShareType(*);

---

不同平台分享参数说明

注意：
- 1.没有标明可选的就是必填参数，不能为null或者空字符串。
- 2.imageUrl、imagePath、imageData为三选一。

新浪微博

新浪微博支持分享文字、本地图片、网络图片和经纬度信息。
新浪微博使用客户端分享不会正确回调
参数说明：
text：小于2000字
image：图片最大5M，仅支持JPEG、GIF、PNG格式
latitude：有效范围:-90.0到+90.0，+表示北纬
longitude：有效范围：-180.0到+180.0，+表示东经
注：微博分享链接是将链接写到setText内：eg：setText(“分享文本 http://mob.com”);

分享文本：
- text

分享图文：
- text imagePath
- text imageUrl

注：如果imagePath和imageUrl同时存在，imageUrl将被忽略。

腾讯微博

腾讯微博支持分享文字、本地图片、网络图片和经纬度信息。
参数说明：
text：最多140个字字符
image：图片最大4M

分享文本：
- text latitude(可选) longitude(可选)

分享图文：
- text imagePath latitude(可选) longitude(可选)
- text imageUrl latitude(可选) longitude(可选)
- text ImageArray latitude(可选) longitude(可选)

2.5.0以后的版本新增分享多张图片的功能ImageArray。 由于腾讯微博分享网络图片并不属于高级接口，因此imageUrl优先级高于imagePath，这就是说，如果imagePath和imageUrl同时存在，imagePath将被忽略。

QQ空间

QQ空间支持分享文字和图文。
参数说明：
title：最多200个字符
text：最多600个字符

分享文本：
- title titleUrl text site siteUrl

发表说说：
- text imagePath site siteUrl
- text imageUrl site siteUrl

分享图文：
- title titleUrl text imagePath site siteUrl
- title titleUrl text imageUrl site siteUrl

QQ空间分享时一定要携带title、titleUrl、site、siteUrl，QQ空间本身不支持分享本地图片，因此如果想分享本地图片，图片会先上传到ShareSDK的文件服务器，得到连接以后才分享此链接。由于本地图片更耗流量，因此imageUrl优先级高于imagePath。 site是分享此内容的网站名称，仅在QQ空间使用；siteUrl是分享此内容的网站地址，仅在QQ空间使用；

微信（好友、朋友圈、收藏）

绕过审核只对微信好友、微信朋友圈有效。
微信分享如果是绕过审核(配置信息BypassApproval属性设置为true为绕过审核),微信朋友圈可以分享单张图片或者图片与文字一起分享，微信好友可以进行文字或者单张图片或者文件进行分享,分享回调不会正确回调。
不绕过审核，微信三个平台中，好友的功能最完整，朋友圈不能分享表情、文件和应用，收藏不能分享表情和应用。表格下以好友为例子：
参数说明：
title：512Bytes以内
text：1KB以内
imageData：10M以内
imagePath：10M以内(传递的imagePath路径不能超过10KB)
imageUrl：10KB以内
musicUrl：10KB以内
url：10KB以内

分享文本：
- shareType(Platform.SHARE_TEXT) title text

分享图片：
- shareType(Platform.SHARE_IMAGE) title text(设置了不会显示,可选参数) imagePath
- shareType(Platform.SHARE_IMAGE) title text(设置了不会显示,可选参数) imageUrl
- shareType(Platform.SHARE_IMAGE) title text(设置了不会显示,可选参数) imageData

分享音乐：
- shareType(Platform.SHARE_MUSIC) title text(朋友圈不显示此字段) imagePath musicUrl url（消息点击后打开的页面）
- shareType(Platform.SHARE_MUSIC) title text(朋友圈不显示此字段) imageUrl musicUrl url（消息点击后打开的页面）
- shareType(Platform.SHARE_MUSIC) title text(朋友圈不显示此字段) imageData musicUrl url（消息点击后打开的页面）

分享视频：
- shareType(Platform.SHARE_VIDEO) title text(朋友圈不显示此字段) imagePath url（视频网页地址）
- shareType(Platform.SHARE_VIDEO) title text(朋友圈不显示此字段) imageUrl url（视频网页地址
- shareType(Platform.SHARE_VIDEO) title text(朋友圈不显示此字段) imageData url（视频网页地址

分享网页：
- shareType(Platform.SHARE_WEBPAGE) title text(朋友圈不显示此字段) imagePath url
-shareType(Platform.SHARE_WEBPAGE) title text(朋友圈不显示此字段) imageUrl url
-shareType(Platform.SHARE_WEBPAGE) title text(朋友圈不显示此字段) imageData url

分享应用:
- shareType(Platform.SHARE_APPS) title text(朋友圈不显示此字段) imagePath filePath(apk文件) extInfo(应用信息脚本)
- shareType(Platform.SHARE_APPS) title text(朋友圈不显示此字段) imageUrl filePath(apk文件) extInfo(应用信息脚本)
- shareType(Platform.SHARE_APPS) title text(朋友圈不显示此字段) imageData filePath(apk文件) extInfo(应用信息脚本)

分享文件：
- shareType(Platform.SHARE_FILE) title text(朋友圈不显示此字段) imagePath filePath
- shareType(Platform.SHARE_FILE) title text(朋友圈不显示此字段) imageUrl filePath
- shareType(Platform.SHARE_FILE) title text(朋友圈不显示此字段) imageData filePath

分享表情：
- shareType(Platform.SHARE_EMOJI) title text(朋友圈不显示此字段) imagePath
- shareType(Platform.SHARE_EMOJI) title text(朋友圈不显示此字段) imageUrl
- shareType(Platform.SHARE_EMOJI) title text(朋友圈不显示此字段) imageData

微信并无实际的分享网络图片和分享bitmap的功能，如果设置了网络图片，此图片会先下载会本地，之后再当作本地图片分享，因此延迟较大。bitmap则好一些，但是由于bitmap并不知道图片的格式，因此都会被当作png编码，再提交微信客户端。此外，SHARE_EMOJI支持gif文件，但是如果使用imageData，则默认只是提交一个png图片，因为bitmap是静态图片。

QQ分享

QQ分享支持图文和音乐分享。
参数说明：
title：最多30个字符
text：最多40个字符

分享图片：
- ImageUrl
- imagePath

分享链接：
- title titleUrl text imagePath
- title titleUrl text imageUrl

分享音频：
- title titleUrl text imagePath musicUrl
- title titleUrl text imageUrl musicUrl

QQ分享图文和音乐，在PC版本的QQ上可能只看到一条连接，因为PC版本的QQ只会对其白名单的连接作截图，如果不在此名单中，则只是显示连接而已. 如果只分享图片在PC端看不到图片的，只会显示null，在手机端会显示图片和null字段。

信息

信息分短信和彩信，如果设置了标题或者图片，会直接当作彩信发送。发送信息的时候使用手机的信息软件

分享文本：
- address title text

分享图文：
- address title text imagePath imageUrl

支付宝

分享文本：
- shareType(SHARE_TEXT) title text

分享图片：
- shareType(SHARE_IMAGE) title text imagePath
- shareType(SHARE_IMAGE) title text imageUrl
- shareType(SHARE_IMAGE) title text imageData

分享网页：
- shareType(SHARE_WEBPAGE) title text imagePath url（消息点击后打开的页面）
- shareType(SHARE_WEBPAGE) title text imageUrl url（消息点击后打开的页面）
- shareType(SHARE_WEBPAGE) title text imageData url（消息点击后打开的页面）