Android中使用ShareSDK集成分享功能

引言

     现在APP开发集成分享功能已经是非常普遍的需求了。其他集成分享技术我没有使用过，今天我就来介绍下使用ShareSDK来进行分享功能开发的一些基本步骤和注意点，帮助朋友们避免一些坑。好了，下面切入正题正式开始介绍。

1、ShareSDK开发包及配置

这个不用多说，去他们官网看找SDK开发包和集成文档即可。Android版本地址：http://www.mob.com/downloadDetail/ShareSDK/android。注意：记得要注册ShareSDK账号获取AppKey哦。这些集成文档里面应该都有，仔细看即可。

2、去各大应用平台注册获取AppKey和AppSecret

这个步骤要看你们团队想分享到哪些平台了，一般都是微博和微信。所以一般都去新浪微博和微信开发平台注册。

新浪开发平台：http://open.weibo.com/

腾讯开放平台：https://open.weixin.qq.com/

3、一键分享功能的集成

使用ShareSDK进行分享，如果你不需要进行定制开发的话，就可以使用ShareSDK里面自带的一键分享模块。使用之前别忘记把ShareSDK中的jar包和ShareSDK.xml放到指定位置哦(配置文档里面都有，慢慢看即可)。

在application节点下注册下面的Activity如图所示：

　  注意：将红框部分的数字改成在腾讯开放平台申请到的AppId即可。

如果项目集成了微信，还需要添加以下WXEntryActivity，不然的话，mob后台无法做微信的分享统计：（在工程的包下新建wxapi目录再放置WXEntryActivity）

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

　　WXEntryActivity.java代码如下：

 /*
  * 官网地站:http://www.mob.com
  * 技术支持QQ: 4006852216
  * 官方微信:ShareSDK   （如果发布新版本的话，我们将会第一时间通过微信将版本更新内容推送给您。如果使用过程中有任何问题，也可以通过微信与我们取得联系，我们将会在24小时内给予回复）
  *
  * Copyright (c) 2013年 mob.com. All rights reserved.
  */

 package com.example.haoyunhl.controller.wxapi;

 import android.content.Intent;
 import android.widget.Toast;
 import cn.sharesdk.wechat.utils.WXAppExtendObject;
 import cn.sharesdk.wechat.utils.WXMediaMessage;
 import cn.sharesdk.wechat.utils.WechatHandlerActivity;

 /** 微信客户端回调activity示例 */
 public class WXEntryActivity extends WechatHandlerActivity {

     /**
      * 处理微信发出的向第三方应用请求app message
      * <p>
      * 在微信客户端中的聊天页面有“添加工具”，可以将本应用的图标添加到其中
      * 此后点击图标，下面的代码会被执行。Demo仅仅只是打开自己而已，但你可
      * 做点其他的事情，包括根本不打开任何页面
      */
     public void onGetMessageFromWXReq(WXMediaMessage msg) {
         if (msg != null) {
             Intent iLaunchMyself = getPackageManager().getLaunchIntentForPackage(getPackageName());
             startActivity(iLaunchMyself);
         }
     }

     /**
      * 处理微信向第三方应用发起的消息
      * <p>
      * 此处用来接收从微信发送过来的消息，比方说本demo在wechatpage里面分享
      * 应用时可以不分享应用文件，而分享一段应用的自定义信息。接受方的微信
      * 客户端会通过这个方法，将这个信息发送回接收方手机上的本demo中，当作
      * 回调。
      * <p>
      * 本Demo只是将信息展示出来，但你可做点其他的事情，而不仅仅只是Toast
      */
     public void onShowMessageFromWXReq(WXMediaMessage msg) {
         if (msg != null && msg.mediaObject != null
                 && (msg.mediaObject instanceof WXAppExtendObject)) {
             WXAppExtendObject obj = (WXAppExtendObject) msg.mediaObject;
             Toast.makeText(this, obj.extInfo, Toast.LENGTH_SHORT).show();
         }
     }

 }

下面你就可以调用一键分享功能进行简单的分享了，记住在调用之前一点要先调用ShareSDK.initSDK(this)这个方法。

说明：一键分享虽然简单，但是如果想要对一键分享界面进行修改时比较麻烦的，听说现在版本修改界面好像方便很多了？(不清楚，兄弟你可以去集成文档瞧瞧)。下面我就来介绍自定义的分享界面。

4、自定义分享界面的开发

先看效果图：

下面就来详细介绍这个分享界面的开发

