1. 程式人生 > >Mob之社會化分享整合ShareSDK

Mob之社會化分享整合ShareSDK

接著上篇順便分享一篇自己使用 ShareSDK 的筆記,上篇我們集成了 SMSSDK 完成了簡訊接收驗證碼的功能,請參考Mob 之 簡訊驗證整合 SMSSDK,如何在專案已經整合 SMSSDK 的情況下整合 ShareSDk 到專案中,上一篇中我們整合 SMSSDK 使用的是匯入 jar 包的形式,這裡我們使用建立 module 的方式引入 ShareSDk,主要內容如下:

  1. 下載ShareSDK
  2. 引入 ShareSDK
  3. 建立 MainLibs Module
  4. 建立 OneKeyShare Module
  5. 在專案中引入 Module
  6. 配置許可權
  7. 配置 Application
  8. 啟用 ShareSDK

下載 ShareSDk

官網下載地址:ShareSDK,下載的時候選中要分享的平臺,如下圖所示:

image

下載的 ShareSDk 解壓縮如下,這裡下載的版本是 ShareSDK-Android-3.0.0 ,如下圖所示:

image

引入 ShareSDK

首先,複製 ShareSDk 中的 ShareSDK.xml 檔案到專案中的 assets 目錄下,
這裡使用引入 module 的方式引入 ShareSDk,ShareSDK 裡面主要引入如下兩個 Libs,如下圖所示:

image
下面演示一下 Module的建立過程:

建立 MainLibs Module

  1. 在新建的專案中建立一個 Android Library,如下圖所示:
    image
  2. 刪除新建立的 Library 中 main 下面的所有檔案,及 java、res兩個資料夾和 AndroidManifest.xml 檔案,如下圖所示:
    image

  3. 複製要引入的 MainLibs 中的 res 、 AndroidMainfest.xml 、 libs(裡面的jar) 到對應的資料夾,如下圖所示:
    image
    匯入 mainLibs 中結構如下:

image
此時,這個 module 就建立好了,這裡使用 ShareSDK 提供的分享頁面,故還需引入 OneKeyShare。

建立 OneKeyShare Module

建立 Module 的過程和上述一樣,注意的是多了一個 src ,裡面是要使用的 java 檔案,所以必須也得引用,如下圖所示:

image

將 src 資料夾複製到 main下面即可,build 之後如果不出錯,說明 Module 建立成功了,下面根據依賴關係一如對應的 Module 即可。

在專案中引入 Module

這裡面 OnKeyShareLibs 依賴 MainLibs ,只需 app 依賴 OnkeyShareLibs 即可,這裡演示 OnKeyShareLibs 如何依賴 MainLibs,如下圖所示:

image

然後,同樣的方式 app 依賴 OnKeyShareLibs 即可。

配置許可權

這裡之前配置過 SMSSDK ,只需補充缺少的許可權即可,下面是同時集成了 SMSSDK 和 ShareSDK 所需的全部許可權,如下:

<!-- 新增必要的許可權 -->
<!--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

如果之前配置過 SMSSDK ,那麼 MobUIShell 是配置過的,只需新增缺少的 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>

    <!-- 呼叫新浪原生SDK,需要註冊的回撥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>

如果您的專案集微信或者微信朋友圈,請檢視AndroidManifest.xml配置檔案裡的package路徑,需要在package目錄下建立wxapi目錄再放置WXEntryActivity。 沒有此activity在微信分享後回撥會檢查是否有此activity,沒有將會報錯:

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

具體請參考:Android ShareSDK完整的整合文件

啟用 SDK

通過 AndroidManifest.xml
  1. 在 Application 節點下新增以下屬性:
android:name="com.mob.MobApplication"
  1. 在 Application 標籤下新增 meta 引數:
<!-- 通過AndroidManifest配置AppKey和AppSecret,如果你選擇通過程式碼配置,則不需要配置以下meta-data -->
<meta-data android:name="Mob-AppKey" android:value="你的AppKey"/>
<meta-data android:name="Mob-AppSecret" android:value="你的AppSecret"/>
程式碼配置
// 通過程式碼註冊你的AppKey和AppSecret
MobSDK.init(context, "你的AppKey", "你的AppSecret");

上述兩種方式,只使用其中一種即可初始化 ShareSDK 了。

呼叫分享介面

private void showShare() {
     OnekeyShare oks = new OnekeyShare();
     //關閉sso授權
     oks.disableSSOWhenAuthorize(); 
     // title標題,印象筆記、郵箱、資訊、微信、人人網和QQ空間使用
     oks.setTitle(getString(R.string.share));
     // titleUrl是標題的網路連結,僅在人人網和QQ空間使用
     oks.setTitleUrl("http://sharesdk.cn");
     // text是分享文字,所有平臺都需要這個欄位
     oks.setText("我是分享文字");
     // imagePath是圖片的本地路徑,Linked-In以外的平臺都支援此引數
     oks.setImagePath("/sdcard/test.jpg");//確保SDcard下面存在此張圖片
     // url僅在微信(包括好友和朋友圈)中使用
     oks.setUrl("http://sharesdk.cn");
     // comment是我對這條分享的評論,僅在人人網和QQ空間使用
     oks.setComment("我是測試評論文字");
     // site是分享此內容的網站名稱,僅在QQ空間使用
     oks.setSite(getString(R.string.app_name));
     // siteUrl是分享此內容的網站地址,僅在QQ空間使用
     oks.setSiteUrl("http://sharesdk.cn");

    // 啟動分享GUI
     oks.show(this);
}

本文主要記錄瞭如何以 module 的方式引入 第三方 SDK 以及頁面的分享呼叫。

可以選擇關注微信公眾號:jzman-blog 獲取最新更新,一起交流學習!

零點小築