[Umeng] 友盟集成 - 第三方登錄/分享

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

一. 注冊賬號

首先到友盟的開放平臺注冊成為開發者, 并新建應用, 獲得相應的 APPKey.然后到相應的第三方平臺注冊成為開發者, 新建應用, 獲取對應的AppKey.

微信開放平臺 , QQ開放平臺, 新浪微博開放平臺

二. 集成及配置

2.1 集成

2.1.1 CocoaPods集成

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

# 集成微信(精簡版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, 點擊下載即可;

1. Document     - U-Share SDK文檔
2. UMSocialDemo - U-Share SDK Demo（如點選下載）
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 根據需要添加;
UMSocialSDKPlugin 用于生成開發者調試log，集成測試完畢后可移除。
到此, 所需文件集成完畢.

2.2 配置項目

接下來,我們需要添加一些系統的依賴庫, 和引用設置;

2.2.1 在Other Linker Flags加入-ObjC

在Target -> Build Setting -> Linking ->Other Linker Flags添加 -ObjC , 注意大小寫.

2.2.2 添加依賴庫

在Target -> General -> Linked Frameworks and Libraries 添加

系統庫:

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 設置 URL Scheme

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

在 Info -> URL Types 中添加:

具體的設置, 可參考官方文檔

2.4 適配 iOS 9 +

在iOS 9以上系統, 需要添加一些設置:

2.4.1 配置SSO白名單

在iOS9以上系統需要增加一個可跳轉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 <UMSocialCore/UMSocialCore.h>

編譯一下, 如果沒有報錯, 即集成完成, 下面可以正常使用相關API了;
在Xcode9 +的版本中, 可能會報找不到頭文件<UMSocialCore/UMSocialCore.h>的錯誤, 只需要將拖進來的文件從目錄中刪除, 不要刪除文件, 刪除引用即可: 右鍵 -> Delegate -> Remove References

屏幕快照 2017-11-16 上午11.26.43.png

然后, 重新右鍵 -> Add Files To..., 找到添加的文件, 重新添加即可.
此時, 再去編譯, 就不會報錯了.

三. 登錄

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

3.1 注冊APP

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

class func registApp() {
        // 打開調試模式日志
        UMSocialManager.default().openLog(true)
        UMSocialManager.default().umSocialAppkey = kUMengAppKey
        //        UMSocialManager.default().umSocialAppSecret = ""
        
