众投SDK升级指南

发布于: 2026-06-15 00:00
阅读: 0

注意: 三网运营商内部执行不同,升级后请务必分别使用三网运营商的卡进行测试,防止功能异常!

服务端升级指南

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.2 -->v2.3.7.5

  • 替换aar包
  • 移除CLCustomViewSetting配置类,统一使用addCustomView四参添加自定义控件方法
  • 移除shanYanSlogan相关配置方法,如果有使用相关配置请去掉即可
  • 默认传入的字体大小统一使用sp单位,核查一键登录页面字体大小是否正常(如果使用px单位设置授权页固有控件字体大小的需要调整)

v2.3.7.0 -->v2.3.7.2

  • 替换aar包

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.0.x -->v2.3.6.4

  • 删除libCtaApiLib.so、libShanYCore.so(已经打到aar包中)
  • 替换aar包(如果是采用maven集成,请改用本地aar包依赖方式)
  • 按照对接文档修改AndroidManifest.xml中授权页activity的配置
  • 按照文档修改混淆规则

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包体
  • 删除隐私协议 clAppPrivacyLineFragmentPaddingclAppPrivacyContentInset属性,目前只要设置clAppPrivacyTextContainerInset属性即可达到设置文本内边距的效果

Harmony端升级指南

手动集成闪验所有版本通用方式:
替换SDK包: 删除旧版本SDK所有相关的.har文件,清除缓存,再导入新版SDK中的所有.har文件。

v1.0.8 ->1.1.0

拉起授权页之前需要调用注册CLSDKManager.registNavigation(this.pathStack),否则会拉起失败

低版本 ->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.4

  • 替换js SDK包

v2.0.0.2 ->v3.0.0.0

  • 替换js SDK包
  • 按照新版文档,移除电信初始化方法,修改电信token获取逻辑

v2.0.0.1 ->v2.0.0.2

  • 替换js SDK包
  • 移除启动授权页方法appid入参
分享