本文介绍了将3.3.0版本以前的实人认证iOS SDK升级到3.3.0及以上版本的操作方法。升级实人认证SDK一般包括两个步骤:更新SDK文件、修改调用API。

前提条件

  • 确认您要升级的实人认证SDK的版本号。
    说明 实人认证SDK版本号可在项目的文件夹目录RPSDK.framework > Info.plist > CFRPSDKVersion下查看。
  • 在您的项目工程中导入以下实人认证依赖包。
    CoreMotion.framework
    CoreTelephony.framework
    Libc++.tbd
    Libresolv.tbdLibz.tbd
    Libz.tbd
    SystemConfiguration.framework

更新SDK文件

不同版本的SDK文件更新方式有差异,具体请参见下文描述。

注意
  • 如果您是第一次通过Pod来集成SDK,您只需要把旧的依赖和资源文件删除掉,然后添加Pod依赖并执行pod updat 即可。
  • 更新SDK文件的过程中请您务必确认旧的版本文件已被替换,再清除Xcode Derived Data,然后重新编译。

3.0.0版本及以上

  1. 删除项目中原有的RPSDK.bundle,导入最新下载的RPSDK.bundle
  2. 删除以下项目中原有的依赖包。
    AliAPMInterface.framework
    AliReachability.framework
    RPSDK.framework
    TBJSONModel.framework
    TScheduleProtocol.framework
    WindmillBridge.framework
    WindmillWeaver.framework
    WindMix.framework
    WindVane.framework
    WindVaneBasic.framework
    WindVaneCore.framework
    SecurityGuardSDK.framework
    SGMain.framework
    SGSecurityBody.framework
  3. 导入以下最新下载的依赖包。
    AliyunOSSiOS.framework
    RPSDK.framework
    SecurityGuardSDK.framework
    SGMain.framework
    SGSecurityBody.framework

2.4.2版本及以上

  1. 删除项目中原有的RPSDK.bundle,导入最新下载的RPSDK.bundle
  2. 删除以下项目中原有的依赖包。
    RPSDK.framework
    WindVane.framework
    WindVaneBasic.framework
    WindVaneBridge.framework
    WindVaneCore.framework
    ZipArchive.framework
    AliReachability.framework
    SecurityGuardSDK.framework
    SGMain.framework
    SGSecurityBody.framework
  3. 导入以下最新下载的依赖包。
    AliyunOSSiOS.framework
    RPSDK.framework
    SecurityGuardSDK.framework
    SGMain.framework
    SGSecurityBody.framework

2.4.0版本

  1. 删除项目中原有的RPSDK.bundleALBiometrics.bundleALBiometricsUI.bundleFaceTheme.bundle,并导入最新下载的RPSDK.bundle
  2. 删除项目中原有的依赖包。
    RPSDK.framework
    WindVane.framework
    WindVaneBasic.framework
    WindVaneBridge.framework
    WindVaneCore.framework
    ZipArchive.framework
    AliReachability.framework
    SecurityGuardSDK.framework
    SGMain.framework
    SGSecurityBody.framework
  3. 导入以下最新下载的依赖包。
    AliyunOSSiOS.framework
    RPSDK.framework
    SecurityGuardSDK.framework
    SGMain.framework
    SGSecurityBody.framework

2.3.x版本

  1. 删除项目中原有的RPSDK.bundleFaceLivenessSDK.bundleFaceTheme.bundle,并导入最新下载的RPSDK.bundle
  2. 删除以下项目中原有的依赖包。
    RPSDK.framework
    FaceLivenessOpen.framework
    WindVane.framework
    WindVaneBasic.framework
    WindVaneBridge.framework
    WindVaneCore.framework
    ZipArchive.framework
    AliReachability.framework
    SecurityGuardSDK.framework
    SGMain.framework
    SGSecurityBody.framework
  3. 导入以下最新下载的依赖包。
    AliyunOSSiOS.framework
    RPSDK.framework
    SecurityGuardSDK.framework
    SGMain.framework
    SGSecurityBody.framework

2.2.x版本

  1. 删除项目中原有的RPSDK.bundleFaceLivenessSDK.bundleFaceTheme.bundle,并导入最新下载的RPSDK.bundle
  2. 删除以下项目中原有的依赖包。
    RPSDK.framework
    FaceLivenessOpen.framework
    SecurityGuardSDK.framework
    SGMain.framework
    SGSecurityBody.framework
    SGNoCaptcha.framework
    WindVane.framework
    WindVaneBasic.framework
    WindVaneBridge.framework
    WindVaneCore.framework
    ZipArchive.framework
    AliReachability.framework
  3. 导入以下最新下载的依赖包。
    AliyunOSSiOS.framework
    RPSDK.framework
    SecurityGuardSDK.framework
    SGMain.framework
    SGSecurityBody.framework

2.2.0版本以下

  1. 删除项目中原有的yw_1222_*.jpg文件,并导入最新下载的yw_1222_0769.jpg
  2. 删除项目中原有的RPSDK.bundleFaceLivenessSDK.bundleFaceTheme.bundle,并导入最新下载的RPSDK.bundle
  3. 删除项目中原有的依赖包,导入最新下载的依赖包。

修改和调用API

新版SDK接口向下兼容2.2.0版本及以上的SDK,但建议接入方尽快更新到最新版本的接口。

已删除的API

以下接口已不需要调用,您可以直接删除。
  • [RPSDK initialize:]
  • [RPSDK initialize]
  • [RPSDK initializeHasWV:]
  • [RPSDK setAppName:appVersion:]
  • [RPSDK setLocalAccelerate:]

新增API

[RPSDK setup]:在启动实人认证服务时,添加实人认证初始化的方法。

实现方式变更的API
  • [RPSDK getSubCode]:请通过RPResult查看结果,此方法将返回空字符串。
  • [RPSDK getSubMessage]:请通过RPResult查看结果,此方法将返回空字符串。
接口名变更的API
  • [RPSDK start:rpCompleted:withVC:]:请替换为[RPSDK startWithVerifyToken:viewController:completion:]方法。
  • [RPSDK startVerifyByNative:rpCompleted:withVC:]:请替换为[RPSDK startByNativeWithVerifyToken:viewController:completion:]方法。
  • [RPSDK startVerifyByURL:rpCompleted:withVC:]:请替换为[RPSDK startByURL:viewController:completion:]方法。