[Swift]原生第三方接入: 新浪微博篇--集成/登录/分享

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

关于第三方登录/分享的接入, 很多时候使用的是友盟或者ShareSDK; 但并不是每次都想使用这些第三方的服务的, 这里作者整理了微信, QQ, 新浪微博原生第三方的接入:

[Swift]原生第三方接入: 微信篇--集成/登录/分享/支付
[Swift]原生第三方接入: QQ篇--集成/登录/分享
[Swift]原生第三方接入: 新浪微博篇--集成/登录/分享

1. 集成

1.1 新建应用

新浪微博-开放平台注册成为新浪微博开发者, 然后新建一个应用, 获取到相应的APP Key 以及 App Secret 和授权回调页地址 redirectUri

授权回调页的设置在:"我的应用 - 应用信息 - 高级信息" 中填写;
iOS应用官方推荐使用默认授权回调页!地址为: https://api.weibo.com/oauth2/default.html , 当然也可以自定义, 例如使用本公司官网地址

1.2 集成SDK

Github下载 最新的SDK, 里面含有集成文档.

将文件夹内的libWeiboSDK 文件夹添加到项目工程内, 新版的SDK此文件夹包含: libWeiboSDK.a , WBHttpRequest.h , WBHttpRequest+WeiboToken.h , WeiboSDK.bundle , WeiboSDK.h , WeiboSDK+Statistics.h 六个文件.
然后, 来到项目 Build Settings -> Linking 下的 Other Linker Flags. 添加 -ObjC

添加系统依赖库

到Build Phases -> Link Binary With Libraries ,添加以下系统库:

  • QuartzCore.framework
  • ImageIO.framework
  • SystemConfiguration.framework
  • Security.framework
  • CoreTelephony.framework
  • CoreText.framework
  • UIKit.framework
  • Foundation.framework
  • CoreGraphics.framework
  • libz.dylib
  • libsqlite3.dylib

后两个在新版Xcode中为

  • libz.tbd
  • libsqlite3.tbd
设置工程回调URL Scheme

来到Info-> URL Types, 添加URL Scheme

格式为: wb+AppKey
例如: 你的AppKey是: 123456789
则URL Scheme为: wb123456789

添加URL Scheme
适配iOS 9+ , 添加Scheme白名单
  • 方式一

在Info.plist文件内新加字段: LSApplicationQueriesSchemes, 类型为Array(数组)
然后添加内容, 类型为String(字符串)
新浪微博需要添加以下字段:

  • sinaweibo
  • sinaweibohd
  • sinaweibosso
  • sinaweibohdsso
  • weibosdk
  • weibosdk2.5
  • 方式二

或者, 在Info.plist文件右键, Open as... -> Source Code, 可打开文件显示源码, 进行编辑, 在倒数第三行(即: </dict> 标签的上面)的空白处添加以下代码:

<key>LSApplicationQueriesSchemes</key>
<array>
        <string>sinaweibo</string>
        <string>sinaweibohd</string>
        <string>sinaweibosso</string>
        <string>sinaweibohdsso</string>
        <string>weibosdk</string>
        <string>weibosdk2.5</string>
</array>

如果还有其他平台的白名单需要添加, 例如微信, QQ, 只需要在<array></array>标签内添加对应的字段即可;

PS: Info.plist文件显示为Source Code后, 如果还想显示原来的列表格式, 可以: 右键 -> Open as.. -> Property List 即可;

适配iOS 9+, 网络请求
  • 方式一: 暂时回退到HTTP请求
    在Info.plist文件中添加字段: NSAppTransportSecurity, 类型为字典;
    然后添加一个Key:NSAllowsArbitraryLoads, 类型为Bool, 值为 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

新浪微博需要设置的域有:

新浪微博域

或者以Source Code 打开Info.plist文件, 空白处添加以下代码:

<key>NSAppTransportSecurity</key>
    <dict>
        <key>NSExceptionDomains</key>
        <dict>
            <key>weibo.com</key>
            <dict>
                <key>NSExceptionAllowsInsecureHTTPLoads</key>
                <true/>
                <key>NSExceptionRequiresForwardSecrecy</key>
                <false/>
                <key>NSIncludesSubdomains</key>
                <true/>
            </dict>
            <key>weibo.cn</key>
            <dict>
                <key>NSExceptionAllowsInsecureHTTPLoads</key>
                <true/>
                <key>NSExceptionRequiresForwardSecrecy</key>
                <false/>
                <key>NSIncludesSubdomains</key>
                <true/>
            </dict>
            <key>sina.com.cn</key>
            <dict>
                <key>NSExceptionAllowsInsecureHTTPLoads</key>
                <true/>
                <key>NSExceptionRequiresForwardSecrecy</key>
                <false/>
                <key>NSIncludesSubdomains</key>
                <true/>
            </dict>
        </dict>
    </dict>

