Awesome
ReadMe
为了方便第三方开发者快速集成微博 SDK,我们提供了以下联系方式,协助开发者进行集成:
QQ群:453830884(iOS 请加此群)
226214250(此群已满)
263989257(此群已满)
284084420(此群已满)
邮箱:sdk4wb@sina.cn
微博:移动新技术
另外,关于SDK的Bug反馈、用户体验、以及好的建议,请大家尽量提交到 Github 上,我们会尽快解决。
目前,我们正在逐步完善微博 SDK,争取为第三方开发者提供一个规范、简单易用、可靠、可扩展、可定制的 SDK,敬请期待。
概述
微博 iOS 平台 SDK 为第三方应用提供了简单易用的微博API调用服务,使第三方客户端无需了解复杂的验证机制即可进行授权登陆,并提供微博分享功能,可直接通过微博官方客户端分享微博。
#快速集成 WeiboSDK支持使用Cocoapods集成,请在Podfile中添加以下语句:
pod "Weibo_SDK", :git => "https://github.com/sinaweibosdk/weibo_ios_sdk.git"
#API文档 http://sinaweibosdk.github.io/weibo_ios_sdk/index.html
#常见问题 FAQ https://github.com/sinaweibosdk/weibo_ios_sdk/blob/master/FAQ.md
名词解释
名词 | 注解 |
---|---|
AppKey | 分配给每个第三方应用的 app key。用于鉴权身份,显示来源等功能。 |
RedirectURI | 应用回调页面,可在新浪微博开放平台->我的应用->应用信息->高级应用->授权设置->应用回调页中找到。 |
AccessToken | 表示用户身份的 token,用于微博 API 的调用。 |
Expire in | 过期时间,用于判断登录是否过期。 |
功能列表
1. 认证授权
为开发者提供 Oauth2.0 授权认证,并集成 SSO 登录功能。
2. 微博分享
从第三方应用分享信息到微博,目前只支持通过微博官方客户端进行分享。
3. 登入登出
微博登入按钮主要是简化用户进行 SSO 登陆,实际上,它内部是对 SSO 认证流程进行了简单的封装。
微博登出按钮主要提供一键登出的功能,帮助开发者主动取消用户的授权。
适用范围
使用此SDK需满足以下条件:
- 在新浪微博开放平台注册并创建应用
- 已定义本应用的授权回调页
- 已选择应用为iOS平台,并正确填写Bundle id和appple id
注: 关于授权回调页对移动客户端应用来说对用户是不可见的,所以定义为何种形式都将不影响,但是没有定义将无法使用SDK认证登录。建议使用默认回调页 https://api.weibo.com/oauth2/default.html
iOS9的适配问题
由于iOS9的发布影响了微博SDK与应用的集成方式,为了确保好的应用体验,我们需要采取如下措施: ###1.对传输安全的支持 在新一代的iOS系统中,默认需要为每次网络传输建立SSL。解决这个问题有两种方法:
- A.建立白名单并添加到你的app的plsit中
- <key>NSAppTransportSecurity</key> <dict> <key>NSExceptionDomains</key> <dict> <key>sina.cn</key> <dict> <key>NSIncludesSubdomains</key> <true/> <key>NSThirdPartyExceptionRequiresForwardSecrecy</key> <false/> </dict> <key>weibo.cn</key> <dict> <key>NSIncludesSubdomains</key> <true/> <key>NSThirdPartyExceptionRequiresForwardSecrecy</key> <false/> </dict> <key>weibo.com</key> <dict> <key>NSIncludesSubdomains</key> <true/> <key>NSThirdPartyExceptionAllowsInsecureHTTPLoads</key> <true/> <key>NSThirdPartyExceptionRequiresForwardSecrecy</key> <false/> </dict> <key>sinaimg.cn</key> <dict> <key>NSIncludesSubdomains</key> <true/> <key>NSThirdPartyExceptionAllowsInsecureHTTPLoads</key> <true/> <key>NSThirdPartyExceptionRequiresForwardSecrecy</key> <false/> </dict> <key>sinajs.cn</key> <dict> <key>NSIncludesSubdomains</key> <true/> <key>NSThirdPartyExceptionAllowsInsecureHTTPLoads</key> <true/> <key>NSThirdPartyExceptionRequiresForwardSecrecy</key> <false/> </dict> <key>sina.com.cn</key> <dict> <key>NSIncludesSubdomains</key> <true/> <key>NSThirdPartyExceptionAllowsInsecureHTTPLoads</key> <true/> <key>NSThirdPartyExceptionRequiresForwardSecrecy</key> <false/> </dict> </dict> </dict>
如果没有添加可能会遇到"An SSL error has occurred and a secure connection to the server cannot be made."这样的问题。
- B.强制将NSAllowsArbitraryLoads属性设置为YES,并添加到你应用的plist中
- <key>NSAppTransportSecurity</key> <dict> <key>NSAllowsArbitraryLoads</key> </true> </dict>
###2.对应用跳转的支持 如果你需要用到微博的相关功能,如登陆,分享等。并且需要实现跳转到微博的功能,在iOS9系统中就需要在你的app的plist中添加下列键值对。否则在canOpenURL函数执行时,就会返回NO。了解详情请至https://developer.apple.com/videos/wwdc/2015/?id=703
- <key>LSApplicationQueriesSchemes</key> <array> <string>sinaweibohd</string> <string>sinaweibo</string> <string>weibosdk</string> <string>weibosdk2.5</string> <string>weibosdk3.3</string> </array>
###3.应用瘦身与bitcode 苹果在iOS9的SDK中添加了对应用的瘦身的支持,其中就包括bitcode。我们也在最新的代码中添加了对bitcode的支持
关于ADSupport集成的问题
关于第三方应用开发者是否集成ADSupport.framework的问题:
-
如果开发者希望集成ADSupport.framework,在进行ipa提交store时候勾选用于跟踪用户广告效果的选项即可。具体操作可参照友盟 http://bbs.umeng.com/forum.php?mod=viewthread&tid=6242&aid=1611&from=album&page=1&mobile=2
-
如果开发者希望不集成ADSupport.framework,直接删去即可,微博SDK的使用并非强制要求第三方开发者集成ADSupport.framework。不集成ADSupport.framework不会影响WeiboSDK的正常使用。
关于ipv6支持的问题
由于苹果商店6月1日起,强制app需要支持ipv6-only的网络。微博sdk这边也做了支持,更新了使用的底层网络代码,包括reachability库。
iOS10的适配问题
由于iOS10的发布,原有ATS设置在iOS10上会出现https网络访问限制的问题,为了确保好的应用体验,我们需要采取如下措施:
-
<key>sina.com.cn</key> <dict> <key>NSIncludesSubdomains</key> <true/> <key>NSThirdPartyExceptionAllowsInsecureHTTPLoads</key> <true/> <key>NSExceptionMinimumTLSVersion</key> <string>TLSv1.0</string> <key>NSThirdPartyExceptionRequiresForwardSecrecy</key> <false/> </dict>
需要在每一个域名下添加NSExceptionMinimumTLSVersion这样的key,值的部分为TLSv1.0
3.2.0版本更新
微博移动SDK3.2,围绕 “分享+连接” 这个核心主题,面向开发者,规划的主要功能模块只有4个:SDK初始化、用微博帐号登录、分享到微博、连接到微博。其他的功能已经转移,下线或在未来不久的版本即将下线。具体变动的功能如下:
- 热评与关系化组件下线
- 私信分享功能,私信应用推荐功能下线
- SDK不再包装访问openAPI的接口,SDK对外提供的网络访问工具WBHttpRequest也将逐步下线,开发者微博后期使用微博openAPI接口时,需要使用自己网络模块并按照平台的接口文档进行调用
- 短信注册登录功能下线
- 多媒体分享功能整体修改,在微博客户端7.5.0后的版本,分享到发布器的多媒体对象将不再以linkcard显示,转而以文本链接的形式插入到分享的文本中。(该功能的修改不会影响到分享内容在信息里的显示,凡是经过商务对接的第三方,发出去的多媒体对象在信息流中就会显示linkcard)并且该功能在后期会进一步修改。
同时在新的SDK中还有部分功能未完善,会在近期的版本更新中逐步完善:
- 由于部分H5模块针对TLS1.2的支持还有问题,所以目前SDK的ATS还不能完全打开
- 连接到微博的功能还有部分不太完善,将在后期的版本中逐步修改
3.2.1版本更新
微博移动SDK3.2.1,精简了原有的统计功能,更新原有的分享功能,使分享功能更加丰富。具体的变动如下:
- 统计功能调整,预计后期以组件的形式提供
- 原有图片分享功能由粘贴板单图的形式,扩展为相册多图,视频的模式
- 新增分享到story功能,形式为单图或视频。
3.2.5版本更新
微博移动SDK3.2.5具体的变动如下:
- 替换UIWebView控件
- 适配iOS13,禁用暗黑模式,全屏展示页面
- 删除无用代码及“支付”相关字符,优化内容,缩减包大小
3.2.6版本更新
微博移动SDK3.2.6具体的变动如下:
- 修复部分页面适配问题及iTunes下载链接失效问题
- 修复issue中部分问题
- 文档修改,增加常见问题解答
3.2.7版本更新
微博移动SDK3.2.7具体的变动如下:
- 替换NSURLConnection相关API
- 替换UIAlertView相关API
- 增加i386架构
3.3.0版本更新
微博移动SDK3.3.0具体的变动如下:
- 增加支持universalLink分享跳转
- 修改ios14 分享多图和视频丢数据问题
- 可以设置不获取idfa
- 去掉分享获取相册权限
注意:更新3.3.0版本一定要在工程scheme白名单添加 weibosdk3.3,不然ios14 配备不生效
3.3.1版本支持分享超话
注意:
1.使用分享超话功能,微博app必须升级到 11.6.2版本以上(包含)
2.如果需要分享超话功能,请联系我们商务,开通功能权限
3.3.2版本支持分享livephoto
注意:使用分享livephoto功能,微博app必须升级到 11.7.2版本以上(包含)
3.3.3下线获取设备信息
注意:sdk不再获取用户设备信息,如果:idfa、idfv等
3.3.4 iOS16 适配
更新内容:
- 适配iOS16
- 解决当前已知bug,明确了部分注释的含义
- 去掉了+ (void)checkUniversalLink:(void (^_Nullable)(WBULCheckStep step, NSError * _Nullable error))checkBlock 接口
- 跳转微博12.9.3以及之后版本,返回时会在response内收到对应的操作信息。
3.3.5 下掉获取idfa代码
更新内容:
在代码层,下掉了idfa获取代码
3.3.6 版本更新
微博移动SDK3.3.6具体变动如下,请开发者尽快更新。
- 修复了已知的功能问题
- 优化了已知的安全合规问题
3.3.7 版本更新
微博移动SDK3.3.7具体变动如下,请开发者尽快更新。
- 改善SDK稳定性,增强性能和安全性
3.3.8 版本更新
微博移动SDK3.3.8具体变动如下:
- 添加隐私清单文件