/weibo_ios_sdk_sso-oauth

sina weibo sdk of sso and Oauth2.0

Primary LanguageObjective-C

概述

此版本微博SDK实现了Oauth2.0认证登录功能，将较复杂的认证签名过程隐藏起来，并将OPEN api的调用进一步包装， 方便第三方应用登录、访问。

名词解释

  • app_key: 微博开放平台上申请第三方应用时分配的app_key
  • app_secret: 微博开放平台上申请第三方应用时分配的app_secret
  • app_redirect_uri: 第三方应用申请完成后，自定义的回调页地址。
  • access_token: 表明用户的身份，用于微博OPEN API的调用。
  • expiration_time: 过期时间，用于判断token值是否过期。

注：app_redirect_uri，即第三方应用登录回调页，可在微博开放平台上找到，具体路径:开放平台->我的应用->应用信息->高级信息->OAuth2.0授权设置->授权回调页；若显示未填写，请设置此属性，否则将造成SDK登陆时错误。

demo使用

  1. 将整个目录下载拷贝至自己的工作空间中；
  2. 打开Xcode，左侧点击右键，选择Add Files to "your_workspace"，选中weibo_sdk_oauth/demo/sinaweibo_sdk_oauth_demo.xcodeproj，确认添加;
  3. 此时直接编译将出错，因为未声明app_key等三个常量，Xcode中修改sinaweibo_sdk_oauth_demo/SNAppDelegate.h文件，将//#define kAppKey @"your app_key"等三行的注释去掉，并根据自己应用的属性给kAppKey等常量赋值；
  4. 编译并在模拟器上运行；
  5. demo只有一个页面，包括登录/退出/获取用户信息/发表状态等按钮；运行后需要先登录才能进行其他操作。

添加SDK至自己工程中

第三方应用使用SDK需要完成DEMO中包含的基本工作。创建自己的工程，并将weibo_sdk_oAuth/src目录下JSONKit和SinaWeibo两个文件夹拷贝至自己工程目录中并添加至工程。

实现Oauth2.0认证登录需实现

  1. 定义app_key，app_secret，app_direct_uri三变量，初始化SinaWeibo对象时使用；
  2. 参照demo实现SinaWeiboDelegate协议，实现后类的对象在初始化SinaWeibo对象时使用；
  3. 创建SinaWeibo对象并初始化，调用[SinaWeibo login]登录，并在实现的SinaWeiboDelegate中监听登录结果；
  4. 退出时调用[SinaWeibo logout]，同样在实现的SinaWeiboDelegate中监听退出结果，其操作可参考DEMO中的实现。

OPEN API的调用

  1. 实现SinaWeiboRequestDelegate协议；
  2. 调用SinaWeibo中- (SinaWeiboRequest *)requestWithURL:.. params:.. httpMethod:.. delegate:..方法实现OPEN API的调用，调用前需初始化url(OPEN API url，以获取用户信息为例，下同，赋值为@"users/show.json")， params(调用接口参数，初始化为[NSMutableDictionary dictionaryWithObject:sinaweibo.userID forKey:@"uid"])，httpMethod(http类型，赋值为@"GET")，_delegate(SinaWeiboRequestDelegate对象)；
  3. 调用完成后SDK将访问结果通过SinaWeiboRequestDelegate对象返回给第三方应用，- (void)request:.. didFailWithError:..接收失败信息，- (void)request:.. didFinishLoadingWithResult:..接收成功的访问结果。

适用范围

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

  • IOS平台
  • 在新浪微博开放平台注册并创建应用
  • 已定义本应用的授权回调页

注: 关于授权回调页对移动客户端应用来说对用户是不可见的，所以定义为何种形式都将不影响，但是没有定义将无法使用SDK认证登录。