文章涉及的demo在Github LQThirdParty, 歡迎Star | Fork

一. 注冊賬號

首先到Mob的開放平臺注冊成為開發(fā)者, 并新建應用, 獲得相應的 APPID 和 APPSecret .然后到相應的第三方平臺注冊成為開發(fā)者, 新建應用, 獲取對應的AppKey.

二. 集成及配置

2.1 集成

2.1.1 CocoaPods集成

CocoaPods集成好處不多說, 根據官方文檔在項目 Podfile 文件 添加相應的引入即可:

# UI模塊(非必須，需要用到ShareSDK提供的分享菜單欄和分享編輯頁面需要以下1行)
pod 'mob_sharesdk/ShareSDKUI'
 
# 平臺SDK模塊(對照一下平臺，需要的加上。如果只需要QQ、微信、新浪微博，只需要以下3行)
pod 'mob_sharesdk/ShareSDKPlatforms/QQ'
pod 'mob_sharesdk/ShareSDKPlatforms/SinaWeibo'
pod 'mob_sharesdk/ShareSDKPlatforms/WeChat'   //（微信sdk不帶支付的命令）
# pod 'mob_sharesdk/ShareSDKPlatforms/WeChatFull’ //（微信sdk帶支付的命令，和上面不帶支付的不能共存，只能選擇一個）

然后執(zhí)行 pod install ,等待下載完成即可;

2.1.2 手動集成

官方文檔
首先下載iOS SDK, 在下載頁選擇需要的第三方平臺SDK, 點擊下載即可;
將下載的文件解壓出的兩個文件夾, 直接拖進項目目錄, 具體各個文件夾的內容可參考官方文檔內的說明進行刪減.

注意: 如果是使用Xcode 9+ 新建的項目, 在將文件拖入項目的時候, 不會自動把庫文件加載到庫資源里，以及不會自動添加路徑. 可以先將添加的文件刪除引用, 不是刪除文件移到廢紙簍, Delegate -> Remove References, 然后, 重新右鍵 -> Add Files To..., 找到添加的文件, 重新添加即可.

2.2 配置項目

2.2.1 添加info字段

在項目info.plist文件內添加以下字段:

MOBAppKey
MOBAppSecret

其值分別是Mob平臺新建APP后獲取的AppKey及Secret;

2.2.2 添加系統(tǒng)依賴庫

在Target -> General -> Linked Frameworks and Libraries 添加
必加依賴庫:

libicucore.tbd
libz.tbd
 libstdc++.tbd
JavaScriptCore.framework

以下依賴庫根據社交平臺添加：

新浪微博SDK依賴庫
ImageIO.framework
libsqlite3.tbd

QQ好友和QQ空間SDK依賴庫
libsqlite3.tbd

微信SDK依賴庫
libsqlite3.tbd

2.2.3 在Other Linker Flags加入-ObjC

如果使用了新浪微博SDK, 需要添加
在Target -> Build Setting -> Linking ->Other Linker Flags添加 -ObjC , 注意大小寫.

2.3 設置 URL Scheme

URL Scheme是通過系統(tǒng)找到并跳轉對應app的設置，通過向項目中的info.plist文件中加入URL types可使用第三方平臺所注冊的appkey信息向系統(tǒng)注冊你的app，當跳轉到第三方應用授權或分享后，可直接跳轉回你的app。

在 Info -> URL Types 中添加:

具體的設置, 可參考官方文檔中間部分內容.

如果是

2.4 適配 iOS 9 +

在iOS 9以上系統(tǒng), 需要添加一些設置:

2.4.1 配置SSO白名單

在iOS9以上系統(tǒng)需要增加一個可跳轉App的白名單，即LSApplicationQueriesSchemes, 否則將在SDK判斷是否跳轉時用到的canOpenURL時返回NO，進而只進行webview授權或授權/分享失敗.
在項目中的info.plist中加入應用白名單，右鍵info.plist選擇source code打開, 根據選擇的平臺對以下配置進行縮減：