界面样式的布局相信大家应该都很熟悉了，我这里就不贴样式布局的代码了。我在开发中将分享功能集成到了一个组件中(ShareDialog)。详细代码如下：

 package com.mobile.develop.framework.dialog;

 import android.app.Dialog;
 import android.content.Context;
 import android.content.DialogInterface.*;
 import android.view.Display;
 import android.view.Gravity;
 import android.view.LayoutInflater;
 import android.view.View;
 import android.view.Window;
 import android.view.WindowManager;
 import android.widget.LinearLayout;
 import android.widget.TextView;
 import com.example.haoyunhl.controller.R;

 public class ShareDialog {
     private Dialog mDialog;
     //取消分享
     private TextView txtCancle;
     private OnClickListener mOnCancleListener;
     //微信分享
     private LinearLayout mWeChatShare;
     private OnClickListener mOnWeChatShareListener;
     //微信朋友圈分享
     private LinearLayout mWeChatFriendShare;
     private OnClickListener mOnWeChatFriendShareListener;
     //QQ分享
     private LinearLayout mQQShare;
     private OnClickListener mOnQQShareListener;
     private Context mContext;
     private Display display;

     public ShareDialog(Context context){
         mContext=context;
         //获取屏幕对象
         WindowManager windowManager = (WindowManager) context.getSystemService(Context.WINDOW_SERVICE);
         display = windowManager.getDefaultDisplay();
     }

     //设置微信分享
     public ShareDialog setOnWeChatShare(OnClickListener weChatShareListener){
         mOnWeChatShareListener=weChatShareListener;
         return this;
     }

     //设置分享朋友圈
     public ShareDialog setOnWeChatFriendShare(OnClickListener weChatFriendShareListener){
         mOnWeChatFriendShareListener=weChatFriendShareListener;
         return this;
     }

     //QQ分享
     public ShareDialog setOnQQShare(OnClickListener qqShareListener){
         mOnQQShareListener=qqShareListener;
         return this;
     }

     public ShareDialog setOnCancleListener(OnClickListener cancleListener){
         mOnCancleListener=cancleListener;
         return this;
     }

     public void show(){
         mDialog.show();
     }

     public void dismiss(){
         mDialog.dismiss();
     }

     /**
      * 创建BaseDialog实例
      * @return
      */
     public ShareDialog builder(){
         LayoutInflater inflater = (LayoutInflater) mContext.getSystemService(Context.LAYOUT_INFLATER_SERVICE);
         View view = inflater.inflate(R.layout.share_dialg_style, null);
         //设置弹出框横向铺满整个屏幕
         view.setMinimumWidth(display.getWidth());
         mDialog = new Dialog(mContext, R.style.ActionSheetDialogStyle);
         //设置dialog弹出后会点击屏幕，dialog不消失；点击物理返回键dialog消失
         mDialog.setCanceledOnTouchOutside(true);
         Window dialogWindow = mDialog.getWindow();
         dialogWindow.setGravity(Gravity.CENTER | Gravity.BOTTOM);
         WindowManager.LayoutParams lp = dialogWindow.getAttributes();
         lp.x = 0;
         lp.y = 0;
         dialogWindow.setAttributes(lp);
         //设置点击隐藏
         txtCancle=(TextView)view.findViewById(R.id.txtCancle);
         txtCancle.setOnClickListener(new View.OnClickListener() {
             @Override
             public void onClick(View v) {
                 if (mOnCancleListener != null) {
                     mOnCancleListener.onClick(mDialog, Dialog.BUTTON_NEGATIVE);
                 }
                 dismiss();
             }
         });
         //微信分享
         mWeChatShare=(LinearLayout)view.findViewById(R.id.mWeChatShare);
         mWeChatShare.setOnClickListener(new View.OnClickListener() {
             @Override
             public void onClick(View v) {
                 if (mOnWeChatShareListener != null) {
                     mOnWeChatShareListener.onClick(mDialog, Dialog.BUTTON_POSITIVE);
                 }
                 dismiss();
             }
         });
         //朋友圈分享
         mWeChatFriendShare=(LinearLayout)view.findViewById(R.id.mWeChatFriendShare);
         mWeChatFriendShare.setOnClickListener(new View.OnClickListener() {
             @Override
             public void onClick(View v) {
                 if(mOnWeChatFriendShareListener!=null) {
                     mOnWeChatFriendShareListener.onClick(mDialog, Dialog.BUTTON_POSITIVE);
                 }
                 dismiss();
             }
         });
         //QQ分享
         mQQShare=(LinearLayout)view.findViewById(R.id.mQQShare);
         mQQShare.setOnClickListener(new View.OnClickListener() {
             @Override
             public void onClick(View v) {
                 if(mOnQQShareListener!=null){
                     mOnQQShareListener.onClick(mDialog,Dialog.BUTTON_POSITIVE);
                 }
             }
         });
         mDialog.setContentView(view);
         return this;
     }
 }

