ShareSdk第三方分享

2019-11-09 16:06:01

字體：大中小

來(lái)源：轉(zhuǎn)載

供稿：網(wǎng)友

轉(zhuǎn)自：http://www.apkbus.com/forum.php?mod=viewthread&tid=243427

前言】

如今的app當(dāng)中，幾乎都包含了社會(huì)化分享的功能，來(lái)兩張圖see 一 see：

好在這種分享功能已經(jīng)有第三方平臺(tái)幫我們做好了，我們直接調(diào)用其SDK即可。市面上做社會(huì)化分享平臺(tái)的比較好平臺(tái)的有：mob等。

今天我們就用mob的平臺(tái)做分享吧，官網(wǎng)地址是： http://www.mob.com/

怎么樣？光看這個(gè)網(wǎng)站的首頁(yè)就碉堡了吧？好了不廢話，進(jìn)入正題。

開發(fā)環(huán)境：IDE版本：Android Studio 1.2物理機(jī)版本：Win7旗艦版（64位）一、獲取SDK并解壓：

打開網(wǎng)站首頁(yè)后，上圖中的箭頭處正是我們所需要的ShareSDK。那我們就先將SDK下載下來(lái)吧。

上圖中，點(diǎn)擊箭頭處，進(jìn)行下載。

上圖中的箭頭處所示，我們需要的是Android的SDK，所以將其下載下來(lái)。

上圖中，單機(jī)箭頭處正式下載，彈出如下界面：

上圖中，選擇我們所需要的社交平臺(tái)進(jìn)行下載吧，這里面，我選擇：新浪微博、微信、QQ、QQ空間。

下載完了之后，解壓，就是下面這個(gè)樣子：

ShareSDK在“ ShareSDK for Android ”目錄下，此目錄中的“Libs”包含了“MainLibs”文件夾（核心庫(kù)）和“OnekeyShare”文件夾（快捷分享庫(kù)）。截圖如下：

“ShareSDK for Android Services”包含ShareSDK已經(jīng)發(fā)布的“插件服務(wù)”，暫時(shí)只提供了“評(píng)論與贊”服務(wù)，我們不需要這個(gè)哈。

二、在ShareSDK官網(wǎng)進(jìn)行注冊(cè)：

在官網(wǎng)注冊(cè)賬號(hào)獲得ShareSDK的Appkey：

然后選擇應(yīng)用名稱和平臺(tái)：

應(yīng)用創(chuàng)建成功后，效果如下：

上圖中的 App Key 要記住，因?yàn)槲覀兩院笠谩?/p>

單擊紅框部分的“應(yīng)用信息”，可以添加一些信息，這些信息可有可無(wú)哈。

二、在各大社交平臺(tái)注冊(cè)：

如果你想新浪微博，就必須在新浪開放平臺(tái)上將這個(gè)app注冊(cè)一下，不然新浪是不會(huì)無(wú)緣無(wú)故讓你分享的；分享到微信和QQ的道理是一樣的。

參考鏈接：

ShareSDK各社交平臺(tái)申請(qǐng)APPkey 的網(wǎng)址及申請(qǐng)流程匯總：http://bbs.mob.com/forum.php?mod=viewthread&tid=275

1、新浪開放平臺(tái)注冊(cè)：

參考鏈接： http://bbs.mob.com/thread-89-1-4.html

登陸微博開放平臺(tái)： http://open.weibo.com/

圖文操作如下：

上圖中，填好應(yīng)用名稱，選好“應(yīng)用平臺(tái)”，然后單擊“創(chuàng)建”即可。

上圖中，單擊左側(cè)的“基本信息”，可以看到新浪微博的App Key、App Secret（紅框部分），這個(gè)信息稍后需要填到我們工程中的ShareSDK.xml中對(duì)應(yīng)的<SinaWeibo>標(biāo)簽中去。

