引言java
如今APP开发集成分享功能已是很是广泛的需求了。其余集成分享技术我没有使用过,今天我就来介绍下使用ShareSDK来进行分享功能开发的一些基本步骤和注意点,帮助朋友们避免一些坑。好了,下面切入正题正式开始介绍。android
一、ShareSDK开发包及配置api
这个不用多说,去他们官网看找SDK开发包和集成文档便可。Android版本地址:http://www.mob.com/downloadDetail/ShareSDK/android。注意:记得要注册ShareSDK帐号获取AppKey哦。这些集成文档里面应该都有,仔细看便可。微信
二、去各大应用平台注册获取AppKey和AppSecret微信开发
这个步骤要看大家团队想分享到哪些平台了,通常都是微博和微信。因此通常都去新浪微博和微信开发平台注册。app
新浪开发平台:http://open.weibo.com/ide
腾讯开放平台:https://open.weixin.qq.com/工具
三、一键分享功能的集成布局
使用ShareSDK进行分享,若是你不须要进行定制开发的话,就可使用ShareSDK里面自带的一键分享模块。使用以前别忘记把ShareSDK中的jar包和ShareSDK.xml放到指定位置哦(配置文档里面都有,慢慢看便可)。ui
在application节点下注册下面的Activity如图所示:
注意:将红框部分的数字改为在腾讯开放平台申请到的AppId便可。
若是项目集成了微信,还须要添加如下WXEntryActivity,否则的话,mob后台没法作微信的分享统计:(在工程的包下新建wxapi目录再放置WXEntryActivity)
1 <!-- 微信分享配置 --> 2 <activity 3 android:name=".wxapi.WXEntryActivity" 4 android:configChanges="keyboardHidden|orientation|screenSize" 5 android:exported="true" 6 android:screenOrientation="portrait" 7 android:theme="@android:style/Theme.Translucent.NoTitleBar" />
WXEntryActivity.java代码以下:
1 /* 2 * 官网地站:http://www.mob.com 3 * 技术支持QQ: 4006852216 4 * 官方微信:ShareSDK (若是发布新版本的话,咱们将会第一时间经过微信将版本更新内容推送给您。若是使用过程当中有任何问题,也能够经过微信与咱们取得联系,咱们将会在24小时内给予回复) 5 * 6 * Copyright (c) 2013年 mob.com. All rights reserved. 7 */ 8 9 package com.example.haoyunhl.controller.wxapi; 10 11 import android.content.Intent; 12 import android.widget.Toast; 13 import cn.sharesdk.wechat.utils.WXAppExtendObject; 14 import cn.sharesdk.wechat.utils.WXMediaMessage; 15 import cn.sharesdk.wechat.utils.WechatHandlerActivity; 16 17 /** 微信客户端回调activity示例 */ 18 public class WXEntryActivity extends WechatHandlerActivity { 19 20 /** 21 * 处理微信发出的向第三方应用请求app message 22 * <p> 23 * 在微信客户端中的聊天页面有“添加工具”,能够将本应用的图标添加到其中 24 * 此后点击图标,下面的代码会被执行。Demo仅仅只是打开本身而已,但你可 25 * 作点其余的事情,包括根本不打开任何页面 26 */ 27 public void onGetMessageFromWXReq(WXMediaMessage msg) { 28 if (msg != null) { 29 Intent iLaunchMyself = getPackageManager().getLaunchIntentForPackage(getPackageName()); 30 startActivity(iLaunchMyself); 31 } 32 } 33 34 /** 35 * 处理微信向第三方应用发起的消息 36 * <p> 37 * 此处用来接收从微信发送过来的消息,比方说本demo在wechatpage里面分享 38 * 应用时能够不分享应用文件,而分享一段应用的自定义信息。接受方的微信 39 * 客户端会经过这个方法,将这个信息发送回接收方手机上的本demo中,看成 40 * 回调。 41 * <p> 42 * 本Demo只是将信息展现出来,但你可作点其余的事情,而不只仅只是Toast 43 */ 44 public void onShowMessageFromWXReq(WXMediaMessage msg) { 45 if (msg != null && msg.mediaObject != null 46 && (msg.mediaObject instanceof WXAppExtendObject)) { 47 WXAppExtendObject obj = (WXAppExtendObject) msg.mediaObject; 48 Toast.makeText(this, obj.extInfo, Toast.LENGTH_SHORT).show(); 49 } 50 } 51 52 }
下面你就能够调用一键分享功能进行简单的分享了,记住在调用以前一点要先调用ShareSDK.initSDK(this)这个方法。
说明:一键分享虽然简单,可是若是想要对一键分享界面进行修改时比较麻烦的,据说如今版本修改界面好像方便不少了?(不清楚,兄弟你能够去集成文档瞧瞧)。下面我就来介绍自定义的分享界面。
四、自定义分享界面的开发
先看效果图:
下面就来详细介绍这个分享界面的开发
界面样式的布局相信你们应该都很熟悉了,我这里就不贴样式布局的代码了。我在开发中将分享功能集成到了一个组件中(ShareDialog)。详细代码以下:
1 package com.mobile.develop.framework.dialog; 2 3 import android.app.Dialog; 4 import android.content.Context; 5 import android.content.DialogInterface.*; 6 import android.view.Display; 7 import android.view.Gravity; 8 import android.view.LayoutInflater; 9 import android.view.View; 10 import android.view.Window; 11 import android.view.WindowManager; 12 import android.widget.LinearLayout; 13 import android.widget.TextView; 14 import com.example.haoyunhl.controller.R; 15 16 public class ShareDialog { 17 private Dialog mDialog; 18 //取消分享 19 private TextView txtCancle; 20 private OnClickListener mOnCancleListener; 21 //微信分享 22 private LinearLayout mWeChatShare; 23 private OnClickListener mOnWeChatShareListener; 24 //微信朋友圈分享 25 private LinearLayout mWeChatFriendShare; 26 private OnClickListener mOnWeChatFriendShareListener; 27 //QQ分享 28 private LinearLayout mQQShare; 29 private OnClickListener mOnQQShareListener; 30 private Context mContext; 31 private Display display; 32 33 public ShareDialog(Context context){ 34 mContext=context; 35 //获取屏幕对象 36 WindowManager windowManager = (WindowManager) context.getSystemService(Context.WINDOW_SERVICE); 37 display = windowManager.getDefaultDisplay(); 38 } 39 40 //设置微信分享 41 public ShareDialog setOnWeChatShare(OnClickListener weChatShareListener){ 42 mOnWeChatShareListener=weChatShareListener; 43 return this; 44 } 45 46 //设置分享朋友圈 47 public ShareDialog setOnWeChatFriendShare(OnClickListener weChatFriendShareListener){ 48 mOnWeChatFriendShareListener=weChatFriendShareListener; 49 return this; 50 } 51 52 //QQ分享 53 public ShareDialog setOnQQShare(OnClickListener qqShareListener){ 54 mOnQQShareListener=qqShareListener; 55 return this; 56 } 57 58 public ShareDialog setOnCancleListener(OnClickListener cancleListener){ 59 mOnCancleListener=cancleListener; 60 return this; 61 } 62 63 public void show(){ 64 mDialog.show(); 65 } 66 67 public void dismiss(){ 68 mDialog.dismiss(); 69 } 70 71 /** 72 * 建立BaseDialog实例 73 * @return 74 */ 75 public ShareDialog builder(){ 76 LayoutInflater inflater = (LayoutInflater) mContext.getSystemService(Context.LAYOUT_INFLATER_SERVICE); 77 View view = inflater.inflate(R.layout.share_dialg_style, null); 78 //设置弹出框横向铺满整个屏幕 79 view.setMinimumWidth(display.getWidth()); 80 mDialog = new Dialog(mContext, R.style.ActionSheetDialogStyle); 81 //设置dialog弹出后会点击屏幕,dialog不消失;点击物理返回键dialog消失 82 mDialog.setCanceledOnTouchOutside(true); 83 Window dialogWindow = mDialog.getWindow(); 84 dialogWindow.setGravity(Gravity.CENTER | Gravity.BOTTOM); 85 WindowManager.LayoutParams lp = dialogWindow.getAttributes(); 86 lp.x = 0; 87 lp.y = 0; 88 dialogWindow.setAttributes(lp); 89 //设置点击隐藏 90 txtCancle=(TextView)view.findViewById(R.id.txtCancle); 91 txtCancle.setOnClickListener(new View.OnClickListener() { 92 @Override 93 public void onClick(View v) { 94 if (mOnCancleListener != null) { 95 mOnCancleListener.onClick(mDialog, Dialog.BUTTON_NEGATIVE); 96 } 97 dismiss(); 98 } 99 }); 100 //微信分享 101 mWeChatShare=(LinearLayout)view.findViewById(R.id.mWeChatShare); 102 mWeChatShare.setOnClickListener(new View.OnClickListener() { 103 @Override 104 public void onClick(View v) { 105 if (mOnWeChatShareListener != null) { 106 mOnWeChatShareListener.onClick(mDialog, Dialog.BUTTON_POSITIVE); 107 } 108 dismiss(); 109 } 110 }); 111 //朋友圈分享 112 mWeChatFriendShare=(LinearLayout)view.findViewById(R.id.mWeChatFriendShare); 113 mWeChatFriendShare.setOnClickListener(new View.OnClickListener() { 114 @Override 115 public void onClick(View v) { 116 if(mOnWeChatFriendShareListener!=null) { 117 mOnWeChatFriendShareListener.onClick(mDialog, Dialog.BUTTON_POSITIVE); 118 } 119 dismiss(); 120 } 121 }); 122 //QQ分享 123 mQQShare=(LinearLayout)view.findViewById(R.id.mQQShare); 124 mQQShare.setOnClickListener(new View.OnClickListener() { 125 @Override 126 public void onClick(View v) { 127 if(mOnQQShareListener!=null){ 128 mOnQQShareListener.onClick(mDialog,Dialog.BUTTON_POSITIVE); 129 } 130 } 131 }); 132 mDialog.setContentView(view); 133 return this; 134 } 135 }
咱们自定义分享时只须要重写SharePlatform.java便可。在这个文件中经过不一样的分支,来执行不一样的分享逻辑。代码以下:
1 package com.example.haoyunhl.utils; 2 3 import android.app.Activity; 4 import android.content.Context; 5 import android.os.Handler; 6 import android.os.Message; 7 import android.widget.Toast; 8 import java.util.HashMap; 9 import cn.sharesdk.framework.Platform; 10 import cn.sharesdk.framework.PlatformActionListener; 11 import cn.sharesdk.framework.ShareSDK; 12 import cn.sharesdk.tencent.qq.QQ; 13 import cn.sharesdk.wechat.friends.Wechat; 14 import cn.sharesdk.wechat.moments.WechatMoments; 15 16 public class SharePlatform extends Activity implements PlatformActionListener { 17 18 private Context context; 19 20 public SharePlatform(Context context){ 21 this.context=context; 22 ShareSDK.initSDK(this.context); 23 } 24 25 /** 26 * 分享回调 27 */ 28 @Override 29 public void onCancel(Platform arg0, int arg1) { 30 //回调的地方是子线程,进行UI操做要用handle处理 31 handler.sendEmptyMessage(4); 32 } 33 34 @Override 35 public void onComplete(Platform arg0, int arg1, HashMap<String, Object> arg2) { 36 //回调的地方是子线程,进行UI操做要用handle处理 37 if (arg0.getName().equals(Wechat.NAME)) { 38 handler.sendEmptyMessage(1); 39 } else if (arg0.getName().equals(WechatMoments.NAME)) { 40 handler.sendEmptyMessage(2); 41 } else if (arg0.getName().equals(QQ.NAME)) { 42 handler.sendEmptyMessage(3); 43 } 44 } 45 46 @Override 47 public void onError(Platform arg0, int arg1, Throwable arg2) { 48 //回调的地方是子线程,进行UI操做要用handle处理 49 arg2.printStackTrace(); 50 Message msg = new Message(); 51 msg.what = 5; 52 msg.obj = arg2.getMessage(); 53 handler.sendMessage(msg); 54 } 55 56 Handler handler = new Handler() { 57 @Override 58 public void handleMessage(Message msg) { 59 switch (msg.what) { 60 case 1: 61 Toast.makeText(context, "微信分享成功", Toast.LENGTH_LONG).show(); 62 break; 63 case 2: 64 Toast.makeText(context, "朋友圈分享成功", Toast.LENGTH_LONG).show(); 65 break; 66 case 3: 67 Toast.makeText(context, "QQ分享成功", Toast.LENGTH_LONG).show(); 68 break; 69 case 4: 70 Toast.makeText(context, "取消分享", Toast.LENGTH_LONG).show(); 71 break; 72 case 5: 73 Toast.makeText(context, "分享失败", Toast.LENGTH_LONG).show(); 74 break; 75 default: 76 break; 77 } 78 } 79 }; 80 81 82 /** 83 * 进行分享 84 * 85 * @param shareType 86 * @param shareTitle 87 * @param shareText 88 * @param shareImageUrl 89 * @param shareUrl 90 */ 91 public void share(String shareType, String shareTitle, String shareText, String shareImageUrl, String shareUrl) { 92 Platform.ShareParams sharePlatform = new Platform.ShareParams(); 93 Platform platform; 94 /** 95 * 若是是微信朋友圈分享 96 */ 97 if(shareType.equalsIgnoreCase(ShareConfig.WeChatMomentsShare)){ 98 sharePlatform.setShareType(Platform.SHARE_WEBPAGE); 99 100 setSharePlatform(sharePlatform,shareTitle, shareText, shareImageUrl); 101 102 if(shareUrl!=null && !shareUrl.equalsIgnoreCase("")) { 103 sharePlatform.setUrl(shareUrl); 104 } 105 106 platform = ShareSDK.getPlatform(WechatMoments.NAME); 107 platform.setPlatformActionListener(this); 108 platform.share(sharePlatform); 109 } 110 /** 111 * 若是是微信分享 112 */ 113 else if(shareType.equalsIgnoreCase(ShareConfig.WeChatShare)){ 114 sharePlatform.setShareType(Platform.SHARE_WEBPAGE); 115 116 setSharePlatform(sharePlatform, shareTitle, shareText, shareImageUrl); 117 118 if(shareUrl!=null && !shareUrl.equalsIgnoreCase("")) { 119 sharePlatform.setUrl(shareUrl); 120 } 121 platform = ShareSDK.getPlatform(Wechat.NAME); 122 platform.setPlatformActionListener(this); 123 platform.share(sharePlatform); 124 } 125 /** 126 * 若是是QQ分享 127 */ 128 else { 129 setSharePlatform(sharePlatform, shareTitle, shareText, shareImageUrl); 130 131 if(shareUrl!=null && !shareUrl.equalsIgnoreCase("")) { 132 sharePlatform.setTitleUrl(shareUrl); 133 } 134 135 platform = ShareSDK.getPlatform(QQ.NAME); 136 platform.setPlatformActionListener(this); 137 platform.share(sharePlatform); 138 } 139 } 140 141 142 private void setSharePlatform(Platform.ShareParams sharePlatform,String shareTitle, String shareText, String shareImageUrl){ 143 sharePlatform.setTitle(shareTitle); 144 if(shareText!=null && !shareText.equalsIgnoreCase("")) { 145 sharePlatform.setText(shareText); 146 } 147 if(shareImageUrl!=null && !shareImageUrl.equalsIgnoreCase("")) { 148 sharePlatform.setImageUrl(shareImageUrl); 149 sharePlatform.setImagePath(shareImageUrl); 150 } 151 } 152 }
咱们在导航栏中只须要如此调用便可实现分享功能: