文章涉及的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
适配iOS 9+ , 添加Scheme白名单
- 方式一
在Info.plist文件内新加字段: LSApplicationQueriesSchemes, 类型为Array(数组)
然后添加内容, 类型为String(字符串)
新浪微博需要添加以下字段:
- sinaweibo
- sinaweibohd
- sinaweibosso
- sinaweibohdsso
- weibosdk
- weibosdk2.5
- 方式二
或者, 在Info.plist文件右键, Open as... -> Source Code, 可打开文件显示源码, 进行编辑, 在倒数第三行(即: 标签的上面)的空白处添加以下代码:
LSApplicationQueriesSchemes
sinaweibo
sinaweibohd
sinaweibosso
sinaweibohdsso
weibosdk
weibosdk2.5
如果还有其他平台的白名单需要添加, 例如微信, QQ, 只需要在
PS: Info.plist文件显示为Source Code后, 如果还想显示原来的列表格式, 可以: 右键 -> Open as.. -> Property List 即可;
适配iOS 9+, 网络请求
- 方式一: 暂时回退到HTTP请求
在Info.plist文件中添加字段: NSAppTransportSecurity, 类型为字典;
然后添加一个Key:NSAllowsArbitraryLoads, 类型为Bool, 值为 YES
或者以Source Code 打开Info.plist文件, 空白处添加以下代码:
NSAppTransportSecurity
NSAllowsArbitraryLoads
- 方式二: 设置域
在项目的info.plist中添加一个Key:NSAppTransportSecurity,类型为字典类型。
然后给它添加一个值: NSExceptionDomains,类型为字典类型;
把需要的支持的域添加給NSExceptionDomains
其中域作为Key,类型为字典类型。
每个域下面需要设置3个属性:NSIncludesSubdomains、NSExceptionRequiresForwardSecrecy、NSExceptionAllowsInsecureHTTPLoads。
均为Boolean类型,值分别为YES、NO、YES
新浪微博需要设置的域有:
- weibo.com
- weibo.cn
- sina.com.cn
或者以Source Code 打开Info.plist文件, 空白处添加以下代码:
NSAppTransportSecurity
NSExceptionDomains
weibo.com
NSExceptionAllowsInsecureHTTPLoads
NSExceptionRequiresForwardSecrecy
NSIncludesSubdomains
weibo.cn
NSExceptionAllowsInsecureHTTPLoads
NSExceptionRequiresForwardSecrecy
NSIncludesSubdomains
sina.com.cn
NSExceptionAllowsInsecureHTTPLoads
NSExceptionRequiresForwardSecrecy
NSIncludesSubdomains
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
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