上圖中，單擊左側(cè)的“高級(jí)信息”，然后填寫紅框部分的網(wǎng)址，填的這個(gè)網(wǎng)址稍后需要填到我們工程中的ShareSDK.xml中對(duì)應(yīng)的<SinaWeibo>標(biāo)簽的RedirectUrl屬性中去。

上圖的網(wǎng)址中，需要填寫一個(gè)可以打開的網(wǎng)址即可，比如這個(gè)：http://www.baidu.com/

，不然分享的時(shí)候很可能會(huì)報(bào)下面的錯(cuò)誤：

這個(gè)錯(cuò)誤可以參考下面這個(gè)鏈接：

新浪微博error:redirect_uri_mismatch的解決方法：http://bbs.mob.com/forum.php?mod=viewthread&tid=50

至于微信開放平臺(tái)、QQ空間開放品臺(tái)的申請(qǐng)是類似的，只不過(guò)微信開放平臺(tái)的審核是需要時(shí)間的。

另外需要說(shuō)明的是：

在新浪微博和QQ的開放平臺(tái)注冊(cè)的應(yīng)用，即使審核不通過(guò)，也可以得到AppKey進(jìn)行分享；而微信開放平臺(tái)申請(qǐng)的應(yīng)用需要審核成功之后才能得到AppKey進(jìn)行分享（我自己是等了一天的時(shí)間才得到了app審核通過(guò)的通知）

2、微信開放平臺(tái)注冊(cè)：

我們需要在微信開放平臺(tái)進(jìn)行注冊(cè)： http://open.weixin.qq.com/

參考鏈接：

微信開放平臺(tái)申請(qǐng)流程： http://bbs.mob.com/thread-95-1-4.html

核心是要填“應(yīng)用簽名”，也就是下面這張圖：（簽名工具的apk安裝包見附件）

3、騰訊開放平臺(tái)的注冊(cè)：

參考鏈接：

騰訊開放平臺(tái)申請(qǐng)流程： http://bbs.mob.com/thread-98-1-4.html

申請(qǐng)網(wǎng)址： http://open.qq.com/

四、各種配置：1、導(dǎo)入SDK到工程文件：

打開Android Studio，先新建一個(gè)名為ShareDemo的PRoject，然后開始導(dǎo)入sdk。

這里面我們就不用復(fù)制jar包的方式了，因?yàn)閖ar包不方便改源碼。我們采用新建Library module的方式來(lái)導(dǎo)入SDK 。當(dāng)然了，如果你非要用復(fù)制jar包的方式來(lái)做，可以參考官方鏈接： http://mob.com/Index/mediaItem/id/158

還記得新建Library module以及引用library的步驟嗎？不清楚的話，可以去參考本人之前的博文：這里重復(fù)一下，新建一個(gè)module形式的第三方library的通用步驟是：

新建一個(gè)library形式的module，刪掉這個(gè)module中src/main目錄里面的所有文件（包括刪掉java、res、AndroidManifest.xml）復(fù)制第三方庫(kù)的AndroidMainfest.xml、res、src文件（夾）到庫(kù)目錄的src/main目錄中將src/main目錄下的src目錄重命名（Shift+F6）為java

我們將上圖中的兩個(gè)工程文件新建為兩個(gè)Library module：ShareSDK和OneKeyShare，記得要將下面的這個(gè)文件夾中的東西也要拷到MainLibs這個(gè)module的libs文件夾下：

然后，需要注意的是， OneKeyShare這個(gè)module是依賴于 ShareSDK 這個(gè)module；而app這個(gè)module是依賴于OneKeyShare這個(gè)module 。

2、添加應(yīng)用信息：

先在app這個(gè)module（即我們這個(gè)項(xiàng)目的module）下新建一個(gè)assets文件夾（即第三方資產(chǎn)目錄），操作如下：

然后，我們將上圖中的ShareSDK.xml文件復(fù)制到assets目錄下。

緊接著開始修改ShareSDK.xml文件中的代碼。這里以新浪微博為例：

