闪验、创蓝闪验

服务端升级指南


V2版本服务端接口对接2.3.0以后版本SDK(包含2.3.0)。V2版本接口与V1版本接口不兼容,2.3.0版本以前版本的SDK需对接V1版服务端接口。


V1->V2

  • V2版接口地址变更,由V1的三网三个地址变更为一个地址。
  • V2版接口参数传入参数变更,V1的传入参数都是由2.3.0以前版本SDK返回。V2版传入对应的2.3.0版本SDK只返回token一个参数, 其他参数由APP服务端生成,sign签名参数需要APP服务端实现签名算法进行签名。
  • V2版接口返回的手机号码加解密方式变更。变更为默认AES算法,支持RSA算法,由传入的encryptType字段的值来控制。 V1接口默认是DES算法。


注意事项:

如您之前已经接入了2.3.0以前版本的SDK并已上线使用,此时要接入2.3.0版本SDK,那么需要升级APP服务端代码,对使用新的2.3.0版SDK的APP开发新的APP服务端接口,用于对接V2接口,区别于之前的老版接口,这样逻辑分离便于对接和维护。



Android版本升级指南

   

所有版本通用方式:替换aar包并删除旧版本SDK所有相关的xml,so,aar文件。再导入新版SDK中的所有资源文件(jnilib文件夹中的so库


230.x版本需用户服务端同步升级

2.2.0.x及2.2.1.x的用户可更新至220.6或者221.3版本平滑升级,无服务端变更;

V2.2.x ->V2.3.0

  • 替换aar包和jniLibs文件夹的so库文件;
  • 初始化init方法去除appkey参数
  • 新增授权页的可配置项,授权页背景可设置动态和视频,自定义协议增加至三个,checkbox间距和大小可设置,书名号可去除,可配置授权页全屏显示。
  • 点击一键登录成功返回的result字段,解析成json数据为{

      "token": "" } 置换手机号接口变动,具体需看服务端对接文档。

V2.2.0.2 ->V2.2.1

  • 替换aar包和jniLibs文件夹的so库文件;
  • 修改控件设置背景图片
  • 优化偶现的崩溃问题
  • 添加debug日志开关 OneKeyLoginManager.getInstance().setDebug(true)
  • 协议栏添加居左显示
  • 优化流程逻辑


V2.2.0.1 ->V2.2.0.2

  • 替换aar包和jniLibs文件夹的so库文件;
  • 优化授权页在未销毁完成时,拉起授权页出现默认页面或者空白页面
  • 优化偶现的崩溃问题
  • 添加debug日志开关 OneKeyLoginManager.getInstance().setDebug(true)
  • 协议栏添加居左显示
  • 优化流程逻辑

V2.2.0 ->V2.2.0.1

  • 替换aar包和jniLibs文件夹的so库文件;
  • 更新联通运营商包
  • 优化内存泄漏问题


V2.2.0

  • 替换aar包和jniLibs文件夹的so库文件;
  • 授权页原有控件增加显示隐藏属性,X偏移量;
  • 调用方法由原来的7个方法变更为3个方法,并舍弃监听方法;

     

初始化方法如下:


1 OneKeyLoginManager.getInstance().init(getApplicationContext(), appId, appKey,new InitListener() {
2                            @Override
3                            public void getInitStatus(int code, String result) { 
4                            }
5                        });


V2.1.3

  • 替换aar包和jniLibs 文件夹的so库文件
  • 增加销毁授权页方法,并添加开关参数

     

销毁授权页方法


1O neKeyLoginManager.getInstance().finishAuthActivity();

     

开关参数:true:在点击一键登录后获取到token后自动销毁,false:授权页不销毁,由开发者控制销毁时机

     

1O neKeyLoginManager.getInstance().LoginStart(false); 


V2.1.2

  • 更新sdk库文件 打开libs文件夹,复制其中的aar包替换掉之前旧包,删除上个版本的res中的xml布局文件分别是

     sysdk_activity_onekey_login.xml ---------------  电信免密布局文件

     activity_oauth.xml-----------------------------  联通免密布局文件

     oauth_loading_dialog.xml ---------------------  联通免密布局文件

     打开jnilib文件夹,添加项目对应架构的so库文件,也可以全部添加

  • 更新AndroidManifest.xml(注:移除2.1.1版本中的PermissionActivityOAuthActivity

      

 1<!--****************************联通****************************-->
 2<activity
 3android:name="com.sdk.mobile.ui.OauthActivity"
 4android:configChanges="orientation|keyboardHidden|screenSize"
 5android:launchMode="singleTop"
 6android:screenOrientation="portrait"/>
 7
 8<!--************************移动********************************-->
 9<activity
10android:name="com.cmic.sso.sdk.activity.LoginAuthActivity"
11android:configChanges="orientation|keyboardHidden|screenSize"
12android:launchMode="singleTop"
13android:screenOrientation="portrait"/>
14<!--******************************电信***********************-->
15<activity
16android:name="com.chuanglan.shanyan_sdk.view.ShanYanOneKeyActivity"
17android:screenOrientation="portrait"/>
18<!--******************************协议页***********************-->
19<activity
20android:name="com.chuanglan.shanyan_sdk.view.CTCCPrivacyProtocolActivity"
21android:screenOrientation="portrait"/>



       

IOS版本升级指南

230.x版本需用户服务端同步升级

2.2.0.x及2.2.1.x的用户可更新至220.8或者221.5版本平滑升级,无服务端变更;



手动集成闪验所有版本通用方式:
2.1.3.3以下版本向2.2.0.x/2.2.1版本升级时请替换闪验framework文件夹下静态库以及.bundle资源文件


替换SDK静态库: 删除旧版本SDK所有相关的`.framework``.bundle`文件,清除缓存,再导入新版SDK中的所有`.framework``.bundle`文件(.bundle文件注意保留开发者自定义资源)


远程仓库CocoaPods  pod 集成方式:

1.如之前项目中手动集成过闪验,需删除项目中手动集成的.framework和.bundle资源文件,再进行pod安装

2.如之前项目中未集成或pod集成过闪验,直接pod版本升级至指定版本或最新版即可



V2.2.x ->V2.3.0.x

  • 替换所有sdk包体
  • 初始化init方法去除appkey参数
  • iOS13下,若需全屏显示授权页,请设置baseConfigure.clAuthWindowModalPresentationStyle = @(UIModalPresentationOverFullScreen)
  • 点击一键登录成功返回的token字段为

{

     "token": ""

 } ,

置换手机号接口变动,具体需看服务端对接文档


2.2.0.x -> 2.2.1.2

  • 替换CL_ShanYanSDK.framework即可
  • 创建布局对象,按需设置布局值,再设置到uiconfigure.clOrientationLayOutPortrait属性
  • 若要监控页面拉起和一键登录,可用带区分的拉起授权页方法


2.1.3.x -> 2.2.1

  • 替换所有framework和bundle
  • 创建布局对象,按需设置布局值,再设置到uiconfigure.clOrientationLayOutPortrait属性
  • 若要监控页面拉起和一键登录,可用带区分的拉起授权页方法


2.2.0.4 ->2.2.0.5

  • 替换CL_ShanYanSDK.framework


 2.2.0.3 -> 2.2.0.4

  • 替换所有framework和bundle
  • 可使用原属性配置代码,也可以使用新的属性:
    • 创建布局对象,按需设置布局值,再设置到uiconfigure.clOrientationLayOutPortrait属性
    • 若要监控页面拉起和一键登录,可用带区分的拉起授权页方法


2.2.0.2 -> 2.2.0.3

  • 替换所有framework和bundle
  • 优化无SIM卡时改变用户导航栏透明度
  • 优化部分无SIM卡用户使用hook方法导致的崩溃
  • 优化授权页logo圆角设置不生效bug


2.2.0.1 ->2.2.0.2

  • 替换所有framework和bundle
  • 更新联通SDK至3.7.5版本,提升拉起授权页速度
  • 更新电信SDK至1.5.1支持bitcode版本
  • 优化模拟器奔溃bug
  • 新增一键登录按钮、脱敏手机号默认宽高,解决部分用户使用默认值不显示问题
  • 优化导航栏左侧按钮设置
  • 优化一键登录按钮背景色设置
  • 优化SDK内存释放策略


2.2.0 ->2.2.0.1

  • 替换所有framework和bundle
  • 修复iOS12.0beta系统导致的崩溃bug


2.2.0

  • 升级请替换闪验framework,注意复制.bundle资源文件夹中的图片文件至项目中
  • 完全统一三网界面并且开放更多CLUIConfigure 配置属性
  • 简化拉起授权页传参
  • 新增拉起授权页回调
  • 更多详细信息请关注集成文档


2.1.3.2

  • 更新联通SDK至3.7.5版本,提升拉起授权页速度
  • 更新电信SDK至1.5.1支持bitcode版本


2.1.3.1

  • 修复iOS12.0beta系统导致的崩溃bug
  • 优化联通用户多次点击一键登录产生多次回调问题


2.1.3

  • 替换闪验framework文件
  • 新增`manualDismiss`属性,选择授权页面销毁机制
  • 删除`clNavigationAttrTitle`属性

     更换为一下三个属性

1/**导航栏标题*/
2NSString * clNavText;
3/**导航栏标题字体*/
4UIFont * clNavTextFont;
5/**导航栏标题颜色*/
6UIColor * clNavTextColor;


2.1.2.1_B

  • 替换闪验framework
  • 隐私协议(`《xxx隐私条款》`)/slogan(`由XXX提供认证服务`)Y轴偏移量需要用户端适配


2.1.2_B

  • 删除电信移动Bundle文件(已不需要),替换闪验framework
  • 授权页可直接使用同一份配置,配置类修改为`CLUIConfigure(父类)`,也可以分别配置`CLCTCCUIConfigure``CLCMCCUIConfigure``CLCUCCUIConfigure`
  • 预取号状态查询取消  +(CLSDKPrepareStutas)clSDKQuickLoginPrepareStutas;
  • 隐私协议(`《xxx隐私条款》`)/slogan(`由XXX提供认证服务`)Y轴偏移量需要用户端适配


2.1.1_B

  • SDK初始化内部不再自动预取号,建议开发者手动添加预取号调用,建议在拉起授权页的VC的`-(void)viewDidLoad`中调用或者提前调用
  • 对外的预初始化状态查询方法修改为预取号状态查询:
    • +(CLSDKInitStutas)clSDKInitStutas;
    • +(CLSDKPrepareStutas)clSDKQuickLoginPrepareStutas;


2.0.7 -> 2.1.0

  • 升级请替换account_login_sdk_core.framework、account_verify_sdk_core.framework、OAuth.framework联通静态库、EAccountApiSDK.framework电信静态库,`初次对接`请替换或导入所有framework文件
  • 升级`电信SDK`
  • 升级`联通SDK`
  • 新增联通`授权页`可配置参数
  • 修改`联通`可添加、配置控件Block
  • 新增`电信`隐私条款属性配置


2.0.6.x -> 2.0.7

更换所有framework文件


2.0.5.x -> 2.0.6

授权页页面配置部分属性调整,建议先全部使用默认配置(不设置),再逐一设置 参考`v2.0.6.0:授权页页面配置属性调整`


2.0.2/2.0.3/2.0.4 -> 2.0.5.x/2.0.6/2.0.7

  • SDK初始化接口名更换,原先写在其他位置的初始化可直接转移到appdelegate启动方法中统一初始化且只需调用一次
  • SDK一键登录接口名更换
    • 原先的授权页面添加自定义控件通过创建页面配置类`CLC*CCUIConfigure`的自定义控件block来设置
    • 原先的授权页页面调整通过创建页面配置类`CLC*CCUIConfigure`的属性来设置