一、前言
关于友盟SDK以前在Android开发的过程之中就用到过，也是非常常见的第三方SDK,比如友盟分享在很多的应用中都可以用到，也是非常不错的分享SDK,所以今天抽出时间来总结下关于Android客户端集成友盟分享SDK的一二三，总体来说友盟分享SDK有以下特点：快速具备多平台分享、第三方登录功能，SDK包最小，集成成本最低，平台覆盖最全，助力产品开发与推广。
1、U-Share SDK6.0 核心平台包大小节约70%，SDK架构也全面重构了
2、覆盖国内外近30家社交平台，支持文本、图片、音乐、视频、链接等多种内容类型的分享，并提供了主流游戏平台的SDK。
国内平台：微信、朋友圈、QQ、Qzone、新浪微博、腾讯微博、人人、豆瓣、易信、短信、邮件等。
国外平台：Facebook、Twitter、Instagram、Google+、LINE、WhatsApp、Pinterest、Evernote、
Pocket、LinkedIn、KakaoTalk等。
3、集成成本低、速度快，规避平台差异性，统一封装极简接口，多个平台一次搞定。
4、提供了标准的分享编辑页、分享平台菜单模板，当然我们也可以微调甚至完全自由定制。
5、借助友盟+ 大数据优势，我们提供业界最权威的用户画像、分享回流等实时的数据分析
二、准备
1、注册：地址：https://passport.umeng.com/signup?lang=zh_CN
微信图片_20180515182038.png
2、注册好之后会跳转到如下界面，点击立即使用，当然有很多种类SDK可供选择，如有盟统计，友盟分享等：
微信图片_20180515182406.png
3、申请APP企业认证
微信图片_20180515183140.png
4、阅读友盟分享集成文档：https://developer.umeng.com/docs/66632/detail/66639
5、创建应用生成Android 唯一Appkey：
微信图片_20180515190106.png
三、集成：
集成分为两种方式：
1、自动集成不多讲：目前只支持微信，QQ，新浪三个平台
2、手动集成：
1）、下载最新SDK
2.png
3）、添加回掉Activity
微信：在包名目录下创建wxapi文件夹，新建一个名为WXEntryActivity的activity继承WXCallbackActivity。
支付宝：与微信相似，支付宝需要在包名目录下创建apshare文件夹，然后建立一个ShareEntryActivity的类，继承ShareCallbackActivity。
钉钉：与微信相似，钉钉需要在包名目录下创建ddshare文件夹，然后建立一个DDShareActivity的类，DingCallBack。
QQ与新浪:QQ与新浪不需要添加Activity，但需要在使用QQ分享或者授权的Activity中，onActivityResult不可在Fragment当中实现：
@Override
protected void onActivityResult(int requestCode, int resultCode, Intent data) {
super.onActivityResult(requestCode, resultCode, data);
UMShareAPI.get(this).onActivityResult(requestCode, resultCode, data);
}
配置Android Manifest XML
sdk中需要的Activity
//新浪
//微信
4）、权限添加
Android6.0以上设备动态权限请求
if(Build.VERSION.SDK_INT>=23){
String[] mPermissionList = new String[]{Manifest.permission.WRITE_EXTERNAL_STORAGE,Manifest.permission.ACCESS_FINE_LOCATION,Manifest.permission.CALL_PHONE,Manifest.permission.READ_LOGS,Manifest.permission.READ_PHONE_STATE, Manifest.permission.READ_EXTERNAL_STORAGE,Manifest.permission.SET_DEBUG_APP,Manifest.permission.SYSTEM_ALERT_WINDOW,Manifest.permission.GET_ACCOUNTS,Manifest.permission.WRITE_APN_SETTINGS};
ActivityCompat.requestPermissions(this,mPermissionList,123);
}
@Override
public void onRequestPermissionsResult(int requestCode,
String permissions[], int[] grantResults) {
}
5）、初始化配置
@Override
public void onCreate() {
super.onCreate();
UMConfigure.init(this,"5a12384aa40fa3551f0001d1","umeng",
UMConfigure.DEVICE_TYPE_PHONE,"");
//设置友盟的Log开启
UMConfigure.setLogEnabled(true);
//设置友盟的Log加密
UMConfigure.setEncryptEnabled(true);
}
6）、Application中设置各各平台appkey:appkey需要去微信等各平台申请
PlatformConfig.setWeixin("wxdc1e388c3822c80b", "3baf1193c85774b3fd9d18447d76cab0");
//豆瓣RENREN平台目前只能在服务器端配置
PlatformConfig.setSinaWeibo("3921700954", "04b48b094faeb16683c32669824ebdad","http://sns.whalecloud.com");
PlatformConfig.setYixin("yxc0614e80c9304c11b0391514d09f13bf");
PlatformConfig.setQQZone("100424468", "c7394704798a158208a74ab60104f0ba");
PlatformConfig.setTwitter("3aIN7fuF685MuZ7jtXkQxalyi", "MK6FEYG63eWcpDFgRYw4w9puJhzDl0tyuqWjZ3M7XJuuG7mMbO");
PlatformConfig.setAlipay("2015111700822536");
PlatformConfig.setLaiwang("laiwangd497e70d4", "d497e70d4c3e4efeab1381476bac4c5e");
PlatformConfig.setPinterest("1439206");
PlatformConfig.setKakao("e4f60e065048eb031e235c806b31c70f");
PlatformConfig.setDing("dingoalmlnohc0wggfedpk");
PlatformConfig.setVKontakte("5764965","5My6SNliAaLxEm3Lyd9J");
PlatformConfig.setDropbox("oz8v5apet3arcdy","h7p2pjbzkkxt02a");
PlatformConfig.setYnote("9c82bf470cba7bd2f1819b0ee26f86c6ce670e9b");
7）、签名配置：不添加签名部分平台可能不可用
8）、代码混淆：https://developer.umeng.com/docs/66632/detail/66639#h2-u521Du59CBu5316u8BBEu7F6E9
三、分享
1、带面板
new ShareAction(MainActivity.this).withText("hello")
.setDisplayList(SHARE_MEDIA.SINA,SHARE_MEDIA.QQ,SHARE_MEDIA.WEIXIN)
.setCallback(umShareListener).open();
2、不带面板
new ShareAction(MainActivity.this)
.setPlatform(SHARE_MEDIA.QQ)//传入平台
.withText("hello")//分享内容
.setCallback(umShareListener)//回调监听器
.share();
private UMShareListener shareListener = new UMShareListener() {
/**
* @descrption 分享开始的回调
* @param platform 平台类型
*/
@Override
public void onStart(SHARE_MEDIA platform) {
}
/**
* @descrption 分享成功的回调
* @param platform 平台类型
*/
@Override
public void onResult(SHARE_MEDIA platform) {
Toast.makeText(ShareDetailActivity.this,"成功 了",Toast.LENGTH_LONG).show()；
}
/**
* @descrption 分享失败的回调
* @param platform 平台类型
* @param t 错误原因
*/
@Override
public void onError(SHARE_MEDIA platform, Throwable t) {
Toast.makeText(ShareDetailActivity.this,"失 败"+t.getMessage(),Toast.LENGTH_LONG).show();
}
/**
* @descrption 分享取消的回调
* @param platform 平台类型
*/
@Override
public void onCancel(SHARE_MEDIA platform) {
Toast.makeText(ShareDetailActivity.this,"取消 了",Toast.LENGTH_LONG).show();
}
};
3、分享的消息类型
1）、文本
new ShareAction(ShareActivity.this).withText("hello").withMedia(image).share();
2）、图片
种类：
UMImage image = new UMImage(ShareActivity.this, "imageurl");//网络图片
UMImage image = new UMImage(ShareActivity.this, file);//本地文件
UMImage image = new UMImage(ShareActivity.this, R.drawable.xxx);//资源文件
UMImage image = new UMImage(ShareActivity.this, bitmap);//bitmap文件
UMImage image = new UMImage(ShareActivity.this, byte[]);//字节流
推荐使用网络图片和资源文件的方式，平台兼容性更高。对于部分平台，分享的图片需要设置缩略图，缩略图的设置规则为：
用户设置的图片大小最好不要超过250k，缩略图不要超过18k，如果超过太多（最好不要分享1M以上的图片，压缩效率会很低），图片会被压缩。用户可以设置压缩的方式：
UMImage thumb = new UMImage(this, R.drawable.thumb);
image.setThumb(thumb)；
image.compressStyle = UMImage.CompressStyle.SCALE;//大小压缩，默认为大小压
缩，适合普通很大的图
image.compressStyle = UMImage.CompressStyle.QUALITY;//质量压缩，适合长图的分
享压缩格式设置
image.compressFormat = Bitmap.CompressFormat.PNG;//用户分享透明背景的图片可以
设置这种方式，但是qq好友，微信朋友圈，不支持透明背景图片，会变成黑色
newShareAction(ShareDetailActivity.this)
.withMedias(imagelocal,imagelocal,imagelocall)
.setPlatform(share_media)
.withText("hello")
.setCallback(shareListener).share();
3、链接
UMWeb web = new UMWeb(Defaultcontent.url);
web.setTitle("This is music title");//标题
web.setThumb(thumb); //缩略图
web.setDescription("my description");//描述
new ShareAction(ShareActivity.this)
.withMedia(web)
.share();
4、视频
UMVideo video = new UMVideo(videourl);
video.setTitle("This is music title");//视频的标题
video.setThumb("http://www.umeng.com/images/pic/social/chart_1.png");//视频的缩略图
video.setDescription("my description");//视频的描述
new ShareAction(ShareActivity.this).withText("hello").withMedia(video).share();
5、音乐
UMusic music = new UMusic(musicurl);//音乐的播放链接
music.setTitle("This is music title");//音乐的标题
music.setThumb("http://www.umeng.com/images/pic/social/chart_1.png");//音乐的缩
略图
music.setDescription("my description");//音乐的描述
music.setmTargetUrl(Defaultcontent.url);//音乐的跳转链接
new ShareAction(ShareActivity.this).withMedia(music).share();
特别说明：播放链接是指在微信qq分享音乐，是可以在当前聊天界面播放的，要求这个musicurl（播放链接）必须要以.mp3等音乐格式结尾，跳转链接是指点击linkcard之后进行跳转的链接。
6、GIF
UMEmoji emoji = new
UMEmoji(this,
"http://img5.imgtn.bdimg.com/it/u=2749190246,3857616763&fm=21&gp=0.jpg");
emoji.setThumb(new UMImage(this, R.drawable.thumb));
new ShareAction(ShareActivity.this)
.withMedia(emoji).share();
7、微信小程序
UMMin umMin = new UMMin(Defaultcontent.url);
//兼容低版本的网页链接
umMin.setThumb(imagelocal);
// 小程序消息封面图片
umMin.setTitle(Defaultcontent.title);
// 小程序消息title
umMin.setDescription(Defaultcontent.text);
// 小程序消息描述
umMin.setPath("pages/page10007/xxxxxx");
//小程序页面路径
umMin.setUserName("gh_xxxxxxxxxxxx");
// 小程序原始id,在微信平台查询
new ShareAction(ShareDetailActivity.this)
.withMedia(umMin)
.setPlatform(share_media)
.setCallback(shareListener).share();
四、第三方登入
1、第三方登录包含两种使用场景：
获取用户资料的授权接口，使用该接口可以获取该三方平台返回的所有资料（包括姓名，性别，头像等）目前支持第三方登录的平台包括：
国内平台（微信、新浪微博、QQ、豆瓣、人人）
国外平台（Facebook、Twitter、linkedIn、kakao、VKontakte、Dropbox）
这里推荐直接使用第一种方式实现，因为本质上三方登录最终都需要拉取三方平台的用户资料，从这点来说，直接调用SDK和通过后台服务器请求，安全性是一样的
2、获取用户资料
mShareAPI.getPlatformInfo(UserinfoActivity.this, SHARE_MEDIA.SINA, umAuthListener);
UMAuthListener authListener = new UMAuthListener() {
/**
* @desc 授权开始的回调
* @param platform 平台名称
*/
@Override
public void onStart(SHARE_MEDIA platform) {
}
/**
* @desc 授权成功的回调
* @param platform 平台名称
* @param action 行为序号，开发者用不上
* @param data 用户资料返回
*/
@Override
public void onComplete(SHARE_MEDIA platform, int action, Map data) {
Toast.makeText(mContext, "成功了", Toast.LENGTH_LONG).show();
}
/**
* @desc 授权失败的回调
* @param platform 平台名称
* @param action 行为序号，开发者用不上
* @param t 错误原因
*/
@Override
public void onError(SHARE_MEDIA platform, int action, Throwable t) {
Toast.makeText(mContext, "失败：" + t.getMessage(), Toast.LENGTH_LONG).show();
}
/**
* @desc 授权取消的回调
* @param platform 平台名称
* @param action 行为序号，开发者用不上
*/
@Override
public void onCancel(SHARE_MEDIA platform, int action) {
Toast.makeText(mContext, "取消了", Toast.LENGTH_LONG).show();
}
};
3、删除授权
UMShareAPI.get(mContext).deleteOauth(Activity, Platform, authListener);