SDK升级说明
当前最新的SDK对外接口类使用的是"SFUemSDK",上一个版本的SDK使用的对外接口类是"SFMobileSecuritySDK",这里的升级说明主要针对的是上一个版本的SDK,如果是更早期的SDK(即对外接口类不是SFMobileSecuritySDK)的用户,则需要参考文档重新集成。
注意:新版本接口对主从应用场景做了优化,不再对旧版本接口做兼容,如果原应用有使用主从场景,请使用新接口重新集成
升级步骤
对外接口类为"SFMobileSecuritySDK"的SDK版本升级到新SDK,有两种如下两种处理方式:
1. 使用SDK提供的新的对外接口(SFUemSDK)重新实现
注意:推荐使用此方式,因为后续如果有新功能新特性需要新增接口,不会再适配旧版本接口
改动点
- 原来的接口都是通过SFMobileSecuritySDK类来调用,现在需要改成SFUemSDK
- 免密认证接口使用有变化
原免密认证使用方法示例:
/**
* 优先尝试免密登录
* 即用户在使用账号登录成功后,VPN设备会为用户生成免密信息,
* 下一次程序启动后可以使用免密信息进行登录,简化用户登录过程。
* 注意:此功能需要VPN设备支持且开启才生效。
*/
//判断当前免密登录是否可用
if (SFMobileSecuritySDK.getInstance().supportTicketAuth()) {
showToast("开始免密认证");
//开始免密认证,认证结果在认证回调中返回
SFMobileSecuritySDK.getInstance().startTicketAuth();
}
新免密认证使用方法示例
注意:新的免密接口不需要等认证回调,返回true就表示免密成功,此时就可以开始访问资源
/**
* 这里是自动免密认证接口,返回true表示认证成功,此时用户就可以进行资源访问了,
* 如果返回false,表示当前不满足自动免密条件,需要用户主动调用用户名密码认证接口
*/
if (SFUemSDK.getInstance().startAutoTicket()){
showToast("免密成功,可以开始访问资源");
}
2. 使用原来的对外接口类
改动点
1.仅免密认证接口使用有变化
原免密认证使用方法示例:
/**
* 优先尝试免密登录
* 即用户在使用账号登录成功后,VPN设备会为用户生成免密信息,
* 下一次程序启动后可以使用免密信息进行登录,简化用户登录过程。
* 注意:此功能需要VPN设备支持且开启才生效。
*/
//判断当前免密登录是否可用
if (SFMobileSecuritySDK.getInstance().supportTicketAuth()) {
showToast("开始免密认证");
//开始免密认证,认证结果在认证回调中返回
SFMobileSecuritySDK.getInstance().startTicketAuth();
}
新免密认证使用方法示例
注意:新的免密接口不需要等认证回调,返回true就表示免密成功,此时就可以开始访问资源
/**
* 这里是自动免密认证接口,返回true表示认证成功,此时用户就可以进行资源访问了,
* 如果返回false,表示当前不满足自动免密条件,需要用户主动调用用户名密码认证接口
*/
if (SFMobileSecuritySDK.getInstance().startAutoTicket()){
showToast("免密成功,可以开始访问资源");
}