<key>LSApplicationQueriesSchemes</key>
<array>
    <!-- 微信 URL Scheme 白名單-->
    <string>wechat</string>
    <string>weixin</string>

    <!-- 新浪微博 URL Scheme 白名單-->
    <string>sinaweibohd</string>
    <string>sinaweibo</string>
    <string>sinaweibosso</string>
    <string>weibosdk</string>
    <string>weibosdk2.5</string>

    <!-- QQ、Qzone、TIM URL Scheme 白名單-->
    <string>mqqapi</string>
    <string>mqq</string>
    <string>mqqOpensdkSSoLogin</string>
    <string>mqqconnect</string>
    <string>mqqopensdkdataline</string>
    <string>mqqopensdkgrouptribeshare</string>
    <string>mqqopensdkfriend</string>
    <string>mqqopensdkapi</string>
    <string>mqqopensdkapiV2</string>
    <string>mqqopensdkapiV3</string>
    <string>mqqopensdkapiV4</string>
    <string>mqzoneopensdk</string>
    <string>wtloginmqq</string>
    <string>wtloginmqq2</string>
    <string>mqqwpa</string>
    <string>mqzone</string>
    <string>mqzonev2</string>
    <string>mqzoneshare</string>
    <string>wtloginqzone</string>
    <string>mqzonewx</string>
    <string>mqzoneopensdkapiV2</string>
    <string>mqzoneopensdkapi19</string>
    <string>mqzoneopensdkapi</string>
    <string>mqqbrowser</string>
    <string>mttbrowser</string>
    <string>tim</string>
    <string>timapi</string>
    <string>timopensdkfriend</string>
    <string>timwpa</string>
    <string>timgamebindinggroup</string>
    <string>timapiwallet</string>
    <string>timOpensdkSSoLogin</string>
    <string>wtlogintim</string>
    <string>timopensdkgrouptribeshare</string>
    <string>timopensdkapiV4</string>
    <string>timgamebindinggroup</string>
    <string>timopensdkdataline</string>
    <string>wtlogintimV1</string>
    <string>timapiV1</string>

    <!-- 支付寶 URL Scheme 白名單-->
    <string>alipay</string>
    <string>alipayshare</string>
</array>

其他平臺, 可參考官方文檔

2.4.2 網絡請求

• 方式一: 暫時回退到HTTP請求
  在Info.plist文件中添加字段: NSAppTransportSecurity, 類型為字典;
  然后添加一個Key：NSAllowsArbitraryLoads, 類型為Boolean, 值為 YES

回退到HTTP

或者以Source Code 打開Info.plist文件, 空白處添加以下代碼:

<key>NSAppTransportSecurity</key>
    <dict>
        <key>NSAllowsArbitraryLoads</key>
        <true/>
    </dict>

• 方式二: 設置域

在項目的info.plist中添加一個Key：NSAppTransportSecurity，類型為字典類型。
然后給它添加一個值: NSExceptionDomains，類型為字典類型；
把需要的支持的域添加給NSExceptionDomains
其中域作為Key，類型為字典類型。
每個域下面需要設置3個屬性：
NSIncludesSubdomains、
NSExceptionRequiresForwardSecrecy、NSExceptionAllowsInsecureHTTPLoads。

均為Boolean類型，值分別為YES、NO、YES

微信需要設置的域為:

• qq.com

QQ域

或者以Source Code 打開Info.plist文件, 空白處添加以下代碼:

<key>NSAppTransportSecurity</key>
    <dict>
        <key>NSExceptionDomains</key>
        <dict>
            <key>qq.com</key>
            <dict>
                <key>NSExceptionAllowsInsecureHTTPLoads</key>
                <true/>
                <key>NSExceptionRequiresForwardSecrecy</key>
                <false/>
                <key>NSIncludesSubdomains</key>
                <true/>
            </dict>
        </dict>
    </dict>

PS: 這種方式需要對每個要以HTTP方式訪問的域名進行設置, 比較麻煩, 建議使用第一種方式.

到此, 相關的配置就完成了, 下面就是使用相關的API實現相應的功能.

PS: 如果是Swift項目, 在使用相關API的時候, 需要新建橋接頭文件, 或者在已有橋接頭文件內引用其頭文件:

#import <ShareSDK/ShareSDK.h>
#import <ShareSDKConnector/ShareSDKConnector.h>
 
//騰訊開放平臺（對應QQ和QQ空間）SDK頭文件
#import <TencentOpenAPI/TencentOAuth.h>
#import <TencentOpenAPI/QQApiInterface.h>
 
//微信SDK頭文件
#import "WXApi.h"
 
//新浪微博SDK頭文件
#import "WeiboSDK.h"

三. 登錄

以上配置完成, 接下來的就很簡單了, 登錄授權的API相對比較簡單.所有平臺的登錄請參考官方文檔

3.1 注冊APP

在相應的第三方開放平臺新建APP之后, 獲取到相應的APPkey和appSecret; 調用以下方法進行注冊:

class func registApp() {
        ShareSDK.registerActivePlatforms([SSDKPlatformType.typeQQ.rawValue, SSDKPlatformType.typeWechat.rawValue, SSDKPlatformType.typeSinaWeibo.rawValue], onImport: { (platform) in
            switch platform {
            case SSDKPlatformType.typeQQ:
                ShareSDKConnector.connectQQ(QQApiInterface.self, tencentOAuthClass: TencentOAuth.self)
            case SSDKPlatformType.typeWechat:
                ShareSDKConnector.connectWeChat(WXApi.self)
            case SSDKPlatformType.typeSinaWeibo:
                ShareSDKConnector.connectWeibo(WeiboSDK.self)
            default:
                break
            }
        }) { (platform, appInfo) in
            
            switch platform {
            case SSDKPlatformType.typeQQ:
                appInfo?.ssdkSetupQQ(byAppId: kShareSDK_QQAppID, appKey: kShareSDK_QQAppKey, authType: SSDKAuthTypeBoth)
            case SSDKPlatformType.typeWechat:
                appInfo?.ssdkSetupWeChat(byAppId: kShareSDK_WechatAppID, appSecret: kShareSDK_WechatAppSecret)
            case SSDKPlatformType.typeSinaWeibo:
                appInfo?.ssdkSetupSinaWeibo(byAppKey: kShareSDK_SinaWeiboAppKey, appSecret: kShareSDK_SinaWeiboAppSecret, redirectUri: kShareSDK_SinaWeibOredirectUri, authType: SSDKAuthTypeBoth)
            default:
                break
            }
        }
    }

此方法要在AppDelegate中的 func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplicationLaunchOptionsKey: Any]?) -> Bool 方法中調用;

func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplicationLaunchOptionsKey: Any]?) -> Bool {
        // Override point for customization after application launch.
        
         LQShareSDK.registApp()
        return true
    }

3.2 獲取授權及用戶信息

以上設置完畢, 只需要在登登錄的事件內添加以下獲取授權的方法即可, 這里我封裝進了一個方法里:

class func login(_ type: LQShareType, success handle: @escaping ((_ uid: String, _ name: String, _ url: String, _ sex: String) -> Void), failed: ((_ error: Error) -> Void)?) {
        
        var shareType: SSDKPlatformType?
        switch type {
        case .qq:
            shareType = SSDKPlatformType.typeQQ
        case .wechat:
            shareType = SSDKPlatformType.typeWechat
        case .sinaWeibo:
            shareType = SSDKPlatformType.typeSinaWeibo
        }
       
        if let login = shareType {
            
            ShareSDK.cancelAuthorize(login)
            ShareSDK.getUserInfo(login) { (state, user, error) in
                
                if state == SSDKResponseState.success {
                    
                    var uid = ""
                    if let ui = user?.uid {
                        uid = ui
                    }
                    
                    var nickName = ""
                    if let name = user?.nickname {
                        nickName = name
                    }
                    
                    var icon = ""
                    if let ic = user?.icon {
                        icon = ic
                    }
                    
                    var gender = ""
                    if let gen = user?.gender {
                        if gen == 0 {
                            gender = "男"
                        } else if gen == 1 {
                            gender = "女"
                        }else{
                            gender = "未知"
                        }
                    }
                    handle(uid, nickName, icon, gender)
                } else  {
                    if let handle = failed {
                        handle(error!)
                    }
                }
            }
        }
    }

