GSWeiboSDK 3.1.4

GSWeiboSDK 3.1.4

×

测试已测试✗
语言语言 Obj-CObjective C
许可证 MIT
发布最后发布2017年3月

由 Li Junjie 维护。

GSWeiboSDK 3.1.4

  • 作者
  • jingyu11
此库已弃用。

README

为了方便第三方开发者快速集成微博 SDK，我们提供了以下联系方式，协助开发者进行集成：
QQ群：453830884（iOS 请加此群） 226214250（此群已满） 263989257（此群已满）
284084420（此群已满）
邮箱：[email protected]
微博：移动新技术
另外，关于SDK的Bug反馈、用户体验、以及好的建议，请大家尽量提交到 Github 上，我们会尽快解决。
目前，我们正在逐步完善微博 SDK，争取为第三方开发者提供一个规范、简单易用、可靠、可扩展、可定制的 SDK，敬请期待。

概述

微博 iOS 平台 SDK 为第三方应用提供了简单易用的微博API调用服务，使第三方客户端无需了解复杂的验证机制即可进行授权登录，并提供微博分享功能，可直接通过微博官方客户端分享微博。

快速集成

WeiboSDK支持使用Cocoapods集成，请在Podfile中添加以下语句：

pod "WeiboSDK", :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 认证流程进行了简单的封装。
微博登出按钮主要提供一键登出的功能，帮助开发者主动取消用户的授权。

4.OpenAPI通用调用

OpenAPI通用调用接口，帮助开发者访问开放平台open api(微博API)，此外，还提供了一系列封装了open api调用的接口，方便开发者使用。

5. 社会化评论服务、原生关注组件

提供社会化评论按钮和原生关注按钮，简化用户进行关注以及评论的流程。

适用范围

使用此SDK需要满足以下条件

  • 在新浪微博开放平台注册并创建应用
  • 已定义本应用的授权回调页
  • 已选择应用为iOS平台，并正确填写Bundle id和apple id

注意：对于移动客户端应用来说，授权回调页对用户是不可见的，因此定义为何种形式都不会产生影响，但是没有定义将无法使用SDK认证登录。建议使用默认回调页https://api.weibo.com/oauth2/default.html

iOS9的适配问题

由于iOS9的发布影响了微博SDK与应用的集成方式，为了保证良好的应用体验，我们需要采取以下措施：

1.对传输安全的支持

在新一代的iOS系统中，默认需要为每次网络传输建立SSL。解决这个问题有两种方法：

- A.建立白名单并添加到您的app的Info.plist中

<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，并添加到您的app的Info.plist中

<key>NSAppTransportSecurity</key>
<dict>
<key>NSAllowsArbitraryLoads</key>
</true>
</dict>

2.对应用跳转的支持

如果您需要使用微博的相关功能，如登录、分享等，并且需要实现跳转到微博的功能，在iOS9系统中，您需要在您的app的Info.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>
</array>

3.应用瘦身与bitcode

苹果在iOS9的SDK中添加了对应用瘦身的支持，其中包括bitcode。我们也在最新的代码中添加了对bitcode的支持

关于ADSupport集成的问题

关于第三方应用开发者是否集成ADSupport.framework的问题：

  1. 如果开发者希望集成ADSupport.framework，在提交ipa到store时勾选用于跟踪用户广告效果的选项即可。具体操作可参照友盟http://bbs.umeng.com/forum.php？mod=viewthread&tid=6242&aid=1611&from=album&page=1&mobile=2

  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