服务端升级指南
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版本升级指南
注意: 三网运营商内部执行不同,升级完成必须分别使用三网运营商的卡进行测试,防止功能异常!
v2.3.7.0 -->v2.3.7.1
v2.3.6.4 -->v2.3.7.0
- 替换aar包
- 替换混淆规则
- 更新隐私政策采集信息描述
注意:创蓝闪验SDK内置的移动号码认证SDK,自5.9.12版本起新增了OAID信息采集,如果您使用创蓝闪验SDK 2.3.7.0及之后的版本,需要在隐私政策中移动号码认证SDK相关采集信息名称里新增OAID,以免造成自身APP产品出现违规行为。
v2.3.4.3 -->v2.3.6.4
- 替换aar包
- 删除AndroidManifest中CmccLoginActivity、GenLoginAuthActivity相关注册配置
v2.3.3.9 -->v2.3.4.3
- 删除libCtaApiLib.so、libShanYCore.so(已经打到aar包中)
- 替换aar包(如果是采用maven集成,修改依赖的SDK版本号)
- 按照对接文档修改manifest中授权页LoginAuthActivity的包名类名(LoginAuthActivity改成com.cmic.gen.sdk.view.GenLoginAuthActivity);activity的主题、方向等其他配置不用修改
- 按照文档修改混淆规则
v2.3.3.0 -->v2.3.3.9
- 替换aar包和jniLibs文件夹的so库文件
- 按照对接文档修改manifest中授权页LoginAuthActivity的名字
v2.3.2.x -->2.3.3.0
- 替换aar包和jniLibs文件夹的so库文件
- 对于全局禁用Http的项目,需要新增10010.com为Http白名单。即项目中需要添加两个:cmpassport.com和10010.com(如果使用android:usesCleartextTraffic="true"配置支持http的,可忽略此条)
v2.3.1.x ->v2.3.2.0
- 替换aar包和jniLibs文件夹的so库文件
- 修改混淆规则
v2.3.0.x ->v2.3.1.x
- 替换aar包和jniLibs文件夹的so库文件
- 替换manifest里面的activity配置
- 新增普通权限(CHANGE_WIFI_STATE)
iOS版本升级指南
v2.3.4.6->2.3.4.x及以上版本
- 替换所有sdk包体:删除原sdk所有包体,添加framework文件夹中所有包体
- 支持iOS12以下的项目需要导入Network.framework这个包,并将项目设置target -> 选项卡Build Phase -> LinkedBinary with Libraries 中该库status设置为Optional。
v2.3.0.x ->v2.3.4.x
- 替换所有sdk包体:删除原sdk所有包体,添加framework文件夹中所有包体
- 重要:如项目中使用闪验vcclass的字符串判断类名等非常规操作,如"ZUOAuthViewController"、"UAAuthViewController"、"PublicLoginViewController"、"CLCTCCCarouselViewController"、"CLCTCCCarouselNavigationController"、"UANavigationController"、"CLCTCCPublicLoginNavigationController"、"CLShanYanAuthPageIsaSwizzleNavigationController",现已统一为:CLShanYanAuthPageNavigationController(授权页nav)、CLShanYanAuthPageViewController(授权页vc)、CLCTCCCarouselNavigationController(弹窗模式下协议页nav)、CLCTCCCarouselViewController(协议页vc)
- 现sdk回调默认为全局global队列,如需UI操作请务必自行切换到主线程
v2.3.0.x ->v2.3.1.x
- 替换所有sdk包体
- 删除隐私协议 clAppPrivacyLineFragmentPadding、clAppPrivacyContentInset属性,目前只要设置clAppPrivacyTextContainerInset属性即可达到设置文本内边距的效果
Harmony端升级指南
手动集成闪验所有版本通用方式:
替换SDK包: 删除旧版本SDK所有相关的.har
文件,清除缓存,再导入新版SDK中的所有.har
文件。
低版本->1.0.0.5以上版本
-
原始导入方式
import { CLResult, CLSDKManager } from 'shanyansdk'
改为
import { CLResult, CLSDKManager } from '@shanyan/shanyansdk'
-
本地依赖方式更改:
"dependencies": {
"shanyansdk": "file:../ShanYanSDK"
}
修改为
"dependencies": {
"@shanyan/shanyansdk": "file:../ShanYanSDK"
}
WEB端升级指南
v3.0.0.0 ->v3.0.0.1
v2.0.0.4 ->v3.0.0.0
- 替换js SDK包
- 按照新版文档,移除电信初始化方法,修改电信token获取逻辑
v2.0.0.2 ->v2.0.0.4
v2.0.0.1 ->v2.0.0.2
- 替换js SDK包
- 移除启动授权页方法appid入参
没有更多了