一、前言
關(guān)于友盟SDK以前在Android開發(fā)的過程之中就用到過，也是非常常見的第三方SDK,比如友盟分享在很多的應用中都可以用到，也是非常不錯的分享SDK,所以今天抽出時間來總結(jié)下關(guān)于Android客戶端集成友盟分享SDK的一二三，總體來說友盟分享SDK有以下特點：快速具備多平臺分享桑驱、第三方登錄功能，SDK包最小跛蛋，集成成本最低熬的，平臺覆蓋最全，助力產(chǎn)品開發(fā)與推廣赊级。
1押框、U-Share SDK6.0 核心平臺包大小節(jié)約70%，SDK架構(gòu)也全面重構(gòu)了
2此衅、覆蓋國內(nèi)外近30家社交平臺强戴，支持文本、圖片挡鞍、音樂骑歹、視頻、鏈接等多種內(nèi)容類型的分享墨微，并提供了主流游戲平臺的SDK道媚。
國內(nèi)平臺：微信、朋友圈翘县、QQ最域、Qzone、新浪微博锈麸、騰訊微博镀脂、人人、豆瓣忘伞、易信薄翅、短信、郵件等氓奈。
國外平臺：Facebook翘魄、Twitter、Instagram舀奶、Google+暑竟、LINE、WhatsApp育勺、Pinterest但荤、Evernote、
Pocket涧至、LinkedIn纱兑、KakaoTalk等。
3化借、集成成本低潜慎、速度快，規(guī)避平臺差異性蓖康，統(tǒng)一封裝極簡接口铐炫，多個平臺一次搞定。
4蒜焊、提供了標準的分享編輯頁倒信、分享平臺菜單模板，當然我們也可以微調(diào)甚至完全自由定制泳梆。
5鳖悠、借助友盟+ 大數(shù)據(jù)優(yōu)勢榜掌，我們提供業(yè)界最權(quán)威的用戶畫像、分享回流等實時的數(shù)據(jù)分析
二乘综、準備
1憎账、注冊：地址：https://passport.umeng.com/signup?lang=zh_CN
微信圖片_20180515182038.png
2、注冊好之后會跳轉(zhuǎn)到如下界面卡辰，點擊立即使用胞皱，當然有很多種類SDK可供選擇，如有盟統(tǒng)計九妈，友盟分享等：
微信圖片_20180515182406.png
3反砌、申請APP企業(yè)認證
微信圖片_20180515183140.png
4、閱讀友盟分享集成文檔：https://developer.umeng.com/docs/66632/detail/66639
5萌朱、創(chuàng)建應用生成Android 唯一Appkey：
微信圖片_20180515190106.png
三宴树、集成：
集成分為兩種方式：
1、自動集成不多講：目前只支持微信晶疼，QQ森渐，新浪三個平臺
2、手動集成：
1）冒晰、下載最新SDK
2.png
3）壶运、添加回掉Activity
微信：在包名目錄下創(chuàng)建wxapi文件夾耐齐，新建一個名為WXEntryActivity的activity繼承WXCallbackActivity。
支付寶：與微信相似蒋情，支付寶需要在包名目錄下創(chuàng)建apshare文件夾埠况，然后建立一個ShareEntryActivity的類，繼承ShareCallbackActivity棵癣。
釘釘：與微信相似辕翰，釘釘需要在包名目錄下創(chuàng)建ddshare文件夾，然后建立一個DDShareActivity的類狈谊，DingCallBack喜命。
QQ與新浪:QQ與新浪不需要添加Activity，但需要在使用QQ分享或者授權(quán)的Activity中河劝，onActivityResult不可在Fragment當中實現(xiàn)：
@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
//新浪
<activity
android:name="com.umeng.socialize.media.WBShareCallBackActivity"
android:configChanges="keyboardHidden|orientation"
android:theme="@android:style/Theme.Translucent.NoTitleBar"
android:exported="false"
android:screenOrientation="portrait" >
</activity>
<activity android:name="com.sina.weibo.sdk.web.WeiboSdkWebActivity"
android:configChanges="keyboardHidden|orientation"
android:exported="false"
android:windowSoftInputMode="adjustResize">
</activity>
<activity
android:theme="@android:style/Theme.Translucent.NoTitleBar.Fullscreen"
android:launchMode="singleTask"
android:name="com.sina.weibo.sdk.share.WbShareTransActivity">
<intent-filter>
<action android:name="com.sina.weibo.sdk.action.ACTION_SDK_REQ_ACTIVITY" />
<category android:name="android.intent.category.DEFAULT" />
</intent-filter>
</activity>
//微信
<activity
android:name=".wxapi.WXEntryActivity"
android:configChanges="keyboardHidden|orientation|screenSize"
android:exported="true"
android:theme="@android:style/Theme.Translucent.NoTitleBar" />
//支付寶
<activity
android:name=".apshare.ShareEntryActivity"
android:configChanges="keyboardHidden|orientation|screenSize"
android:exported="true"
android:screenOrientation="portrait"
android:theme="@android:style/Theme.Translucent.NoTitleBar" />
//釘釘
<activity
android:name=".ddshare.DingCallBack"
android:configChanges="keyboardHidden|orientation|screenSize"
android:exported="true"
android:screenOrientation="portrait"
android:theme="@android:style/Theme.Translucent.NoTitleBar" />
//qq（請注意將我們的qq appkey替換成您自己的qq appkey）
<activity
android:name="com.tencent.tauth.AuthActivity"
android:launchMode="singleTask"
android:noHistory="true" >
<intent-filter>
<action android:name="android.intent.action.VIEW" />
<category android:name="android.intent.category.DEFAULT" />
<category android:name="android.intent.category.BROWSABLE" />
<data android:scheme="tencent100424468" />
</intent-filter>
</activity>
<activity
android:name="com.tencent.connect.common.AssistActivity"
android:theme="@android:style/Theme.Translucent.NoTitleBar"
android:configChanges="orientation|keyboardHidden|screenSize"/>
//分享編輯頁(只有豆瓣壁榕，人人，騰訊微博赎瞎，領(lǐng)英牌里，twitter需要)
<activity
android:name="com.umeng.socialize.editorpage.ShareActivity"
android:theme="@android:style/Theme.NoTitleBar"
android:excludeFromRecents="true"/>
4）、權(quán)限添加
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
<uses-permission android:name="android.permission.INTERNET" />
//如果需要使用QQ純圖分享或避免其它平臺純圖分享的時候圖片不被壓縮务甥，可以增加以下權(quán)限
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"/>
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE"/>
Android6.0以上設(shè)備動態(tài)權(quán)限請求
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,"");
//設(shè)置友盟的Log開啟
UMConfigure.setLogEnabled(true);
//設(shè)置友盟的Log加密
UMConfigure.setEncryptEnabled(true);
}
6）喳篇、Application中設(shè)置各各平臺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")//分享內(nèi)容
.setCallback(umShareListener)//回調(diào)監(jiān)聽器
.share();
private UMShareListener shareListener = new UMShareListener() {
/**
* @descrption 分享開始的回調(diào)
* @param platform 平臺類型
*/
@Override
public void onStart(SHARE_MEDIA platform) {
}
/**
* @descrption 分享成功的回調(diào)
* @param platform 平臺類型
*/
@Override
public void onResult(SHARE_MEDIA platform) {
Toast.makeText(ShareDetailActivity.this,"成功 了",Toast.LENGTH_LONG).show()；
}
/**
* @descrption 分享失敗的回調(diào)
* @param platform 平臺類型
* @param t 錯誤原因
*/
@Override
public void onError(SHARE_MEDIA platform, Throwable t) {
Toast.makeText(ShareDetailActivity.this,"失 敗"+t.getMessage(),Toast.LENGTH_LONG).show();
}
/**
* @descrption 分享取消的回調(diào)
* @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");//網(wǎng)絡(luò)圖片
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[]);//字節(jié)流
推薦使用網(wǎng)絡(luò)圖片和資源文件的方式洽沟，平臺兼容性更高以故。對于部分平臺，分享的圖片需要設(shè)置縮略圖裆操，縮略圖的設(shè)置規(guī)則為：
用戶設(shè)置的圖片大小最好不要超過250k怒详，縮略圖不要超過18k，如果超過太多（最好不要分享1M以上的圖片踪区，壓縮效率會很低）昆烁，圖片會被壓縮。用戶可以設(shè)置壓縮的方式：
UMImage thumb = new UMImage(this, R.drawable.thumb);
image.setThumb(thumb)缎岗；
image.compressStyle = UMImage.CompressStyle.SCALE;//大小壓縮静尼，默認為大小壓
縮，適合普通很大的圖
image.compressStyle = UMImage.CompressStyle.QUALITY;//質(zhì)量壓縮传泊，適合長圖的分
享壓縮格式設(shè)置
image.compressFormat = Bitmap.CompressFormat.PNG;//用戶分享透明背景的圖片可以
設(shè)置這種方式鼠渺，但是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);//音樂的跳轉(zhuǎn)鏈接
new ShareAction(ShareActivity.this).withMedia(music).share();
特別說明：播放鏈接是指在微信qq分享音樂拓哺，是可以在當前聊天界面播放的，要求這個musicurl（播放鏈接）必須要以.mp3等音樂格式結(jié)尾，跳轉(zhuǎn)鏈接是指點擊linkcard之后進行跳轉(zhuǎn)的鏈接奔害。
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);
//兼容低版本的網(wǎng)頁鏈接
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、第三方登錄包含兩種使用場景：
獲取用戶資料的授權(quán)接口端考，使用該接口可以獲取該三方平臺返回的所有資料（包括姓名雅潭，性別揭厚，頭像等）目前支持第三方登錄的平臺包括：
國內(nèi)平臺（微信、新浪微博扶供、QQ筛圆、豆瓣、人人）
國外平臺（Facebook椿浓、Twitter太援、linkedIn、kakao扳碍、VKontakte提岔、Dropbox）
這里推薦直接使用第一種方式實現(xiàn)，因為本質(zhì)上三方登錄最終都需要拉取三方平臺的用戶資料笋敞，從這點來說碱蒙，直接調(diào)用SDK和通過后臺服務器請求，安全性是一樣的
2夯巷、獲取用戶資料
mShareAPI.getPlatformInfo(UserinfoActivity.this, SHARE_MEDIA.SINA, umAuthListener);
UMAuthListener authListener = new UMAuthListener() {
/**
* @desc 授權(quán)開始的回調(diào)
* @param platform 平臺名稱
*/
@Override
public void onStart(SHARE_MEDIA platform) {
}
/**
* @desc 授權(quán)成功的回調(diào)
* @param platform 平臺名稱
* @param action 行為序號赛惩，開發(fā)者用不上
* @param data 用戶資料返回
*/
@Override
public void onComplete(SHARE_MEDIA platform, int action, Map<String, String> data) {
Toast.makeText(mContext, "成功了", Toast.LENGTH_LONG).show();
}
/**
* @desc 授權(quán)失敗的回調(diào)
* @param platform 平臺名稱
* @param action 行為序號，開發(fā)者用不上
* @param t 錯誤原因
*/
@Override
public void onError(SHARE_MEDIA platform, int action, Throwable t) {
Toast.makeText(mContext, "失敵貌汀：" + t.getMessage(), Toast.LENGTH_LONG).show();
}
/**
* @desc 授權(quán)取消的回調(diào)
* @param platform 平臺名稱
* @param action 行為序號喷兼，開發(fā)者用不上
*/
@Override
public void onCancel(SHARE_MEDIA platform, int action) {
Toast.makeText(mContext, "取消了", Toast.LENGTH_LONG).show();
}
};
3、刪除授權(quán)
UMShareAPI.get(mContext).deleteOauth(Activity, Platform, authListener);