其中 LQShareType 為登錄的類型:

enum LQShareType {
    case qq, wechat, sinaWeibo
}

這里只使用了微信/QQ/新浪微博登錄, 一般常用的也是這三種, 結果回調里返回了uid, name, 頭像, 性別. 其他的內容可參考文檔獲取.對象的 rawData 屬性可獲取原始的第三方數據.

四. 簡單分享

在創(chuàng)建分享內容時, 可使用下面的API進行簡單的分享:

/**
 *  設置分享參數
 *
 *  @param text     文本
 *  @param images   圖片集合,傳入參數可以為單張圖片信息，也可以為一個NSArray，數組元素可以為UIImage、NSString（圖片路徑）、NSURL（圖片路徑）、SSDKImage。如: @"http://www.mob.com/images/logo_black.png" 或 @[@"http://www.mob.com/images/logo_black.png"]
 *  @param url      網頁路徑/應用路徑
 *  @param title    標題
 *  @param type     分享類型
 */
- (void)SSDKSetupShareParamsByText:(NSString *)text
                            images:(id)images
                               url:(NSURL *)url
                             title:(NSString *)title
                              type:(SSDKContentType)type;

另外, ShareSDK 也有針對各個平臺的分享參數設API, 可直接查看其接口文檔.

4.1 使用Mob的分享面板

引入ShareSDK的UI模塊后, 即可使用ShareSDK的分享面板, 在創(chuàng)建分享到各個平臺的消息后, 可直接調用此方法來彈出分享面板進行分享.

#import <ShareSDKUI/ShareSDK+SSUI.h>

class func shareUI() {
        
        let shareParams: NSMutableDictionary = NSMutableDictionary()
        shareParams.ssdkSetupShareParams(byText: "分享內容", images: "https://timgsa.baidu.com/timg?image&quality=80&size=b9999_10000&sec=1510826207776&di=5308bfb4c02cefc1210cad3eb963993b&imgtype=0&src=http%3A%2F%2Fimgsrc.baidu.com%2Fimgad%2Fpic%2Fitem%2Fd788d43f8794a4c273cb6b0804f41bd5ad6e392c.jpg", url: URL.init(string: "https://timgsa.baidu.com/timg?image&quality=80&size=b9999_10000&sec=1510826207776&di=5308bfb4c02cefc1210cad3eb963993b&imgtype=0&src=http%3A%2F%2Fimgsrc.baidu.com%2Fimgad%2Fpic%2Fitem%2Fd788d43f8794a4c273cb6b0804f41bd5ad6e392c.jpg"), title: "分享標題", type: SSDKContentType.audio)
        
        //1.要顯示菜單的視圖, iPad版中此參數作為彈出菜單的參照視圖，只有傳這個才可以彈出我們的分享菜單，可以傳分享的按鈕對象或者自己創(chuàng)建小的view 對象，iPhone可以傳nil不會影響
        // 2. 菜單項, 需要分享到的平臺, 如果傳nil, 則會顯示所有已集成的平臺 SSDKPlatformType
        // 3. 分享的內容
        ShareSDK.showShareActionSheet(nil, items: nil, shareParams: shareParams) { (state, type, info, entity, error, end) in
            
            if state == SSDKResponseState.success {
                print("分享成功")
            } else {
                print("分享失敗")
            }
        }
    }

以下用到的shareSession函數定義如下:

private class func shareSession(_ type: LQShareSession) -> SSDKPlatformType {
        switch type {
        case .qq:
            return SSDKPlatformType.subTypeQQFriend
        case .qzone:
            return SSDKPlatformType.subTypeQZone
        case .wechatSession:
            return SSDKPlatformType.subTypeWechatSession
        case .wechatTimeline:
            return SSDKPlatformType.subTypeWechatTimeline
        case .wechatFavorite:
            return SSDKPlatformType.subTypeWechatFav
        case .sina:
            return SSDKPlatformType.typeSinaWeibo
        }
    }

4.2 分享網頁