[XML] 純文本查看復(fù)制代碼?

0102030405060708091011

<ShareSDK AppKey = "修改成你在sharesdk后臺(tái)注冊(cè)的應(yīng)用的appkey"/>  <SinaWeibo Id="1" （自定義字段，整型，用于您項(xiàng)目中對(duì)此平臺(tái)的識(shí)別符） SortId="1" （此平臺(tái)在您分享列表中的位置，整型，數(shù)值越大越靠后） AppKey="568898243" （填寫您在新浪微博上注冊(cè)到的AppKey） AppSecret="38a4f8204cc784f81f9f0daaf31e02e3" （填寫您在新浪微博上注冊(cè)到的AppSecret） RedirectUrl="http://www.sharesdk.cn" （填寫您在新浪微博上注冊(cè)的RedirectUrl） ShareByAppClient="false" （是否使用客戶端進(jìn)行分享） Enable="true"/> （布爾值，標(biāo)記此平臺(tái)是否有效）

代碼解釋：

02行：還記得之前說(shuō)過(guò)AppKey有用嗎？這里就派上用場(chǎng)了，填上去就行了。

08行：需要先事先在新浪微博的開發(fā)者平臺(tái)注冊(cè)得到AppKey。也就是上面第三段中提到的內(nèi)容。

12行：如果不想用這個(gè)分享平臺(tái)，可以將其設(shè)置為false。

總結(jié)：

ShareSDK的每一個(gè)平臺(tái)都具備SortId、Id、Enable字段，除此之外的字段（如新浪微博的AppKey、AppSecret、RedirectUrl、ShareByAppClient等字段）需要到目標(biāo)平臺(tái)上注冊(cè)應(yīng)用以后得到，請(qǐng)正確填寫這些字段的數(shù)據(jù)，否則ShareSDK無(wú)法完成授權(quán)，則后續(xù)的其它操作也將無(wú)法執(zhí)行。

3、配置AndroidManifest.xml：

（1）添加如下權(quán)限：（和application節(jié)點(diǎn)并列）

[XML] 純文本查看復(fù)制代碼?

123456789 <uses-permissionandroid:name="android.permission.GET_TASKS"/> <uses-permissionandroid:name="android.permission.INTERNET"/> <uses-permissionandroid:name="android.permission.access_WIFI_STATE"/> <uses-permissionandroid:name="android.permission.ACCESS_NETWORK_STATE"/> <uses-permissionandroid:name="android.permission.CHANGE_WIFI_STATE"/> <uses-permissionandroid:name="android.permission.WRITE_EXTERNAL_STORAGE"/> <uses-permissionandroid:name="android.permission.READ_PHONE_STATE"/> <uses-permissionandroid:name="android.permission.MANAGE_ACCOUNTS"/> <uses-permissionandroid:name="android.permission.GET_ACCOUNTS"/>

（2）在application節(jié)點(diǎn)下注冊(cè)下面的Activity：

[XML] 純文本查看復(fù)制代碼?

01020304050607080910111213 <activity android:name="com.mob.tools.MobUIShell" android:theme="@android:style/Theme.Translucent.NoTitleBar" android:configChanges="keyboardHidden|orientation|screenSize" android:screenOrientation="portrait" android:windowSoftInputMode="stateHidden|adjustResize"> <intent-filter> <dataandroid:scheme="tencent1104646053"/> <actionandroid:name="android.intent.action.VIEW"/> <categoryandroid:name="android.intent.category.BROWSABLE"/> <categoryandroid:name="android.intent.category.DEFAULT"/> </intent-filter></activity>

注意： MobUIShell的路徑是固定的，一定要在“cn.sharesdk.framework”下，因?yàn)樗赟hare-Core中。

之后，需要對(duì)上面的代碼進(jìn)行以下修改：

上圖中，將紅框部分的數(shù)字改成在騰訊開放平臺(tái)申請(qǐng)到的AppId即可。