PS: 这种方式需要对每个要以HTTP方式访问的域名进行设置, 比较麻烦, 建议使用第一种方式.

到此, 集成及适配结束...

PS: 在使用相关API的时候, 需要新建桥接头文件, 或者在已有桥接头文件内引用其头文件:

#import "WeiboSDK.h"

2. 登录

在AppDelegate.swift中注册app:

WeiboSDK.registerApp(sinaWeiboAppKey)
WeiboSDK.enableDebugMode(true)

在方法 func application(_ app: UIApplication, open url: URL, options: [UIApplicationOpenURLOptionsKey : Any] = [:]) -> Bool 中添加回调:

func application(_ app: UIApplication, open url: URL, options: [UIApplicationOpenURLOptionsKey : Any] = [:]) -> Bool {
  let urlKey: String = options[UIApplicationOpenURLOptionsKey.sourceApplication] as! String
   
  if urlKey == "com.sina.weibo" {
            // 新浪微博 的回调
            return WeiboSDK.handleOpen(url, delegate: self)
        }
        
        return true
}

如果在未安装微博客户端, 使用H5网页进行授权登录的时候, 还需要实现下面这个代理方法:

// 新浪微博的H5网页登录回调需要实现这个方法
    func application(_ application: UIApplication, open url: URL, sourceApplication: String?, annotation: Any) -> Bool {
        // 这里的URL Schemes是配置在 info -> URL types中, 添加的新浪微博的URL schemes
        // 例如: 你的新浪微博的AppKey为: 123456789, 那么这个值就是: wb123456789
        if url.scheme == "URL Schemes" {
            // 新浪微博 的回调
            return LDSinaShare.handle(url)
        }
        
        return true
    }

这个方法在iOS9的时候被废弃, API说是使用上面的代理新方法替换, 但是在使用H5网页登录的时候, 还是会走这个方法.
实现其代理方法:

func didReceiveWeiboRequest(_ request: WBBaseRequest!) {
        
    }
    
func didReceiveWeiboResponse(_ response: WBBaseResponse!) {
        
        guard let res = response as? WBAuthorizeResponse else { return  }
        
        guard let uid = res.userID else { return  }
        guard let accessToken = res.accessToken else { return }
        
        let urlStr = "https://api.weibo.com/2/users/show.json?uid=\(uid)&access_token=\(accessToken)&source=\(sinaWeiboAppKey)"
        
        let url = URL(string: urlStr)
        
        do {
            //                    let responseStr = try String.init(contentsOf: url!, encoding: String.Encoding.utf8)
            
            let responseData = try Data.init(contentsOf: url!, options: Data.ReadingOptions.alwaysMapped)
            
            let dict = try JSONSerialization.jsonObject(with: responseData, options: JSONSerialization.ReadingOptions.allowFragments) as? Dictionary<String, Any>
            
            guard let dic = dict else {
                //获取授权信息异常
                return
            }
            
            print(dic)
            
        } catch {
            
          //获取授权信息异常
        }
    }

然后在需要吊起微博, 发起登录的方法里添加以下代码:

let request = WBAuthorizeRequest()
        request.scope = "all"
        // 此字段的内容可自定义, 在请求成功后会原样返回, 可用于校验或者区分登录来源
        //        request.userInfo = ["": ""]
        request.redirectURI = self.sinaWeibOredirectUri
        
        WeiboSDK.send(request)

其中, 这里的scope字段看参考官方的说明:scope参数官方说明
这样, 就可以吊起微博客户端, 或者打开一个web页面, 发起微博登录.

3. 分享

关于新浪微博的分享文档, 原理我没有找到官方的介绍, 还好其官方demo中这部分内容还算清晰, 根据其官方demo及其API, 给出其实例:
分享结果在其代理方法中获取:

