接著上篇順便分享一篇自己使用 ShareSDK 的筆記,上篇我們集成了 SMSSDK 完成了短信接收驗(yàn)證碼的功能秒紧,請(qǐng)參考Mob 之 短信驗(yàn)證集成 SMSSDK舷暮,如何在項(xiàng)目已經(jīng)集成 SMSSDK 的情況下集成 ShareSDk 到項(xiàng)目中,上一篇中我們集成 SMSSDK 使用的是導(dǎo)入 jar 包的形式噩茄,這里我們使用創(chuàng)建 module 的方式引入 ShareSDk,主要內(nèi)容如下:
- 下載ShareSDK
- 引入 ShareSDK
- 創(chuàng)建 MainLibs Module
- 創(chuàng)建 OneKeyShare Module
- 在項(xiàng)目中引入 Module
- 配置權(quán)限
- 配置 Application
- 啟用 ShareSDK
下載 ShareSDk
官網(wǎng)下載地址:ShareSDK复颈,下載的時(shí)候選中要分享的平臺(tái)绩聘,如下圖所示:
下載的 ShareSDk 解壓縮如下沥割,這里下載的版本是 ShareSDK-Android-3.0.0 ,如下圖所示:
引入 ShareSDK
首先凿菩,復(fù)制 ShareSDk 中的 ShareSDK.xml 文件到項(xiàng)目中的 assets 目錄下机杜,
這里使用引入 module 的方式引入 ShareSDk,ShareSDK 里面主要引入如下兩個(gè) Libs衅谷,如下圖所示:
下面演示一下 Module的創(chuàng)建過(guò)程:
創(chuàng)建 MainLibs Module
-
在新建的項(xiàng)目中創(chuàng)建一個(gè) Android Library椒拗,如下圖所示:
image -
刪除新創(chuàng)建的 Library 中 main 下面的所有文件,及 java获黔、res兩個(gè)文件夾和 AndroidManifest.xml 文件蚀苛,如下圖所示:
image -
復(fù)制要引入的 MainLibs 中的 res 、 AndroidMainfest.xml 玷氏、 libs(里面的jar) 到對(duì)應(yīng)的文件夾堵未,如下圖所示:
image
導(dǎo)入 mainLibs 中結(jié)構(gòu)如下:
此時(shí),這個(gè) module 就創(chuàng)建好了盏触,這里使用 ShareSDK 提供的分享頁(yè)面渗蟹,故還需引入 OneKeyShare。
創(chuàng)建 OneKeyShare Module
創(chuàng)建 Module 的過(guò)程和上述一樣赞辩,注意的是多了一個(gè) src 雌芽,里面是要使用的 java 文件,所以必須也得引用辨嗽,如下圖所示:
將 src 文件夾復(fù)制到 main下面即可世落,build 之后如果不出錯(cuò),說(shuō)明 Module 創(chuàng)建成功了召庞,下面根據(jù)依賴關(guān)系一如對(duì)應(yīng)的 Module 即可岛心。
在項(xiàng)目中引入 Module
這里面 OnKeyShareLibs 依賴 MainLibs ,只需 app 依賴 OnkeyShareLibs 即可,這里演示 OnKeyShareLibs 如何依賴 MainLibs篮灼,如下圖所示:
然后忘古,同樣的方式 app 依賴 OnKeyShareLibs 即可。
配置權(quán)限
這里之前配置過(guò) SMSSDK ,只需補(bǔ)充缺少的權(quán)限即可诅诱,下面是同時(shí)集成了 SMSSDK 和 ShareSDK 所需的全部權(quán)限髓堪,如下:
<!-- 添加必要的權(quán)限 -->
<!--SMS SDK-->
<uses-permission android:name="android.permission.READ_PHONE_STATE" />
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
<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" />
<uses-permission android:name="android.permission.RECEIVE_SMS" />
<uses-permission android:name="android.permission.GET_TASKS" />
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
<!--ShareSDK-->
<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION"/>
<uses-permission android:name="android.permission.CHANGE_WIFI_STATE" />
<uses-permission android:name="android.permission.SYSTEM_ALERT_WINDOW" />
配置 Application
如果之前配置過(guò) SMSSDK ,那么 MobUIShell 是配置過(guò)的娘荡,只需添加缺少的 IntentFilter 干旁,集成 SMSSDK 和 ShareSDK 可共用 MobUIShell ,如下:
<activity
android:name="com.mob.tools.MobUIShell"
android:theme="@android:style/Theme.Translucent.NoTitleBar"
android:configChanges="keyboardHidden|orientation|screenSize"
android:windowSoftInputMode="stateHidden|adjustResize">
<intent-filter>
<data android:scheme="tencent100371282" />
<action android:name="android.intent.action.VIEW" />
<category android:name="android.intent.category.BROWSABLE" />
<category android:name="android.intent.category.DEFAULT" />
</intent-filter>
<!-- 調(diào)用新浪原生SDK炮沐,需要注冊(cè)的回調(diào)activity -->
<intent-filter>
<action android:name="com.sina.weibo.sdk.action.ACTION_SDK_REQ_ACTIVITY" />
<category android:name="android.intent.category.DEFAULT" />
</intent-filter>
</activity>
如果您的項(xiàng)目集微信或者微信朋友圈争群,請(qǐng)查看AndroidManifest.xml配置文件里的package路徑,需要在package目錄下創(chuàng)建wxapi目錄再放置WXEntryActivity。 沒有此activity在微信分享后回調(diào)會(huì)檢查是否有此activity,沒有將會(huì)報(bào)錯(cuò):
<activity
android:name=".yxapi.YXEntryActivity"
android:theme="@android:style/Theme.Translucent.NoTitleBar"
android:configChanges="keyboardHidden|orientation|screenSize"
android:exported="true"
android:screenOrientation="portrait" />
具體請(qǐng)參考:Android ShareSDK完整的集成文檔
啟用 SDK
通過(guò) AndroidManifest.xml
- 在 Application 節(jié)點(diǎn)下添加以下屬性:
android:name="com.mob.MobApplication"
- 在 Application 標(biāo)簽下添加 meta 參數(shù):
<!-- 通過(guò)AndroidManifest配置AppKey和AppSecret大年,如果你選擇通過(guò)代碼配置换薄,則不需要配置以下meta-data -->
<meta-data android:name="Mob-AppKey" android:value="你的AppKey"/>
<meta-data android:name="Mob-AppSecret" android:value="你的AppSecret"/>
代碼配置
// 通過(guò)代碼注冊(cè)你的AppKey和AppSecret
MobSDK.init(context, "你的AppKey", "你的AppSecret");
上述兩種方式玉雾,只使用其中一種即可初始化 ShareSDK 了。
調(diào)用分享界面
private void showShare() {
OnekeyShare oks = new OnekeyShare();
//關(guān)閉sso授權(quán)
oks.disableSSOWhenAuthorize();
// 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);
}
本文主要記錄了如何以 module 的方式引入 第三方 SDK 以及頁(yè)面的分享調(diào)用。