        // 關閉強制驗證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 方法中調用;

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

3.2 設置系統回調

系統回調有的API會有系統版本的限制, 具體可參考官方文檔, 這里只給出通用的設置:

func application(_ application: UIApplication, open url: URL, sourceApplication: String?, annotation: Any) -> Bool {
        
        UMSocialManager.default().handleOpen(url,sourceApplication: sourceApplication, annotation: annotation)
        return true
    }

此系統方法, 在iOS 9之后被廢棄了, 建議使用下面的方法:

func application(_ app: UIApplication, open url: URL, options: [UIApplicationOpenURLOptionsKey : Any] = [:]) -> Bool {
        
        UMSocialManager.default().handleOpen(url, options: options)
        return true
    }

但是, 使用上面的API也不會有警告, 如果需要適配iOS 9以下系統, 直接使用上面那個方法即可;

3.3 獲取授權及用戶信息

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

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 {
            // 取消上次授權
            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/新浪微博登錄, 一般常用的也是這三種, 結果回調里返回了uid, name, 頭像, 性別. 其他的內容可參考文檔獲取.對象的 originalResponse屬性可獲取原始的第三方數據.

四. 分享

4.1 使用友盟分享面板

引入友盟UShareUI模塊后, 即可使用友盟的分享面板, 然后根據回調中的類型, 再去創建分享到各個平臺的消息.

#import <UShareUI/UShareUI.h>

UMSocialUIManager.showShareMenuViewInWindow { (type, info) in
            
        }

4.2 分享網頁

// 創建分享內容
        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 = "歡迎關注簡書: 流火緋瞳"
        obj.descr = "一個開發者"
        obj.webpageUrl = "http://www.lxweimin.com/u/2846c3d3a974"
        
        //創建分享消息
        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()
        // 圖片內容 （可以是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"
        // 這兩個屬性設置之后, 不會體現在圖片的分享中
//        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 分享文本

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

let message = UMSocialMessageObject()
message.text = "這是分享的文本內容, 很長很長"

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 = "視頻標題"
        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"
        // 視頻網頁url
        obj.videoUrl = ""
        // 視頻低質量網頁url
        obj.videoLowBandUrl = ""
        
        // 視頻數據流url
        obj.videoStreamUrl = ""
        // 視頻低質量數據流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

(完)

最后編輯于：2017.11.22 10:07:16

?著作權歸作者所有,轉載或內容合作請聯系作者
平臺聲明：文章內容（如有圖片或視頻亦包括在內）由作者上傳并發布，文章內容僅代表作者本人觀點，簡書系信息發布平臺，僅提供信息存儲服務。

人面猴
序言：七十年代末，一起剝皮案震驚了整個濱河市，隨后出現的幾起案子，更是在濱河造成了極大的恐慌，老刑警劉巖，帶你破解...
沈念sama閱讀 230,825評論 6贊 546
死咒
序言：濱河連續發生了三起死亡事件，死亡現場離奇詭異，居然都是意外死亡，警方通過查閱死者的電腦和手機，發現死者居然都...
沈念sama閱讀 99,814評論 3贊 429
救了他兩次的神仙讓他今天三更去死
文/潘曉璐我一進店門，熙熙樓的掌柜王于貴愁眉苦臉地迎上來，“玉大人，你說我怎么就攤上這事。” “怎么了？”我有些...
開封第一講書人閱讀 178,980評論 0贊 384
道士緝兇錄：失蹤的賣姜人
文/不壞的土叔我叫張陵，是天一觀的道長。經常有香客問我，道長，這世上最難降的妖魔是什么？我笑而不...
開封第一講書人閱讀 64,064評論 1贊 319
?港島之戀（遺憾婚禮）
正文為了忘掉前任，我火速辦了婚禮，結果婚禮上，老公的妹妹穿的比我還像新娘。我一直安慰自己，他們只是感情好，可當我...
茶點故事閱讀 72,779評論 6贊 414
惡毒庶女頂嫁案：這布局不是一般人想出來的
文/花漫我一把揭開白布。她就那樣靜靜地躺著，像睡著了一般。火紅的嫁衣襯著肌膚如雪。梳的紋絲不亂的頭發上，一...
開封第一講書人閱讀 56,109評論 1贊 330
城市分裂傳說
那天，我揣著相機與錄音，去河邊找鬼。笑死，一個胖子當著我的面吹牛，可吹牛的內容都是我干的。我是一名探鬼主播，決...
沈念sama閱讀 44,099評論 3贊 450
雙鴛鴦連環套：你想象不到人心有多黑
文/蒼蘭香墨我猛地睜開眼，長吁一口氣：“原來是場噩夢啊……” “哼！你這毒婦竟也來了？” 一聲冷哼從身側響起，我...
開封第一講書人閱讀 43,287評論 0贊 291
萬榮殺人案實錄
序言：老撾萬榮一對情侶失蹤，失蹤者是張志新（化名）和其女友劉穎，沒想到半個月后，有當地人在樹林里發現了一具尸體，經...
沈念sama閱讀 49,799評論 1贊 338
?護林員之死
正文獨居荒郊野嶺守林人離奇死亡，尸身上長有42處帶血的膿包…… 初始之章·張勛以下內容為張勛視角年9月15日...
茶點故事閱讀 41,515評論 3贊 361
?白月光啟示錄
正文我和宋清朗相戀三年，在試婚紗的時候發現自己被綠了。大學時的朋友給我發了我未婚夫和他白月光在一起吃飯的照片。...
茶點故事閱讀 43,750評論 1贊 375
活死人
序言：一個原本活蹦亂跳的男人離奇死亡，死狀恐怖，靈堂內的尸體忽然破棺而出，到底是詐尸還是另有隱情，我是刑警寧澤，帶...
沈念sama閱讀 39,221評論 5贊 365
?日本核電站爆炸內幕
正文年R本政府宣布，位于F島的核電站，受9級特大地震影響，放射性物質發生泄漏。R本人自食惡果不足惜，卻給世界環境...
茶點故事閱讀 44,933評論 3贊 351
男人毒藥：我在死后第九天來索命
文/蒙蒙一、第九天我趴在偏房一處隱蔽的房頂上張望。院中可真熱鬧，春花似錦、人聲如沸。這莊子的主人今日做“春日...
開封第一講書人閱讀 35,327評論 0贊 28
一樁弒父案，背后竟有這般陰謀
文/蒼蘭香墨我抬頭看了看天上的太陽。三九已至，卻和暖如春，著一層夾襖步出監牢的瞬間，已是汗流浹背。一陣腳步聲響...
開封第一講書人閱讀 36,667評論 1贊 296
情欲美人皮
我被黑心中介騙來泰國打工，沒想到剛下飛機就差點兒被人妖公主榨干…… 1. 我叫王不留，地道東北人。一個月前我還...
沈念sama閱讀 52,492評論 3贊 400
代替公主和親
正文我出身青樓，卻偏偏與公主長得像，于是被迫代替她去往敵國和親。傳聞我的和親對象是個殘疾皇子，可洞房花燭夜當晚...
茶點故事閱讀 48,703評論 2贊 380

三个男躁一个女,国精产品一区一手机的秘密,麦子交换系列最经典十句话,欧美国产综合欧美视频

[Umeng] 友盟集成 - 第三方登錄/分享

[Umeng] 友盟集成 - 第三方登錄/分享

一. 注冊賬號

二. 集成及配置

2.1 集成

2.1.1 CocoaPods集成

2.1.2 手動集成

2.2 配置項目

2.2.1 在Other Linker Flags加入-ObjC

2.2.2 添加依賴庫

2.3 設置 URL Scheme

2.4 適配 iOS 9 +

2.4.1 配置SSO白名單

2.4.2 網絡請求

三. 登錄

3.1 注冊APP

3.2 設置系統回調

3.3 獲取授權及用戶信息

四. 分享

4.1 使用友盟分享面板

4.2 分享網頁

4.3 分享圖片

4.4 分享文本

4.5 分享視頻

(完)

推薦閱讀更多精彩內容

三个男躁一个女,国精产品一区一手机的秘密,麦子交换系列最经典十句话,欧美 国产 综合 欧美 视频

[Umeng] 友盟集成 - 第三方登錄/分享

一. 注冊賬號

二. 集成及配置

2.1 集成

2.1.1 CocoaPods集成

2.1.2 手動集成

2.2 配置項目

2.2.1 在Other Linker Flags加入-ObjC

2.2.2 添加依賴庫

2.3 設置 URL Scheme

2.4 適配 iOS 9 +

2.4.1 配置SSO白名單

2.4.2 網絡請求

三. 登錄

3.1 注冊APP

3.2 設置系統回調

3.3 獲取授權及用戶信息

四. 分享

4.1 使用友盟分享面板

4.2 分享網頁

4.3 分享圖片

4.4 分享文本

4.5 分享視頻

(完)

推薦閱讀更多精彩內容

三个男躁一个女,国精产品一区一手机的秘密,麦子交换系列最经典十句话,欧美国产综合欧美视频