func didReceiveWeiboResponse(_ response: WBBaseResponse!) {

if response is WBSendMessageToWeiboResponse {
            let rm = response as! WBSendMessageToWeiboResponse
            
            if rm.statusCode == WeiboSDKResponseStatusCode.success {
                // 成功
                print("分享成功")
// 如果在创建WBSendMessageToWeiboRequest 实例对象时, accessToken传nil, 这里是获取不到授权信息的
//                let accessToken = rm.authResponse.accessToken
//                let uid = rm.authResponse.userID
                
                let userInfo = rm.requestUserInfo // request 中设置的自定义信息
                
                print("分享成功\n\(userInfo ?? ["假的": ""])")
            } else {
                // 失败
                print("分享失败")
            }    
        }
    }
分享文本
func shareTextToSina() {
        
        let authReq = WBAuthorizeRequest()
        authReq.redirectURI = LDShareUnit.shared.sinaWeibOredirectUri
        authReq.scope = "all"
        
        let message = WBMessageObject()
        message.text = "这是分享到新浪微博的一段文字"
        
        let req: WBSendMessageToWeiboRequest = WBSendMessageToWeiboRequest.request(withMessage: message, authInfo: authReq, access_token: nil) as! WBSendMessageToWeiboRequest
        req.userInfo = ["info": "分享的文字"] // 自定义的请求信息字典, 会在响应中原样返回
        req.shouldOpenWeiboAppInstallPageIfNotInstalled = false // 当未安装客户端时是否显示下载页
        
        WeiboSDK.send(req)
    }
分享图片
func shareImageToSina() {
        
        let authReq = WBAuthorizeRequest()
        authReq.redirectURI = LDShareUnit.shared.sinaWeibOredirectUri
        authReq.scope = "all"
        
        let message = WBMessageObject()
        message.text = "这是分享到新浪微博的一张图片"
        
        let img = WBImageObject()
        
        // 不能超过10M
        let imgData = UIImageJPEGRepresentation(UIImage.init(named: "1.jpg")!, 0.8)
        img.imageData = imgData!
        message.imageObject = img
        
        
        let req: WBSendMessageToWeiboRequest = WBSendMessageToWeiboRequest.request(withMessage: message, authInfo: authReq, access_token: nil) as! WBSendMessageToWeiboRequest
        req.userInfo = ["info": "分享的图片"] // 自定义的请求信息字典, 会在响应中原样返回
        req.shouldOpenWeiboAppInstallPageIfNotInstalled = false // 当未安装客户端时是否显示下载页
        
        WeiboSDK.send(req)
    }

这里需要注意, 如果发送请求之后, 没有吊起微博客户端, 可能的原因为(如果打开其调试模式, 会在控制台输出log信息): 分享的图片数据大于10M

分享多媒体: 网页
func shareWebToSina() {
        let authReq = WBAuthorizeRequest()
        authReq.redirectURI = LDShareUnit.shared.sinaWeibOredirectUri
        authReq.scope = "all"
        
        let message = WBMessageObject()
        message.text = "这是分享到新浪微博的一个网页"

        let web = WBWebpageObject()
//        WBBaseMediaObject
        web.objectID = "对应多媒体的唯一标识"
        web.title = "多媒体的标题"
        web.description = "多媒体内容的描述: 这是一个很努力的作者"
//        web.scheme = "" // 点击多媒体内容时唤起第三方应用的指定页面
        let thumbImg = UIImage(named: "微信@2x.png")// 预览图
        // 不能超过32k
        web.thumbnailData = UIImagePNGRepresentation(thumbImg!)!
        
        web.webpageUrl = "http://www.jianshu.com/u/2846c3d3a974"
        
        message.mediaObject = web
        
        let req: WBSendMessageToWeiboRequest = WBSendMessageToWeiboRequest.request(withMessage: message, authInfo: authReq, access_token: nil) as! WBSendMessageToWeiboRequest
        req.userInfo = ["info": "分享的新闻链接"] // 自定义的请求信息字典, 会在响应中原样返回
        req.shouldOpenWeiboAppInstallPageIfNotInstalled = false // 当未安装客户端时是否显示下载页
        
        let re = WeiboSDK.send(req)
        
        print("------\(re)")
    }

这里需要注意, 如果发送请求之后, 没有吊起微博客户端, 可能的原因为(如果打开其调试模式, 会在控制台输出log信息): 分享的预览图片数据大于32Kb.

(完)

以上便是新浪微博登录分享的所有内容, 如有不正确的地方, 还请评论指出, 或者私信;

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

推荐阅读更多精彩内容