如果項(xiàng)目集成了微信，還需要添加以下WXEntryActivity，不然的話，mob后臺(tái)無(wú)法做微信的分享統(tǒng)計(jì) ：（在工程的包下新建wxapi目錄再放置WXEntryActivity）

WXEntryActivity.Java的代碼如下：

[Java] 純文本查看復(fù)制代碼?

01020304050607080910111213141516171819202122232425262728293031323334353637383940414243 /* * 官網(wǎng)地站:http://www.mob.com * 技術(shù)支持QQ: 4006852216 * 官方微信:ShareSDK （如果發(fā)布新版本的話，我們將會(huì)第一時(shí)間通過(guò)微信將版本更新內(nèi)容推送給您。如果使用過(guò)程中有任何問題，也可以通過(guò)微信與我們?nèi)〉寐?lián)系，我們將會(huì)在24小時(shí)內(nèi)給予回復(fù)） * * Copyright (c) 2013年 mob.com. All rights reserved. */package com.smyhvae.sharedemo.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;/** 微信客戶端回調(diào)activity示例 */public class WXEntryActivity extends WechatHandlerActivity { /** * 處理微信發(fā)出的向第三方應(yīng)用請(qǐng)求app message * <p> * 在微信客戶端中的聊天頁(yè)面有“添加工具”，可以將本應(yīng)用的圖標(biāo)添加到其中 * 此后點(diǎn)擊圖標(biāo)，下面的代碼會(huì)被執(zhí)行。Demo僅僅只是打開自己而已，但你可 * 做點(diǎn)其他的事情，包括根本不打開任何頁(yè)面 */ public void onGetMessageFromWXReq(WXMediaMessage msg) { Intent iLaunchMyself = getPackageManager().getLaunchIntentForPackage(getPackageName()); startActivity(iLaunchMyself); } /** * 處理微信向第三方應(yīng)用發(fā)起的消息 * <p> * 此處用來(lái)接收從微信發(fā)送過(guò)來(lái)的消息，比方說(shuō)本demo在wechatpage里面分享 * 應(yīng)用時(shí)可以不分享應(yīng)用文件，而分享一段應(yīng)用的自定義信息。接受方的微信 * 客戶端會(huì)通過(guò)這個(gè)方法，將這個(gè)信息發(fā)送回接收方手機(jī)上的本demo中，當(dāng)作 * 回調(diào)。 * <p> * 本Demo只是將信息展示出來(lái)，但你可做點(diǎn)其他的事情，而不僅僅只是Toast */ publicvoid onShowMessageFromWXReq(WXMediaMessage msg) { if(msg != null&& msg.mediaObject != null && (msg.mediaObject instanceofWXAppExtendObject)) { WXAppExtendObject obj = (WXAppExtendObject) msg.mediaObject; Toast.makeText(this, obj.extInfo, Toast.LENGTH_SHORT).show(); } }}

同時(shí)，在清單文件中進(jìn)行聲明：

[XML] 純文本查看復(fù)制代碼?

1234567 <activity android:name=".wxapi.WXEntryActivity" android:configChanges="keyboardHidden|orientation|screenSize" android:exported="true" android:screenOrientation="portrait" android:theme="@android:style/Theme.Translucent.NoTitleBar"/>

如果項(xiàng)目繼承了易信，方法類似，這里就不貼出來(lái)了，現(xiàn)在誰(shuí)還用易信啊，哈哈哈···

4、添加代碼：

集成ShareSDK至少需要在兩個(gè)位置添加代碼，包括：

（1）在項(xiàng)目的入口Activity，在其onCreate方法中插入下面的代碼進(jìn)行初始化：（這個(gè)方法越早調(diào)用越好）

[Java] 純文本查看復(fù)制代碼?

1	`ShareSDK.initSDK(this);`

如果不在所有的ShareSDK的操作之前調(diào)用這行代碼，就會(huì)拋出空指針異常。

