文章涉及的demo在Github LQThirdParty, 歡迎Star | Fork
一. 注冊(cè)賬號(hào)
首先到Mob的開放平臺(tái)注冊(cè)成為開發(fā)者, 并新建應(yīng)用, 獲得相應(yīng)的 APPID 和 APPSecret .然后到相應(yīng)的第三方平臺(tái)注冊(cè)成為開發(fā)者, 新建應(yīng)用, 獲取對(duì)應(yīng)的AppKey.
二. 集成及配置
2.1 集成
2.1.1 CocoaPods集成
CocoaPods集成好處不多說(shuō), 根據(jù)官方文檔在項(xiàng)目 Podfile 文件 添加相應(yīng)的引入即可:
# UI模塊(非必須,需要用到ShareSDK提供的分享菜單欄和分享編輯頁(yè)面需要以下1行)
pod 'mob_sharesdk/ShareSDKUI'
# 平臺(tái)SDK模塊(對(duì)照一下平臺(tái)柠掂,需要的加上项滑。如果只需要QQ、微信涯贞、新浪微博枪狂,只需要以下3行)
pod 'mob_sharesdk/ShareSDKPlatforms/QQ'
pod 'mob_sharesdk/ShareSDKPlatforms/SinaWeibo'
pod 'mob_sharesdk/ShareSDKPlatforms/WeChat' //(微信sdk不帶支付的命令)
# pod 'mob_sharesdk/ShareSDKPlatforms/WeChatFull’ //(微信sdk帶支付的命令,和上面不帶支付的不能共存宋渔,只能選擇一個(gè))
然后執(zhí)行 pod install ,等待下載完成即可;
2.1.2 手動(dòng)集成
官方文檔
首先下載iOS SDK, 在下載頁(yè)選擇需要的第三方平臺(tái)SDK, 點(diǎn)擊下載即可;
將下載的文件解壓出的兩個(gè)文件夾, 直接拖進(jìn)項(xiàng)目目錄, 具體各個(gè)文件夾的內(nèi)容可參考官方文檔內(nèi)的說(shuō)明進(jìn)行刪減.
注意: 如果是使用Xcode 9+ 新建的項(xiàng)目, 在將文件拖入項(xiàng)目的時(shí)候, 不會(huì)自動(dòng)把庫(kù)文件加載到庫(kù)資源里州疾,以及不會(huì)自動(dòng)添加路徑. 可以先將添加的文件刪除引用, 不是刪除文件移到廢紙簍, Delegate -> Remove References, 然后, 重新右鍵 -> Add Files To..., 找到添加的文件, 重新添加即可.
2.2 配置項(xiàng)目
2.2.1 添加info字段
在項(xiàng)目info.plist文件內(nèi)添加以下字段:
MOBAppKey
MOBAppSecret
其值分別是Mob平臺(tái)新建APP后獲取的AppKey及Secret;
2.2.2 添加系統(tǒng)依賴庫(kù)
在Target -> General -> Linked Frameworks and Libraries 添加
必加依賴庫(kù):
libicucore.tbd
libz.tbd
libstdc++.tbd
JavaScriptCore.framework
以下依賴庫(kù)根據(jù)社交平臺(tái)添加:
新浪微博SDK依賴庫(kù)
ImageIO.framework
libsqlite3.tbd
QQ好友和QQ空間SDK依賴庫(kù)
libsqlite3.tbd
微信SDK依賴庫(kù)
libsqlite3.tbd
2.2.3 在Other Linker Flags加入-ObjC
如果使用了新浪微博SDK, 需要添加
在Target -> Build Setting -> Linking ->Other Linker Flags添加 -ObjC , 注意大小寫.
2.3 設(shè)置 URL Scheme
URL Scheme是通過(guò)系統(tǒng)找到并跳轉(zhuǎn)對(duì)應(yīng)app的設(shè)置,通過(guò)向項(xiàng)目中的info.plist文件中加入U(xiǎn)RL types可使用第三方平臺(tái)所注冊(cè)的appkey信息向系統(tǒng)注冊(cè)你的app皇拣,當(dāng)跳轉(zhuǎn)到第三方應(yīng)用授權(quán)或分享后严蓖,可直接跳轉(zhuǎn)回你的app。
在 Info -> URL Types 中添加:
具體的設(shè)置, 可參考官方文檔中間部分內(nèi)容.
平臺(tái) | 配置URL Scheme 格式舉例 | 備注 |
新浪微博 | wb+微博appKey | 如AppKey:568898243 則為: wb568898243 |
QQ/Qzone(登錄) | “tencent”+騰訊QQ互聯(lián)應(yīng)用appID | 如appID:100371282 則為: tencent100371282 |
QQ/Qzone(分享) | “QQ”+騰訊QQ互聯(lián)應(yīng)用appID的十六進(jìn)制, 必須是8位, 不足8位的前面補(bǔ)0 | 如appID:100371282, 其十六進(jìn)制為: 5fb8b52 , 因?yàn)椴蛔?位,所以應(yīng)寫為: QQ05fb8b52 |
微信 | 微信的appid | wx4868b35061f87885 |
如果是
2.4 適配 iOS 9 +
在iOS 9以上系統(tǒng), 需要添加一些設(shè)置:
2.4.1 配置SSO白名單
在iOS9以上系統(tǒng)需要增加一個(gè)可跳轉(zhuǎn)App的白名單,即LSApplicationQueriesSchemes, 否則將在SDK判斷是否跳轉(zhuǎn)時(shí)用到的canOpenURL時(shí)返回NO谈飒,進(jìn)而只進(jìn)行webview授權(quán)或授權(quán)/分享失敗.
在項(xiàng)目中的info.plist中加入應(yīng)用白名單,右鍵info.plist選擇source code打開, 根據(jù)選擇的平臺(tái)對(duì)以下配置進(jìn)行縮減:
<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>
其他平臺(tái), 可參考官方文檔
2.4.2 網(wǎng)絡(luò)請(qǐng)求
-
方式一: 暫時(shí)回退到HTTP請(qǐng)求
在Info.plist文件中添加字段: NSAppTransportSecurity, 類型為字典;
然后添加一個(gè)Key:NSAllowsArbitraryLoads, 類型為Boolean, 值為 YES
或者以Source Code 打開Info.plist文件, 空白處添加以下代碼:
<key>NSAppTransportSecurity</key>
<dict>
<key>NSAllowsArbitraryLoads</key>
<true/>
</dict>
- 方式二: 設(shè)置域
在項(xiàng)目的info.plist中添加一個(gè)Key:NSAppTransportSecurity,類型為字典類型钾恢。
然后給它添加一個(gè)值: NSExceptionDomains手素,類型為字典類型;
把需要的支持的域添加給NSExceptionDomains
其中域作為Key瘩蚪,類型為字典類型泉懦。
每個(gè)域下面需要設(shè)置3個(gè)屬性:
NSIncludesSubdomains、
NSExceptionRequiresForwardSecrecy疹瘦、NSExceptionAllowsInsecureHTTPLoads崩哩。
均為Boolean類型,值分別為YES言沐、NO邓嘹、YES
微信需要設(shè)置的域?yàn)?
或者以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: 這種方式需要對(duì)每個(gè)要以HTTP方式訪問(wèn)的域名進(jìn)行設(shè)置, 比較麻煩, 建議使用第一種方式.
到此, 相關(guān)的配置就完成了, 下面就是使用相關(guān)的API實(shí)現(xiàn)相應(yīng)的功能.
PS: 如果是Swift項(xiàng)目, 在使用相關(guān)API的時(shí)候, 需要新建橋接頭文件, 或者在已有橋接頭文件內(nèi)引用其頭文件:
#import <ShareSDK/ShareSDK.h>
#import <ShareSDKConnector/ShareSDKConnector.h>
//騰訊開放平臺(tái)(對(duì)應(yīng)QQ和QQ空間)SDK頭文件
#import <TencentOpenAPI/TencentOAuth.h>
#import <TencentOpenAPI/QQApiInterface.h>
//微信SDK頭文件
#import "WXApi.h"
//新浪微博SDK頭文件
#import "WeiboSDK.h"
三. 登錄
以上配置完成, 接下來(lái)的就很簡(jiǎn)單了, 登錄授權(quán)的API相對(duì)比較簡(jiǎn)單.所有平臺(tái)的登錄請(qǐng)參考官方文檔
3.1 注冊(cè)APP
在相應(yīng)的第三方開放平臺(tái)新建APP之后, 獲取到相應(yīng)的APPkey和appSecret; 調(diào)用以下方法進(jìn)行注冊(cè):
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 方法中調(diào)用;
func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplicationLaunchOptionsKey: Any]?) -> Bool {
// Override point for customization after application launch.
LQShareSDK.registApp()
return true
}
3.2 獲取授權(quán)及用戶信息
以上設(shè)置完畢, 只需要在登登錄的事件內(nèi)添加以下獲取授權(quán)的方法即可, 這里我封裝進(jìn)了一個(gè)方法里:
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/新浪微博登錄, 一般常用的也是這三種, 結(jié)果回調(diào)里返回了uid, name, 頭像, 性別. 其他的內(nèi)容可參考文檔獲取.對(duì)象的 rawData 屬性可獲取原始的第三方數(shù)據(jù).
四. 簡(jiǎn)單分享
在創(chuàng)建分享內(nèi)容時(shí), 可使用下面的API進(jìn)行簡(jiǎn)單的分享:
/**
* 設(shè)置分享參數(shù)
*
* @param text 文本
* @param images 圖片集合,傳入?yún)?shù)可以為單張圖片信息,也可以為一個(gè)NSArray险胰,數(shù)組元素可以為UIImage汹押、NSString(圖片路徑)、NSURL(圖片路徑)起便、SSDKImage棚贾。如: @"http://www.mob.com/images/logo_black.png" 或 @[@"http://www.mob.com/images/logo_black.png"]
* @param url 網(wǎng)頁(yè)路徑/應(yīng)用路徑
* @param title 標(biāo)題
* @param type 分享類型
*/
- (void)SSDKSetupShareParamsByText:(NSString *)text
images:(id)images
url:(NSURL *)url
title:(NSString *)title
type:(SSDKContentType)type;
另外, ShareSDK 也有針對(duì)各個(gè)平臺(tái)的分享參數(shù)設(shè)API, 可直接查看其接口文檔.
4.1 使用Mob的分享面板
引入ShareSDK的UI模塊后, 即可使用ShareSDK的分享面板, 在創(chuàng)建分享到各個(gè)平臺(tái)的消息后, 可直接調(diào)用此方法來(lái)彈出分享面板進(jìn)行分享.
#import <ShareSDKUI/ShareSDK+SSUI.h>
class func shareUI() {
let shareParams: NSMutableDictionary = NSMutableDictionary()
shareParams.ssdkSetupShareParams(byText: "分享內(nèi)容", 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: "分享標(biāo)題", type: SSDKContentType.audio)
//1.要顯示菜單的視圖, iPad版中此參數(shù)作為彈出菜單的參照視圖,只有傳這個(gè)才可以彈出我們的分享菜單,可以傳分享的按鈕對(duì)象或者自己創(chuàng)建小的view 對(duì)象,iPhone可以傳nil不會(huì)影響
// 2. 菜單項(xiàng), 需要分享到的平臺(tái), 如果傳nil, 則會(huì)顯示所有已集成的平臺(tái) SSDKPlatformType
// 3. 分享的內(nèi)容
ShareSDK.showShareActionSheet(nil, items: nil, shareParams: shareParams) { (state, type, info, entity, error, end) in
if state == SSDKResponseState.success {
print("分享成功")
} else {
print("分享失敗")
}
}
}
以下用到的shareSession函數(shù)定義如下:
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 分享網(wǎng)頁(yè)
/// 分享網(wǎng)頁(yè)
///
/// - Parameters:
/// - url: 網(wǎng)頁(yè)地址
/// - thumbImage: 網(wǎng)頁(yè)縮略圖
/// - title: 網(wǎng)頁(yè)標(biāo)題
/// - descr: 網(wǎng)頁(yè)描述
/// - session: 分享到的平臺(tái)
/// - success: 成功回調(diào)
/// - failed: 失敗回調(diào)
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: 圖片內(nèi)容, 可以為Data, UIImage, String, 或一組圖片, 當(dāng)為一組圖片時(shí), 只分享第一張
/// - session: 分享到的平臺(tái)
/// - success: 成功的回調(diào)
/// - failed: 失敗的回調(diào)
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 分享文本
分享純文本的時(shí)候, 找了半天沒有找到純文本的媒體對(duì)象, 后來(lái)發(fā)現(xiàn), 直接設(shè)置發(fā)送消息即可, 文檔中也沒用說(shuō)明, 著實(shí)有點(diǎn)坑:
/// 分享文本
///
/// - Parameters:
/// - text: 文本
/// - session: 分享到的平臺(tái)
/// - success: 成功的回調(diào)
/// - failed: 失敗的回調(diào)
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: 視頻標(biāo)題
/// - descr: 視頻描述
/// - session: 分享到的平臺(tái)
/// - success: 分享成功回調(diào)
/// - failed: 分享失敗回調(diào)
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