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

前提条件

确认要升级的实人认证SDK的版本号。
说明 实人认证SDK版本号可在项目的文件夹目录RPSDK.framework > Info.plist > CFRPSDKVersion下查看。

更新 SDK 文件

注意 以下过程中请务必确认旧版文件已被替换，再清除Xcode Derived Data，然后重新编译。

2.4.2 版本及以上

  1. 删除以下项目中原有的依赖包。 
    RPSDK.framework
WindVane.framework
WindVaneBasic.framework
WindVaneBridge.framework
WindVaneCore.framework
ZipArchive.framework
AliReachability.framework
  2. 导入以下最新下载的依赖包。 
    AliAPMInterface.framework
AliReachability.framework
RPSDK.framework
TBJSONModel.framework
TScheduleProtocol.framework
WindmillBridge.framework
WindmillWeaver.framework
WindMix.framework
WindVane.framework
WindVaneBasic.framework
WindVaneCore.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
  3. 导入以下最新下载的依赖包。 
    AliAPMInterface.framework
AliReachability.framework
RPSDK.framework
TBJSONModel.framework
TScheduleProtocol.framework
WindmillBridge.framework
WindmillWeaver.framework
WindMix.framework
WindVane.framework
WindVaneBasic.framework
WindVaneCore.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
  3. 导入以下最新下载的依赖包。 
    AliAPMInterface.framework
AliReachability.framework
RPSDK.framework
TBJSONModel.framework
TScheduleProtocol.framework
WindmillBridge.framework
WindmillWeaver.framework
WindMix.framework
WindVane.framework
WindVaneBasic.framework
WindVaneCore.framework

2.2.x 版本

  1. 删除项目中原有的RPSDK.bundle、FaceLivenessSDK.bundle和FaceTheme.bundle，并导入最新下载的RPSDK.bundle。
  2. 删除以下项目中原有的依赖包。 
    PSDK.framework
FaceLivenessOpen.framework
SecurityGuardSDK.framework
SGMain.framework
SGSecurityBody.framework
SGNoCaptcha.framework
WindVane.framework
WindVaneBasic.framework
WindVaneBridge.framework
WindVaneCore.framework
ZipArchive.framework
AliReachability.framework
  3. 导入以下最新下载的依赖包。 
    AliAPMInterface.framework
AliReachability.framework
RPSDK.framework
SecurityGuardSDK.framework
SGMain.framework
SGSecurityBody.framework
TBJSONModel.framework
TScheduleProtocol.framework
WindmillBridge.framework
WindmillWeaver.framework
WindMix.framework
WindVane.framework
WindVaneBasic.framework
WindVaneCore.framework

2.2.0.0 版本以下

  1. 删除项目中原有的yw_1222_*.jpg文件，并导入最新下载的yw_1222_0769.jpg。
  2. 删除项目中原有的RPSDK.bundle、FaceLivenessSDK.bundle和FaceTheme.bundle，并导入最新下载的RPSDK.bundle。
  3. 删除以下项目中原有的依赖包。 
    RPSDK.framework
FaceLivenessOpen.framework
SecurityGuardSDK.framework
SGMain.framework
SGSecurityBody.framework
SGNoCaptcha.framework
WindVane.framework
WindVaneBasic.framework
WindVaneBridge.framework
WindVaneCore.framework
ZipArchive.framework
AliReachability.framework
  4. 导入以下最新下载的依赖包。 
    AliAPMInterface.framework
AliReachability.framework
RPSDK.framework
SecurityGuardSDK.framework
SGMain.framework
SGSecurityBody.framework
TBJSONModel.framework
TScheduleProtocol.framework
WindmillBridge.framework
WindmillWeaver.framework
WindMix.framework
WindVane.framework
WindVaneBasic.framework
WindVaneCore.framework

修改调用API

新版SDK接口向下兼容2.2.0版本及以上的SDK，但建议接入方尽快更新到最新接口。
注意 旧接口将于2020年3月份失效。

已删除的API

以下接口已不需要调用，可以直接删除。
  • [RPSDK initialize:]
  • [RPSDK initialize]
  • [RPSDK initializeHasWV:]
  • [RPSDK setAppName:appVersion:]
  • [RPSDK setLocalAccelerate:]
实现方式变更的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:]方法。