文章涉及的demo在Github LQThirdParty, 歡迎Star | Fork
一. 注冊賬號
首先到友盟的開放平臺注冊成為開發(fā)者, 并新建應(yīng)用, 獲得相應(yīng)的 APPKey.然后到相應(yīng)的第三方平臺注冊成為開發(fā)者, 新建應(yīng)用, 獲取對應(yīng)的AppKey.
二. 集成及配置
2.1 集成
2.1.1 CocoaPods集成
CocoaPods集成好處不多說, 根據(jù)官方文檔在項目 Podfile 文件 添加相應(yīng)的引入即可:
# 集成微信(精簡版0.2M)
pod 'UMengUShare/Social/ReducedWeChat'
# 集成QQ/QZone/TIM(精簡版0.5M)
pod 'UMengUShare/Social/ReducedQQ'
# 集成新浪微博(精簡版1M)
pod 'UMengUShare/Social/ReducedSina'
這里只集成了精簡版的SDK, 能夠滿足登錄及分享需求. 如果還有微信支付, 請將微信SDK換成完整版.
如果使用Swift, 需要在橋接文件, 引入:
#import <UMSocialCore/UMSocialCore.h>
如果使用Objective-C, 在使用的類中引入即可;
PS: 如果項目中使用了微信支付, 請集成完整版微信SDK:
# 集成微信(完整版14.4M)
pod 'UMengUShare/Social/WeChat'
2.1.2 手動集成
官方集成文檔
首先下載iOS SDK, 在下載頁選擇需要的第三方平臺SDK, 點(diǎn)擊下載即可;
1. Document - U-Share SDK文檔
2. UMSocialDemo - U-Share SDK Demo(如點(diǎn)選下載)
3. UMSocial - U-Share SDK核心目錄
UMSocialSDK - U-Share SDK核心framework
UMSocialUI - U-Share 分享UI資源酿箭、分享面板framework
SocialLibraries - 所選擇下載的第三方平臺SDK及U-Share鏈接庫
UMSocialSDKPlugin - SDK需要的依賴插件
主要使用的是 UMSocial 文件夾中的文件:
UMSocialSDK 與 SocialLibraries是必須要添加的,
UMSocialUI 根據(jù)需要添加;
UMSocialSDKPlugin 用于生成開發(fā)者調(diào)試log复亏,集成測試完畢后可移除。
到此, 所需文件集成完畢.
2.2 配置項目
接下來,我們需要添加一些系統(tǒng)的依賴庫, 和引用設(shè)置;
2.2.1 在Other Linker Flags加入-ObjC
在Target -> Build Setting -> Linking ->Other Linker Flags添加 -ObjC , 注意大小寫.
2.2.2 添加依賴庫
在Target -> General -> Linked Frameworks and Libraries 添加
系統(tǒng)庫:
libsqlite3.tbd
CoreGraphics.framework
第三方依賴庫, 以微信/QQ/新浪微博為例, 其他的可參考官方文檔:
注意: 以下依賴庫的添加, 只針對完整版SDK, 精簡版的SDK, 不需要添加
微信(完整版)-精簡版無需添加以下依賴庫
SystemConfiguration.framework
CoreTelephony.framework
libsqlite3.tbd
libc++.tbd
libz.tbd
QQ/QZone/TIM(完整版)-精簡版無需添加以下依賴庫
SystemConfiguration.framework
libc++.tbd
新浪微博(完整版)-精簡版無需添加以下依賴庫
SystemConfiguration.framework
CoreTelephony.framework
ImageIO.framework
libsqlite3.tbd
libz.tbd
2.3 設(shè)置 URL Scheme
URL Scheme是通過系統(tǒng)找到并跳轉(zhuǎn)對應(yīng)app的設(shè)置缭嫡,通過向項目中的info.plist文件中加入URL types可使用第三方平臺所注冊的appkey信息向系統(tǒng)注冊你的app缔御,當(dāng)跳轉(zhuǎn)到第三方應(yīng)用授權(quán)或分享后,可直接跳轉(zhuǎn)回你的app妇蛀。
在 Info -> URL Types 中添加:
具體的設(shè)置, 可參考官方文檔
2.4 適配 iOS 9 +
在iOS 9以上系統(tǒng), 需要添加一些設(shè)置:
2.4.1 配置SSO白名單
在iOS9以上系統(tǒng)需要增加一個可跳轉(zhuǎn)App的白名單耕突,即LSApplicationQueriesSchemes, 否則將在SDK判斷是否跳轉(zhuǎn)時用到的canOpenURL時返回NO,進(jìn)而只進(jìn)行webview授權(quán)或授權(quán)/分享失敗.
在項目中的info.plist中加入應(yīng)用白名單评架,右鍵info.plist選擇source code打開, 根據(jù)選擇的平臺對以下配置進(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>
其他平臺, 可參考官方文檔
2.4.2 網(wǎng)絡(luò)請求
-
方式一: 暫時回退到HTTP請求
在Info.plist文件中添加字段: NSAppTransportSecurity, 類型為字典;
然后添加一個Key:NSAllowsArbitraryLoads, 類型為Boolean, 值為 YES
或者以Source Code 打開Info.plist文件, 空白處添加以下代碼:
<key>NSAppTransportSecurity</key>
<dict>
<key>NSAllowsArbitraryLoads</key>
<true/>
</dict>
- 方式二: 設(shè)置域
在項目的info.plist中添加一個Key:NSAppTransportSecurity古程,類型為字典類型蔼卡。
然后給它添加一個值: NSExceptionDomains,類型為字典類型挣磨;
把需要的支持的域添加給NSExceptionDomains
其中域作為Key雇逞,類型為字典類型。
每個域下面需要設(shè)置3個屬性:
NSIncludesSubdomains茁裙、
NSExceptionRequiresForwardSecrecy塘砸、NSExceptionAllowsInsecureHTTPLoads。
均為Boolean類型晤锥,值分別為YES掉蔬、NO、YES
微信需要設(shè)置的域為:
或者以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方式訪問的域名進(jìn)行設(shè)置, 比較麻煩, 建議使用第一種方式.
到此, 相關(guān)的配置就完成了, 下面就是使用相關(guān)的API實現(xiàn)相應(yīng)的功能.
PS: 如果是Swift項目, 在使用相關(guān)API的時候, 需要新建橋接頭文件, 或者在已有橋接頭文件內(nèi)引用其頭文件:
#import <UMSocialCore/UMSocialCore.h>
編譯一下, 如果沒有報錯, 即集成完成, 下面可以正常使用相關(guān)API了;
在Xcode9 +的版本中, 可能會報找不到頭文件<UMSocialCore/UMSocialCore.h>的錯誤, 只需要將拖進(jìn)來的文件從目錄中刪除, 不要刪除文件, 刪除引用即可: 右鍵 -> Delegate -> Remove References
然后, 重新右鍵 -> Add Files To..., 找到添加的文件, 重新添加即可.
此時, 再去編譯, 就不會報錯了.
三. 登錄
以上配置完成, 接下來的就很簡單了, 登錄授權(quán)的API相對比較簡單.所有平臺的登錄請參考官方文檔
3.1 注冊APP
在相應(yīng)的開放平臺新建APP之后, 獲取到相應(yīng)的APPkey和appSecret; 調(diào)用以下方法進(jìn)行注冊:
class func registApp() {
// 打開調(diào)試模式日志
UMSocialManager.default().openLog(true)
UMSocialManager.default().umSocialAppkey = kUMengAppKey
// UMSocialManager.default().umSocialAppSecret = ""
// 關(guān)閉強(qiáng)制驗證https, 即可分享http鏈接圖片
UMSocialGlobal.shareInstance().isUsingHttpsWhenShareContent = false
//注冊微信
UMSocialManager.default().setPlaform(UMSocialPlatformType.wechatSession, appKey: kWechatAppID, appSecret: kWechatAppSecret, redirectURL: "")
//注冊QQ
UMSocialManager.default().setPlaform(UMSocialPlatformType.QQ, appKey: kQQAppID, appSecret: nil, redirectURL: "")
// 注冊新浪微博
UMSocialManager.default().setPlaform(UMSocialPlatformType.sina, appKey: kSinaWeiboAppKey, appSecret: kSinaWeiboAppSecret, redirectURL: kSinaWeibOredirectUri)
}
此方法要在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.
LQUmengTool.registApp()
return true
}
3.2 設(shè)置系統(tǒng)回調(diào)
系統(tǒng)回調(diào)有的API會有系統(tǒng)版本的限制, 具體可參考官方文檔, 這里只給出通用的設(shè)置:
func application(_ application: UIApplication, open url: URL, sourceApplication: String?, annotation: Any) -> Bool {
UMSocialManager.default().handleOpen(url,sourceApplication: sourceApplication, annotation: annotation)
return true
}
此系統(tǒng)方法, 在iOS 9之后被廢棄了, 建議使用下面的方法:
func application(_ app: UIApplication, open url: URL, options: [UIApplicationOpenURLOptionsKey : Any] = [:]) -> Bool {
UMSocialManager.default().handleOpen(url, options: options)
return true
}
但是, 使用上面的API也不會有警告, 如果需要適配iOS 9以下系統(tǒng), 直接使用上面那個方法即可;
3.3 獲取授權(quán)及用戶信息
以上設(shè)置完畢, 只需要在登登錄的事件內(nèi)添加以下獲取授權(quán)的方法即可, 這里我封裝進(jìn)了一個方法里:
class func login(_ type: LQPlatformType, handle: @escaping ((_ uid: String, _ name: String, _ url: String, _ sex: String) -> Void)) {
var loginType: UMSocialPlatformType? = nil
if type == .QQ {
loginType = UMSocialPlatformType.QQ
} else if type == .Wechat {
loginType = UMSocialPlatformType.wechatSession
} else if type == .SinaWeibo {
loginType = UMSocialPlatformType.sina
}
if let login = loginType {
// 取消上次授權(quán)
UMSocialManager.default().cancelAuth(with: login) { (result, error) in }
UMSocialManager.default().getUserInfo(with: login, currentViewController: nil) { (result, error) in
if let resp = result as? UMSocialUserInfoResponse {
var uid = ""
if resp.uid != nil {
uid = resp.uid!
}
var name = ""
if resp.name != nil {
name = resp.name!
}
var icon = ""
if resp.iconurl != nil {
icon = resp.iconurl
}
var gender = ""
if resp.unionGender != nil {
gender = resp.unionGender!
}
handle(uid, name, icon, gender)
} else {
print(error!)
}
}
}
}
其中 LQPlatformType 為登錄的類型:
enum LQPlatformType {
case QQ, Wechat, SinaWeibo
}
這里只使用了微信/QQ/新浪微博登錄, 一般常用的也是這三種, 結(jié)果回調(diào)里返回了uid, name, 頭像, 性別. 其他的內(nèi)容可參考文檔獲取.對象的 originalResponse屬性可獲取原始的第三方數(shù)據(jù).
四. 分享
4.1 使用友盟分享面板
引入友盟UShareUI模塊后, 即可使用友盟的分享面板, 然后根據(jù)回調(diào)中的類型, 再去創(chuàng)建分享到各個平臺的消息.
#import <UShareUI/UShareUI.h>
UMSocialUIManager.showShareMenuViewInWindow { (type, info) in
}
4.2 分享網(wǎng)頁
// 創(chuàng)建分享內(nèi)容
let obj = UMShareWebpageObject()
obj.thumbImage = "https://timgsa.baidu.com/timg?image&quality=80&size=b9999_10000&sec=1510824926407&di=73ce61c358f9947833d03e13aa9712dc&imgtype=0&src=http%3A%2F%2Fimage.tianjimedia.com%2FuploadImages%2F2013%2F255%2FHP4C7KBZQ0YP.jpg"
obj.title = "歡迎關(guān)注簡書: 流火緋瞳"
obj.descr = "一個開發(fā)者"
obj.webpageUrl = "http://www.reibang.com/u/2846c3d3a974"
//創(chuàng)建分享消息
let message = UMSocialMessageObject(mediaObject: obj)
UMSocialManager.default().share(to: UMSocialPlatformType.wechatSession, messageObject: message, currentViewController: nil) { (info, error) in
if let respons = info as? UMSocialShareResponse {
print(respons.message)
print(respons.originalResponse)
}
}
4.3 分享圖片
let obj = UMShareImageObject()
// 圖片內(nèi)容 (可以是UIImage類對象矾瘾,也可以是NSdata類對象女轿,也可以是圖片鏈接imageUrl NSString類對象)
obj.shareImage = "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"
// 這兩個屬性設(shè)置之后, 不會體現(xiàn)在圖片的分享中
// obj.title = "分享一個美女"
// obj.descr = "自己看看得了, 不要到處說"
// 分享圖片的縮略圖
obj.thumbImage = "https://timgsa.baidu.com/timg?image&quality=80&size=b9999_10000&sec=1510824926407&di=73ce61c358f9947833d03e13aa9712dc&imgtype=0&src=http%3A%2F%2Fimage.tianjimedia.com%2FuploadImages%2F2013%2F255%2FHP4C7KBZQ0YP.jpg"
let message = UMSocialMessageObject(mediaObject: obj)
UMSocialManager.default().share(to: UMSocialPlatformType.wechatSession, messageObject: message, currentViewController: nil) { (info, error) in
if let respons = info as? UMSocialShareResponse {
print(respons.message)
print(respons.originalResponse)
}
}
4.4 分享文本
分享純文本的時候, 找了半天沒有找到純文本的媒體對象, 后來發(fā)現(xiàn), 直接設(shè)置發(fā)送消息即可, 文檔中也沒用說明, 著實有點(diǎn)坑:
let message = UMSocialMessageObject()
message.text = "這是分享的文本內(nèi)容, 很長很長"
UMSocialManager.default().share(to: UMSocialPlatformType.wechatSession, messageObject: message, currentViewController: nil) { (info, error) in
if let respons = info as? UMSocialShareResponse {
print(respons.message)
print(respons.originalResponse)
}
}
4.5 分享視頻
let obj = UMShareVideoObject()
obj.title = "視頻標(biāo)題"
obj.descr = "視頻描述"
// 視頻縮略圖
obj.thumbImage = "https://timgsa.baidu.com/timg?image&quality=80&size=b9999_10000&sec=1510824926407&di=73ce61c358f9947833d03e13aa9712dc&imgtype=0&src=http%3A%2F%2Fimage.tianjimedia.com%2FuploadImages%2F2013%2F255%2FHP4C7KBZQ0YP.jpg"
// 視頻網(wǎng)頁url
obj.videoUrl = ""
// 視頻低質(zhì)量網(wǎng)頁url
obj.videoLowBandUrl = ""
// 視頻數(shù)據(jù)流url
obj.videoStreamUrl = ""
// 視頻低質(zhì)量數(shù)據(jù)流url
obj.videoLowBandStreamUrl = ""
let message = UMSocialMessageObject(mediaObject: obj)
UMSocialManager.default().share(to: UMSocialPlatformType.wechatSession, messageObject: message, currentViewController: nil) { (info, error) in
if let respons = info as? UMSocialShareResponse {
print(respons.message)
print(respons.originalResponse)
}
}
其他類型的分享, 可直接參考官方文檔或者其API.
文章涉及的demo在Github LQThirdParty, 歡迎Star | Fork