　　我们自定义分享时只需要重写SharePlatform.java即可。在这个文件中通过不同的分支，来执行不同的分享逻辑。代码如下：

 package com.example.haoyunhl.utils;

 import android.app.Activity;
 import android.content.Context;
 import android.os.Handler;
 import android.os.Message;
 import android.widget.Toast;
 import java.util.HashMap;
 import cn.sharesdk.framework.Platform;
 import cn.sharesdk.framework.PlatformActionListener;
 import cn.sharesdk.framework.ShareSDK;
 import cn.sharesdk.tencent.qq.QQ;
 import cn.sharesdk.wechat.friends.Wechat;
 import cn.sharesdk.wechat.moments.WechatMoments;

 public class SharePlatform extends Activity implements PlatformActionListener {

     private Context context;

     public SharePlatform(Context context){
         this.context=context;
         ShareSDK.initSDK(this.context);
     }

     /**
      * 分享回调
      */
     @Override
     public void onCancel(Platform arg0, int arg1) {
         //回调的地方是子线程，进行UI操作要用handle处理
         handler.sendEmptyMessage(4);
     }

     @Override
     public void onComplete(Platform arg0, int arg1, HashMap<String, Object> arg2) {
         //回调的地方是子线程，进行UI操作要用handle处理
         if (arg0.getName().equals(Wechat.NAME)) {
             handler.sendEmptyMessage(1);
         } else if (arg0.getName().equals(WechatMoments.NAME)) {
             handler.sendEmptyMessage(2);
         } else if (arg0.getName().equals(QQ.NAME)) {
             handler.sendEmptyMessage(3);
         }
     }

     @Override
     public void onError(Platform arg0, int arg1, Throwable arg2) {
         //回调的地方是子线程，进行UI操作要用handle处理
         arg2.printStackTrace();
         Message msg = new Message();
         msg.what = 5;
         msg.obj = arg2.getMessage();
         handler.sendMessage(msg);
     }

     Handler handler = new Handler() {
         @Override
         public void handleMessage(Message msg) {
             switch (msg.what) {
                 case 1:
                     Toast.makeText(context, "微信分享成功", Toast.LENGTH_LONG).show();
                     break;
                 case 2:
                     Toast.makeText(context, "朋友圈分享成功", Toast.LENGTH_LONG).show();
                     break;
                 case 3:
                     Toast.makeText(context, "QQ分享成功", Toast.LENGTH_LONG).show();
                     break;
                 case 4:
                     Toast.makeText(context, "取消分享", Toast.LENGTH_LONG).show();
                     break;
                 case 5:
                     Toast.makeText(context, "分享失败", Toast.LENGTH_LONG).show();
                     break;
                 default:
                     break;
             }
         }
     };

     /**
      * 进行分享
      *
      * @param shareType
      * @param shareTitle
      * @param shareText
      * @param shareImageUrl
      * @param shareUrl
      */
     public void share(String shareType, String shareTitle, String shareText, String shareImageUrl, String shareUrl) {
         Platform.ShareParams sharePlatform = new Platform.ShareParams();
         Platform platform;
         /**
          * 如果是微信朋友圈分享
          */
         if(shareType.equalsIgnoreCase(ShareConfig.WeChatMomentsShare)){
             sharePlatform.setShareType(Platform.SHARE_WEBPAGE);

             setSharePlatform(sharePlatform,shareTitle, shareText, shareImageUrl);

             if(shareUrl!=null && !shareUrl.equalsIgnoreCase("")) {
                 sharePlatform.setUrl(shareUrl);
             }

             platform = ShareSDK.getPlatform(WechatMoments.NAME);
             platform.setPlatformActionListener(this);
             platform.share(sharePlatform);
         }
         /**
          * 如果是微信分享
          */
         else if(shareType.equalsIgnoreCase(ShareConfig.WeChatShare)){
             sharePlatform.setShareType(Platform.SHARE_WEBPAGE);

             setSharePlatform(sharePlatform, shareTitle, shareText, shareImageUrl);

             if(shareUrl!=null && !shareUrl.equalsIgnoreCase("")) {
                 sharePlatform.setUrl(shareUrl);
             }
             platform = ShareSDK.getPlatform(Wechat.NAME);
             platform.setPlatformActionListener(this);
             platform.share(sharePlatform);
         }
         /**
          * 如果是QQ分享
          */
         else {
             setSharePlatform(sharePlatform, shareTitle, shareText, shareImageUrl);

             if(shareUrl!=null && !shareUrl.equalsIgnoreCase("")) {
                 sharePlatform.setTitleUrl(shareUrl);
             }

             platform = ShareSDK.getPlatform(QQ.NAME);
             platform.setPlatformActionListener(this);
             platform.share(sharePlatform);
         }
     }

     private void setSharePlatform(Platform.ShareParams sharePlatform,String shareTitle, String shareText, String shareImageUrl){
         sharePlatform.setTitle(shareTitle);
         if(shareText!=null && !shareText.equalsIgnoreCase("")) {
             sharePlatform.setText(shareText);
         }
         if(shareImageUrl!=null && !shareImageUrl.equalsIgnoreCase("")) {
             sharePlatform.setImageUrl(shareImageUrl);
             sharePlatform.setImagePath(shareImageUrl);
         }
     }
 }

　　我们在导航栏中只需要如此调用即可实现分享功能：