前言
最近項目中需要分享功能,就集成官方的分享,特此記錄下,便于自己后續(xù)回顧。
注意:我都是分享的網址即URL,其他分享類似
微信分享
微信開放平臺:https://open.weixin.qq.com
官方文檔:https://open.weixin.qq.com/cgi-bin/showdocument?action=dir_list&t=resource/res_list&verify=1&id=open1419317340&token=&lang=zh_CN
- 首先,你需要在開放平臺創(chuàng)建你的應用,需要填應用的簽名,這個簽名是要你應用的正式簽名,不要弄錯。我覺得可靠的辦法就是在你手機上裝上簽名工具,然后在手機上裝上你正式的應用,不是debug的,然后在簽名工具中輸入你的包名,下面就會顯示簽名了。
審核通過了,獲取APP_ID后才能繼續(xù)開發(fā)工作。 - 添加依賴
dependencies {
compile 'com.tencent.mm.opensdk:wechat-sdk-android-with-mta:+'
}
- 添加相應的權限
<uses-permission android:name="android.permission.INTERNET"/>
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/>
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE"/>
<uses-permission android:name="android.permission.READ_PHONE_STATE"/>
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"/>
- 注冊到微信
要使你的程序啟動后微信終端能響應你的程序,必須在代碼中向微信終端注冊你的id。可以在程序入口Activity的onCreate中寫代碼:
private IWXAPI iwxapi;
iwxapi = WXAPIFactory.createWXAPI(this, GlobalConfig.WEIXIN_APP_ID);
iwxapi.registerApp(GlobalConfig.WEIXIN_APP_ID);
- 分享網頁
// 微信分享網頁
private void shareWeb(boolean isToFriend) {
WXWebpageObject webpage = new WXWebpageObject();
webpage.webpageUrl = "你的網頁地址url";
WXMediaMessage msg = new WXMediaMessage(webpage);
msg.title = "網頁標題";
msg.description = "網頁描述";
Bitmap thumb = BitmapFactory.decodeResource(getResources(), R.drawable.aa);
msg.thumbData = bmpToByteArray(thumb);
// 構造一個Req
SendMessageToWX.Req req = new SendMessageToWX.Req();
// transaction字段用于唯一標識一個請求
req.transaction = buildTransaction("webpage");
req.message = msg;
req.scene = isToFriend ? SendMessageToWX.Req.WXSceneSession : SendMessageToWX.Req.WXSceneTimeline;
iwxapi.sendReq(req);
}
private byte[] bmpToByteArray(Bitmap bmp) {
ByteArrayOutputStream output = new ByteArrayOutputStream();
bmp.compress(Bitmap.CompressFormat.PNG, 100, output);
byte[] result = output.toByteArray();
try {
output.close();
} catch (Exception e) {
e.printStackTrace();
}
return result;
}
private static String buildTransaction(String type) {
return (type == null) ? String.valueOf(System.currentTimeMillis()) : (type + System.currentTimeMillis());
}
此時已經可以分享成功了,測試需要用正式的包測試,不然會被微信拒絕。如果不小心用了debug辦的測試了,微信可能會存在緩存,這樣你即使用正式版的有可能也會被拒,這就需要你在微信中清理下數據。然后分享就ok了。
還有一點就是,我在開發(fā)過程中只想分享單一的url,所以我將msg.title和msg.description都置為空字符串。并且將msg.thumbData也注釋掉,這樣就不能分享了,后來我試了幾次發(fā)現這幾個值都不能缺,并且有的值不能置為空串。
- 分享是否成功的回調
- 在你的包名下新建一個包wxapi,固定的大小寫不要寫錯。比如你的包名是com.aa,那就新建com.aa.wxapi
- 在這個包下創(chuàng)建一個名為WXEntryActivity的activity,繼承activity,實現IWXAPIEventHandler接口。
- 在AndroidManifest.xml中加入
android:exported="true"
/**
* 微信分享回調Activity
*/
public class WXEntryActivity extends AppCompatActivity implements IWXAPIEventHandler {
private IWXAPI iwxapi;
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_wxentry);
iwxapi = WXAPIFactory.createWXAPI(this, GlobalConfig.WEIXIN_APP_ID, false);
iwxapi.handleIntent(getIntent(), this);
}
@Override
protected void onNewIntent(Intent intent) {
super.onNewIntent(intent);
setIntent(intent);
iwxapi.handleIntent(intent, this);
}
@Override
public void onReq(BaseReq baseReq) {
}
// APP請求微信響應結果回調
@Override
public void onResp(BaseResp baseResp) {
switch (baseResp.errCode) {
case BaseResp.ErrCode.ERR_OK:
ToastUtil.showShortToast(WXEntryActivity.this, "分享成功");
break;
case BaseResp.ErrCode.ERR_USER_CANCEL:
ToastUtil.showShortToast(WXEntryActivity.this, "分享被取消");
break;
case BaseResp.ErrCode.ERR_AUTH_DENIED:
ToastUtil.showShortToast(WXEntryActivity.this, "分享被拒絕");
break;
}
finish(); // 注意在:如果不finishing會有一層白色的activity
}
}
QQ和QQ空間分享
騰訊開放平臺:http://open.qq.com
官方文檔:http://wiki.open.qq.com/index.php?title=Android_API調用說明&=45038#1.13_.E5.88.86.E4.BA.AB.E6.B6.88.E6.81.AF.E5.88.B0QQ.EF.BC.88.E6.97.A0.E9.9C.80QQ.E7.99.BB.E5.BD.95.EF.BC.89
- 注冊騰訊開放平臺賬號,登錄后創(chuàng)建自己的應用,等待審核,審核后獲取APP_ID,后續(xù)使用。
- 下載騰訊的SDK,下載地址:http://wiki.open.qq.com/wiki/mobile/SDK下載
下載后解決包,如下圖:
屏幕快照 2017-07-10 下午4.25.09.png
將jar包放在你項目的libs目錄下,并右鍵Add as library。 - 添加權限
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
在AndroidManifest.xml 文件的application節(jié)點內加入如下內容
<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="tencent你的appid" />
</intent-filter>
</activity>
<activity
android:name="com.tencent.connect.common.AssistActivity"
android:screenOrientation="portrait"
android:theme="@android:style/Theme.Translucent.NoTitleBar" />
- 創(chuàng)建Tencent實例
mTencent = Tencent.createInstance(你的APP_ID, this.getApplicationContext());
- 設置分享回調
private IUiListener mIUiListener;
// oncreat方法中實例化mIUiListener = new MyShareListener();
// 自定義QQ分享回調接口
private class MyShareListener implements IUiListener {
@Override
public void onComplete(Object o) {
// 分享成功
ToastUtil.showShortToast(NewForwardDetailActivity.this, "分享成功");
}
@Override
public void onError(UiError uiError) {
// 分享錯誤
ToastUtil.showShortToast(NewForwardDetailActivity.this, "分享失敗");
}
@Override
public void onCancel() {
// 取消分享
ToastUtil.showShortToast(NewForwardDetailActivity.this, "取消分享");
}
}
在onActivityResult中監(jiān)測分享狀態(tài)
@Override
protected void onActivityResult(int requestCode, int resultCode, Intent data) {
super.onActivityResult(requestCode, resultCode, data);
Tencent.onActivityResultData(requestCode, resultCode, data, mIUiListener);
if (requestCode == Constants.REQUEST_API) {
if (resultCode == Constants.REQUEST_QQ_SHARE || resultCode == Constants.REQUEST_QZONE_SHARE || resultCode == Constants.REQUEST_OLD_SHARE) {
Tencent.handleResultData(data, mIUiListener);
}
}
}
- 分享到 QQ和QQ空間
private void shareToQQ() {
Bundle params = new Bundle();
params.putInt(QQShare.SHARE_TO_QQ_KEY_TYPE, QQShare.SHARE_TO_QQ_TYPE_DEFAULT);
params.putString(QQShare.SHARE_TO_QQ_TITLE, "醫(yī)生工作站");// 標題
params.putString(QQShare.SHARE_TO_QQ_SUMMARY, "最新前沿文章推薦閱讀");// 摘要
params.putString(QQShare.SHARE_TO_QQ_TARGET_URL, shareUrl);// 內容地址
// params.putString(QQShare.SHARE_TO_QQ_IMAGE_URL, "http://imgcache.qq.com/qzone/space_item/pre/0/66768.gif");// 網絡圖片地址
params.putString(QQShare.SHARE_TO_QQ_APP_NAME, "醫(yī)師工作站");// 應用名稱
// params.putString(QQShare.SHARE_TO_QQ_EXT_INT, "其它附加功能");
// 分享操作要在主線程中完成
mTencent.shareToQQ(NewForwardDetailActivity.this, params, mIUiListener);
}
private void shareToQQZone() {
Bundle params = new Bundle();
params.putInt(QzoneShare.SHARE_TO_QZONE_KEY_TYPE, QzoneShare.SHARE_TO_QZONE_TYPE_IMAGE_TEXT);
params.putString(QzoneShare.SHARE_TO_QQ_TITLE, "醫(yī)生工作站");//必填
params.putString(QzoneShare.SHARE_TO_QQ_SUMMARY, "最新前沿文章推薦閱讀");//選填
params.putString(QzoneShare.SHARE_TO_QQ_TARGET_URL, shareUrl);//必填
ArrayList<String> imageUrls = new ArrayList<>();
imageUrls.add("http://www.beehood.com/uploads/allimg/150310/2-150310142133.jpg");
params.putStringArrayList(QzoneShare.SHARE_TO_QQ_IMAGE_URL, imageUrls);// 必填,否則無法啟動分享
mTencent.shareToQzone(NewForwardDetailActivity.this, params, mIUiListener);
}
注意:分享到qq空間時,我開始沒有寫params.putStringArrayList,所以點擊分享沒有反應,后來查閱資料得知,這是必填項,必須要寫
微博分享
微博開放平臺:http://open.weibo.com/index.php
Github資料:https://github.com/sinaweibosdk/weibo_android_sdk
官方文檔:http://open.weibo.com/wiki/Android_sdk說明文檔(很差)
- 首先還是注冊微博開放平臺,創(chuàng)建自己的應用,等待審核后,獲取APP_KEY后才能繼續(xù)。
- 下載SDK,下載地址:https://github.com/sinaweibosdk/weibo_android_sdk
解壓后,目錄如下:
可以看下那個4.0的文檔
- SDK集成
allprojects {
repositories {
jcenter()
mavenCentral()
maven { url "https://dl.bintray.com/thelasterstar/maven/" }
}
}
compile 'com.sina.weibo.sdk:core:2.0.3:openDefaultRelease@aar'
將sdk中so目錄下的所有文件放入到你項目中的jniLibs,如果沒有自己新建,是在main目錄下,與res目錄同級,不要建錯位置。
- 初始化微博sdk并實例化WbShareHandler
WbSdk.install(this, new AuthInfo(this,你的APP_KEY, GlobalConfig.REDIRECT_URL, GlobalConfig.SCOPE));
wbShareHandler = new WbShareHandler(this);
wbShareHandler.registerApp();
// 這兩個參數固定寫就可以
public static final String REDIRECT_URL = "http://www.sina.com";
public static final String SCOPE =
"email,direct_messages_read,direct_messages_write,"
+ "friendships_groups_read,friendships_groups_write,statuses_to_me_read,"
+ "follow_app_official_microblog," + "invitation_write";
}
- 你的分享也Activity要實現WbShareCallback接口
public class NewForwardDetailActivity extends BaseActivity implements View.OnClickListener, WbShareCallback {
并實現三個回調方法:
// 微博分享回調
@Override
public void onWbShareSuccess() {
ToastUtil.showShortToast(NewForwardDetailActivity.this, "分享成功");
}
@Override
public void onWbShareCancel() {
ToastUtil.showShortToast(NewForwardDetailActivity.this, "取消分享");
}
@Override
public void onWbShareFail() {
ToastUtil.showShortToast(NewForwardDetailActivity.this, "分享失敗");
}
處理分享回調
@Override
protected void onNewIntent(Intent intent) {
super.onNewIntent(intent);
wbShareHandler.doResultIntent(intent, this); // 第二個參數是分享回調的接口
}
- 分享到微博
private void shareToWeibo(boolean hasText, boolean hasImage) {
sendMultiMessage(hasText, hasImage);
}
private void sendMultiMessage(boolean hasText, boolean hasImage) {
WeiboMultiMessage weiboMessage = new WeiboMultiMessage();
if (hasText) {
weiboMessage.textObject = getTextObj();
}
if (hasImage) {
weiboMessage.imageObject = getImageObj();
}
weiboMessage.mediaObject = getWebpageObj();
wbShareHandler.shareMessage(weiboMessage, true);
}
private TextObject getTextObj() {
TextObject textObject = new TextObject();
textObject.text = "分享的文字";
textObject.title = "分享的title";
textObject.actionUrl = "http://www.baidu.com";
return textObject;
}
private ImageObject getImageObj() {
ImageObject imageObject = new ImageObject();
Bitmap bitmap = BitmapFactory.decodeResource(getResources(), R.drawable.logo2);
imageObject.setImageObject(bitmap);
return imageObject;
}
private WebpageObject getWebpageObj() {
WebpageObject mediaObject = new WebpageObject();
mediaObject.identify = Utility.generateGUID();
mediaObject.title = "#醫(yī)生工作站#最新前沿相關文章推薦閱讀";
mediaObject.description = "最新前沿相關文章推薦閱讀";
Bitmap bitmap = BitmapFactory.decodeResource(getResources(), R.drawable.weibo_share);
mediaObject.setThumbImage(bitmap);
mediaObject.actionUrl = shareUrl;
mediaObject.defaultText = "Webpage";
return mediaObject;
}