/// 分享網頁
    ///
    /// - Parameters:
    ///   - url: 網頁地址
    ///   - thumbImage: 網頁縮略圖
    ///   - title: 網頁標題
    ///   - descr: 網頁描述
    ///   - session: 分享到的平臺
    ///   - success: 成功回調
    ///   - failed: 失敗回調
    class func shareWeb(_ url: String, thumbImage: String? = nil, title: String? = nil, descr: String? = nil, to session: LQShareSession, success: (() -> Void)? = nil, failed: (() -> Void)? = nil) {
        
        let shareParams = NSMutableDictionary()
        shareParams.ssdkSetupShareParams(byText: descr, images: thumbImage, url: URL.init(string: url), title: title, type: SSDKContentType.webPage)
        
        ShareSDK.share(shareSession(session), parameters: shareParams) { (state, info, entity, error) in
            
            if state == SSDKResponseState.success {
                if let handle = success {
                    handle()
                }
            } else {
                if let handle = failed {
                    handle()
                }
            }
        }
    }

4.3 分享圖片

/// 分享圖片
    ///
    /// - Parameters:
    ///   - image: 圖片內容, 可以為Data, UIImage, String, 或一組圖片, 當為一組圖片時, 只分享第一張
    ///   - session: 分享到的平臺
    ///   - success: 成功的回調
    ///   - failed: 失敗的回調
    class func shareImage(_ image: Any, to session: LQShareSession, success: (() -> Void)? = nil, failed: (() -> Void)? = nil) {
        
        let shareParams = NSMutableDictionary()
        shareParams.ssdkSetupShareParams(byText: nil, images: image, url: nil, title: nil, type: SSDKContentType.image)
        
        ShareSDK.share(shareSession(session), parameters: shareParams) { (state, info, entity, error) in
            
            if state == SSDKResponseState.success {
                if let handle = success {
                    handle()
                }
            } else {
                if let handle = failed {
                    handle()
                }
            }
        }
    }

4.4 分享文本

分享純文本的時候, 找了半天沒有找到純文本的媒體對象, 后來發(fā)現, 直接設置發(fā)送消息即可, 文檔中也沒用說明, 著實有點坑:

/// 分享文本
    ///
    /// - Parameters:
    ///   - text: 文本
    ///   - session: 分享到的平臺
    ///   - success: 成功的回調
    ///   - failed: 失敗的回調
    class func shareText(_ text: String, to session: LQShareSession, success: (() -> Void)? = nil, failed: (() -> Void)? = nil) {
        
        let shareParams = NSMutableDictionary()
        shareParams.ssdkSetupShareParams(byText: text, images: nil, url: nil, title: nil, type: SSDKContentType.text)
        
        ShareSDK.share(shareSession(session), parameters: shareParams) { (state, info, entity, error) in
            
            if state == SSDKResponseState.success {
                if let handle = success {
                    handle()
                }
            } else {
                if let handle = failed {
                    handle()
                }
            }
        }
    }

4.5 分享視頻

      /// 分享視頻
    ///
    /// - Parameters:
    ///   - url: 視頻url地址
    ///   - thumbImage: 視頻縮略圖
    ///   - title: 視頻標題
    ///   - descr: 視頻描述
    ///   - session: 分享到的平臺
    ///   - success: 分享成功回調
    ///   - failed: 分享失敗回調
    class func shareVideo(_ url: String, thumbImage: String? = nil, title: String? = nil, descr: String? = nil, to session: LQShareSession, success: (() -> Void)? = nil, failed: (() -> Void)? = nil) {
        
        let shareParams = NSMutableDictionary()
        shareParams.ssdkSetupShareParams(byText: descr, images: thumbImage, url: URL.init(string: url), title: title, type: SSDKContentType.video)
        
        ShareSDK.share(shareSession(session), parameters: shareParams) { (state, info, entity, error) in
            
            if state == SSDKResponseState.success {
                if let handle = success {
                    handle()
                }
            } else {
                if let handle = failed {
                    handle()
                }
            }
        }
    }

其他類型的分享, 可直接參考官方文檔或者其API.

文章涉及的demo在Github LQThirdParty, 歡迎Star | Fork

(完)