服务端升级指南
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.6.5 -->v2.3.6.8
v2.3.6.4 -->v2.3.6.5
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版本升级指南
2.3.x版本需与服务端同步升级
220及221的用户可更新至220.x或者221.x最新版本平滑升级,无服务端变更
手动集成闪验所有版本通用方式: 22.x版本向高版本升级时请替换闪验framework文件夹下所有静态库以及.bundle资源文件
替换SDK静态库: 删除旧版本SDK所有相关的.framework``.bundle
文件,清除缓存,再导入新版SDK中的所有.framework``.bundle
文件(.bundle文件注意保留开发者自定义资源)
远程仓库CocoaPods pod 集成方式:
1.如之前项目中手动集成过闪验,需删除项目中手动集成的.framework和.bundle资源文件,再进行pod安装
2.如之前项目中未集成或pod集成过闪验,直接pod版本升级至指定版本或最新版即可
3.如果pod 闪验版本(<=2.3.3.4)升级到 2.3.3.5 及以上版本,由于移动运营商SDK名称发生变化(TYRZSDK->TYRZUISDK) 需要先在pod文件中 注释闪验 执行pod install(删除旧的) 然后取消注释 并变更到新版本 重新执行pod install
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属性即可达到设置文本内边距的效果
WEB端升级指南
v2.0.0.1 ->v2.0.0.2
- 替换js SDK包
- 移除启动授权页方法appid入参
Harmony端升级指南
手动集成闪验所有版本通用方式:
替换SDK包: 删除旧版本SDK所有相关的.har
文件,清除缓存,再导入新版SDK中的所有.har
文件。
没有更多了