快速集成

更新时间:2017/02/24 访问次数:23223

iOS快速集成

1. 前置准备

  1. 百川控制台-SDK下载页面下载云账号iOS SDK,下载的SDK中包含了demo,可以作为参考
  2. 百川控制台-我的产品后台开通云账号权限
  3. 将控制台下载的安全图片yw_1222.jpg放置到主工程目录下

2. 集成SDK

2.1 pod集成

  1. 添加pod依赖

    source "http://repo.baichuan-ios.taobao.com/baichuanSDK/AliBCSpecs.git"
    platform :ios, '7.0'
    pod 'ALBBOpenAccountSDK'
  2. 将ALBBOpenAccountUI.framework中的xib放置到主工程目录下

2.2 SDK手动下载集成

  1. 百川控制台-SDK下载页面下载云账号iOS SDK(请不要在文档中心页面下载SDK,在百川控制台下载,保证SDK是最新版本)

  2. 将SDK目录下resource/ALBBOpenAccount.bundle以及所有的xib导入xcode工程里

  3. 设置Link Flags,在Target->Build Setting->Linking->Other Linker Flags中添加-ObjC,-lstdc++选项

  4. 添加以下基础库,如图:
    image

3. SDK依赖说明

  1. 基础功能依赖(必选项):

    ALBBOpenAccountSDK.framework
    ALBBOpenAccountUI.framework
    OpenMtopExt.framework
    OpenMtopSDK.framework
    SecurityGuardSDK.framework
    SGMain.framework
    SGNoCaptcha.framework
    SGSecurityBody.framework
    UTDID.framework
    UTMini.framework
  2. 扩展功能-三方授权登录依赖(可选项)

    ALBBOpenAccountSSO.framework
    //下面两项为淘宝授权登录依赖
    AlibabaAuthExt.framework
    AlibabaAuthSDK.framework

4. SDK初始化

  1. 导入基础SDK头文件

    #import <ALBBOpenAccountSDK/ALBBOpenAccountSDK.h>
  2. SDK初始化,建议放在didFinishLaunchingWithOptions中

    - (void)initOpenAccount {
        //开发阶段打开日志开关,方便排查错误信息
        [[ALBBOpenAccountSDK sharedInstance] setDebugLogOpen:YES];
    
        [[ALBBOpenAccountSDK sharedInstance] asyncInit:^{
           //初始化成功
        } failure:^(NSError *error) {
           //初始化失败
        }];
    }

5. 云账号基础功能

云账号基础功能见ALBBOpenAccountUI.framwork/ALBBOpenAccountUIService.h,此处以账密登录举例:

  1. 获取ALBBOpenAccountUIService实例

    id<ALBBOpenAccountUIService> uiService = ALBBService(ALBBOpenAccountUIService);
  2. 显示账密登录页

    [uiService showLoginInNavigationController:self.navigationController  success:^(ALBBOpenAccountSession *currentSession) {
        //登录成功回调
        [MyAlertView alert:[NSString stringWithFormat:@" 登录成功 \n token:%@ \n user:%@", [currentSession getAuthToken], [currentSession getUser]]];
    
    } failure:^(NSError *error) {
        //登录失败回调
        [MyAlertView alert:[NSString stringWithFormat:@" 登录失败 \n error:%@", error]];
    
    }];
  3. 登录成功后查询云账号信息, 回调结果中返回ALBBOpenAccountSession,代表了当前云账号的会话信息,它是一个单例

    [[ALBBOpenAccountSession sharedInstance] getUser]       //获取云账号的用户信息
         //判断当前是否有云账号登录
        [[ALBBOpenAccountSession sharedInstance] isLogin]
        //注销当前云账号
         [[ALBBOpenAccountSession sharedInstance] logout];

6. 免登云旺

使用新版云旺sdk,将云旺登录接口中的登录类型YWLoginTypeRawPassword改为YWLoginTypeOpenID,然后用户名密码使用openaccount提供的openaccountid和sessionid。

FAQ

关于此文档暂时还没有FAQ
返回
顶部