（2）在項(xiàng)目出口Activity的onDestroy方法中第一行插入下面的代碼：

[Java] 純文本查看復(fù)制代碼?

1	`ShareSDK.stoPSDK(this);`

上方這行代碼會(huì)結(jié)束ShareSDK的統(tǒng)計(jì)功能并釋放資源。如果這行代碼沒有被調(diào)用，那么“應(yīng)用啟動(dòng)次數(shù)”將會(huì)不準(zhǔn)確，因?yàn)閼?yīng)用可能從來(lái)沒有被關(guān)閉過(guò)。

注意：initSDK是可以重復(fù)調(diào)用的，其實(shí)ShareSDK建議在不確定的時(shí)候調(diào)用這個(gè)方法來(lái)保證ShareSDK被正確初始化。而stopSDK一旦被調(diào)用了，就必須重新調(diào)用initSDK才能使用ShareSDK的功能，否則會(huì)出現(xiàn)空指針異常。

在代碼中調(diào)用此方法，即可打開一鍵分享功能進(jìn)行分享：

[Java] 純文本查看復(fù)制代碼?

01020304050607080910111213141516171819202122232425 privatevoid showShare() { ShareSDK.initSDK(this); OnekeyShare oks = newOnekeyShare(); //關(guān)閉sso授權(quán) oks.disableSSOWhenAuthorize();// 分享時(shí)Notification的圖標(biāo)和文字 2.5.9以后的版本不調(diào)用此方法 //oks.setNotification(R.drawable.ic_launcher, getString(R.string.app_name)); // title標(biāo)題，印象筆記、郵箱、信息、微信、人人網(wǎng)和QQ空間使用 oks.setTitle(getString(R.string.share)); // titleUrl是標(biāo)題的網(wǎng)絡(luò)鏈接，僅在人人網(wǎng)和QQ空間使用 oks.setTitleUrl("http://sharesdk.cn"); // text是分享文本，所有平臺(tái)都需要這個(gè)字段 oks.setText("我是分享文本，啦啦啦~"); // imagePath是圖片的本地路徑，Linked-In以外的平臺(tái)都支持此參數(shù) oks.setImagePath("/sdcard/test.jpg");//確保SDcard下面存在此張圖片 // url僅在微信（包括好友和朋友圈）中使用 oks.setUrl("http://sharesdk.cn"); // comment是我對(duì)這條分享的評(píng)論，僅在人人網(wǎng)和QQ空間使用 oks.setComment("我是測(cè)試評(píng)論文本"); // site是分享此內(nèi)容的網(wǎng)站名稱，僅在QQ空間使用 oks.setSite(getString(R.string.app_name)); // siteUrl是分享此內(nèi)容的網(wǎng)站地址，僅在QQ空間使用 oks.setSiteUrl("http://sharesdk.cn");// 啟動(dòng)分享GUI oks.show(this); }

上面的這些代碼是官方給的，實(shí)際項(xiàng)目中可以放在按鈕的點(diǎn)擊事件中，根據(jù)需要去填寫。

代碼解釋：

14行： setText是需要分享的文本內(nèi)容

16行： setImagePath是需要分享的本地圖片。（如果是在真機(jī)當(dāng)中，需要通過(guò)api去拿sd卡的路徑，即Environment.getExternalStorageDirectory()這個(gè)api）

五、正式開始寫代碼：

（1）activity_main.xml布局文件：

[XML] 純文本查看復(fù)制代碼?

0102030405060708091011121314151617181920 <LinearLayoutxmlns:android="http://schemas.android.com/apk/res/android" xmlns:tools="http://schemas.android.com/tools" android:layout_width="match_parent" android:layout_height="match_parent" android:orientation="vertical" android:paddingBottom="@dimen/activity_vertical_margin" android:paddingLeft="@dimen/activity_horizontal_margin" android:paddingRight="@dimen/activity_horizontal_margin" android:paddingTop="@dimen/activity_vertical_margin" tools:context=".MainActivity"> <TextView android:layout_width="wrap_content" android:layout_height="wrap_content" android:text="@string/hello_world"/> <Button android:id="@+id/button1" android:layout_width="wrap_content" android:layout_height="wrap_content" android:text="分享按鈕"/></LinearLayout>

其實(shí)就是加了個(gè)button按鈕，用做分享的事件觸發(fā)。

（2）ShareSDK.xml中和新浪微博、微信、QQ有關(guān)的配置：

新浪微博：[XML] 純文本查看復(fù)制代碼?

12345678 <SinaWeibo AppKey="858316951" AppSecret="52685221be9572d0fb99e35a7ba25364" Enable="true" Id="1" RedirectUrl="http://www.baidu.com" ShareByAppClient="true" SortId="1"/>

02行和03行的AppKey和AppSecret要換成你自己在新浪開放平臺(tái)注冊(cè)的信息。

06行：RedirectUrl里面的網(wǎng)址要改成可用的url地址，并且與新浪開放平臺(tái)的授權(quán)回調(diào)頁(yè)的網(wǎng)址一致，也就是下面這個(gè)：（在第三段中已經(jīng)強(qiáng)調(diào)過(guò)了）

07行：如果設(shè)置為true，那就會(huì)用新浪微博的app來(lái)進(jìn)行分享操作；如果你沒有安裝新浪微博的app，很可能會(huì)導(dǎo)致分享失敗。如果設(shè)置為false，那就會(huì)用網(wǎng)頁(yè)版的新浪微博進(jìn)行分享。

微信和QQ的配置信息差不多，就不贅述了。

（3）MainActivity.java:

[Java] 純文本查看復(fù)制代碼?

01020304050607080910111213141516171819202122232425262728293031323334353637383940414243444546474849505152 packagecom.smyhvae.sharedemo;importandroid.app.Activity;importandroid.os.Bundle;importandroid.view.View;importandroid.widget.Button; importcn.sharesdk.framework.ShareSDK;importcn.sharesdk.onekeyshare.OnekeyShare; publicclass MainActivity extendsActivity implementsView.OnClickListener { privateButton button1; @Override protectedvoid onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.activity_main); button1 = (Button) findViewById(R.id.button1); button1.setOnClickListener(this); } //點(diǎn)擊按鈕，開始進(jìn)行分享 @Override publicvoid onClick(View v) { ShareSDK.initSDK(this); OnekeyShare oks = newOnekeyShare(); //關(guān)閉sso授權(quán) oks.disableSSOWhenAuthorize(); // title標(biāo)題：微信、QQ（新浪微博不需要標(biāo)題） oks.setTitle("我是分享標(biāo)題"); //最多30個(gè)字符 // text是分享文本：所有平臺(tái)都需要這個(gè)字段 oks.setText("我是分享文本，啦啦啦~http://uestcbmi.com/"); //最多40個(gè)字符 // imagePath是圖片的本地路徑：除Linked-In以外的平臺(tái)都支持此參數(shù) //oks.setImagePath(Environment.getExternalStorageDirectory() + "/meinv.jpg");//確保SDcard下面存在此張圖片 //網(wǎng)絡(luò)圖片的url：所有平臺(tái) oks.setImageUrl("http://7sby7r.com1.z0.glb.clouddn.com/CYSJ_02.jpg");//網(wǎng)絡(luò)圖片rul // url：僅在微信（包括好友和朋友圈）中使用 oks.setUrl("http://sharesdk.cn"); //網(wǎng)友點(diǎn)進(jìn)鏈接后，可以看到分享的詳情 // Url：僅在QQ空間使用 oks.setTitleUrl("http://www.baidu.com"); //網(wǎng)友點(diǎn)進(jìn)鏈接后，可以看到分享的詳情 // 啟動(dòng)分享GUI oks.show(this); }}