本文介绍了将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 update 即可。
  • 更新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.bundle、ALBiometrics.bundle、ALBiometricsUI.bundle和FaceTheme.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.bundle、FaceLivenessSDK.bundle和FaceTheme.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.bundle、FaceLivenessSDK.bundle和FaceTheme.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.bundle、FaceLivenessSDK.bundle和FaceTheme.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:]方法。