活体检测 SDK 升级指南 (2D)

V2.4.1(2026.06.26)

版本介绍

版本升级

  1. 将依赖版本号修改为2.4.1:

V2.4.0(2025.3.31)

版本介绍
版本升级
  1. 将依赖版本号修改为2.4.0:

V2.3.0(2024.7.11)

版本介绍
版本升级
  1. 将依赖版本号修改为2.3.0:

V2.2.1(2024.4.23)

版本介绍
版本升级
  1. 将依赖版本号修改为2.2.1:

  2. 我们发现 LivenessActivity 这个类名被 Kaspersky 等平台标记为风险,请您务必修改此类名为其他名称,以解决Not-a-virus:HEUR:RiskTool.AndroidOS.SpyLoan.fk警告

V2.2.0(2024.2.23)

版本介绍
版本升级
  1. 将依赖版本号修改为2.2.0:

V2.1.9(2024.1.23)

版本介绍
版本升级
  1. 将依赖版本号修改为2.1.9:

  2. 打开审计图片列表功能。

V2.1.8(2023.12.14)

版本介绍
版本升级
  1. 将依赖版本号修改为2.1.8:

  2. 开启审计图功能

  3. 获取审计图


V2.1.7(2023.12.1)

版本介绍
版本升级
  1. 参考此链接

V2.1.6(2023.11.14)

版本介绍
版本升级
  1. 将依赖版本号修改为 2.1.6:


V2.1.5(2023.9.20)

版本介绍
版本升级
  1. 将依赖版本号修改为 2.1.5:


V2.1.4(2023.9.7)

版本介绍
版本升级

. 将依赖版本号修改为 2.1.4:


V2.1.3(2023.4.27)

版本介绍
版本升级
  1. 将依赖版本号修改为2.1.3:

V2.1.2(2023.4.6)

版本介绍
版本升级
  1. 将依赖版本号修改为2.1.2:


 

V2.1.1(2023.3.23)

版本介绍
版本升级
  1. 将依赖版本号修改为2.1.1:


V1.3.9.x -> V1.4.0(2023.2.20)

版本介绍
版本升级
  1. 将依赖版本号修改为1.4.0:


V2.0.2(2022.12.16)

版本介绍
版本升级
  1. 将依赖版本号修改为2.0.2:


V2.0.1(2022.12.06)

版本介绍
版本升级
  1. 将依赖版本号修改为2.0.1:

  2. 设置动作难度(在 setLicenseAndCheck() 方法之前调用,否则不生效)

    您可以根据业务要求指定动作检测的难度(EASY,NORMAL,HARD),默认为 NORMAL


V1.3.9 -> V2.0.0(2022.11.25)

版本介绍
版本升级
  1. 将依赖版本号修改为2.0.0:

  2. 新增提示语和检测时状态码,在状态码回调方法中增加对应提示,否则页面会提示空白。文字资源请参照集成文档下载 UI 源码。


V1.3.8 -> V1.3.9/V1.3.9.x(2022.8.10)

版本介绍
版本升级
  1. 在您项目的 build.gradle 中增加 maven 仓库配置:

  2. 在项目的 app 模块build.gradle增加库依赖:

  3. 删除 liveness_lib_vx.x.x.aar ,guardian_core_vx.x.aar 两个 aar 文件。

V1.3.7 -> V1.3.8(2022.7.12)

版本介绍
版本升级

V1.3.6 -> V1.3.7(2022.6.7)

版本介绍
版本升级

V1.3.5 -> V1.3.6(2022.5.27)

版本介绍
版本升级

V1.3.4 -> V1.3.5(2022.2.18)

版本介绍
版本升级

V1.3.2 -> V1.3.3/V1.3.4(2022.1.13)

版本介绍
版本升级

V1.3.1 -> V1.3.2

版本介绍
版本升级

V1.3.0 -> V1.3.1

版本介绍
版本升级

V1.2.9 -> V1.3.0

版本介绍
版本升级

V1.2.8 -> V1.2.9

版本介绍
版本升级

V1.2.7 -> V1.2.8

版本介绍
版本升级

V1.2.6 -> V1.2.7

版本介绍
版本升级

V1.2.5 -> V1.2.6

版本介绍

遮挡检测默认是关闭状态,如需开启遮挡检测,请在初始化SDK之后调用如下方法设置

版本升级

V1.2.4 -> V1.2.5

版本介绍
版本升级

V1.2.3 -> V1.2.4

版本介绍
版本升级

V1.2.1/V1.2.2 -> V1.2.3

版本介绍
版本升级

V1.2.0 -> V1.2.1

版本介绍
版本升级

V1.1.9 -> V1.2.0

版本介绍
版本升级

V1.1.8 -> V1.1.9

版本介绍
版本升级

V1.1.7 -> V1.1.8

版本介绍
版本升级

V1.1.6 -> V1.1.7

版本介绍
版本升级

V1.1.5 -> V1.1.6

版本介绍
方法变更
版本升级

V1.1.4 -> V1.1.5

版本介绍
方法变更
版本升级

建议使用全量升级,新版代码更加简洁,几乎无代码侵入。


V1.1.3 -> V1.1.4

版本介绍
方法变更

原先的handleResult(ResultEntity entity)方法变更为 onDetectionSuccess()中的回调方法onGetFaceDataSuccess(),方法内容如下:

版本升级
  1. 全量升级

    • 拷贝 liveness_lib_v1.1.4.aar 和 guardian_core_v1.2.aar两个文件至 liveness/libs 目录,同时删除对应的旧版本 aar,如果您同时集成了 picture_quality SDK,请同时把该 SDK 依赖的 guardian_core_vxx.aar 替换为 1.2 版本,以免发生版本依赖冲突。
    • 在 liveness/build.gradle 中的 dependencies 标签里增加对 constraint-layout 的依赖:implementation 'com.android.support.constraint:constraint-layout:1.1.3'
    • 保存下您在 LivenessFragment 上做的更改。
    • 使用新版本 LivenessFragment 文件覆盖旧的文件,同时替换 fragment_liveness.xml 布局文件。
    • 还原您对 LivenessFragment 上的更改。
    • 重新编译项目即可。
  2. 简单升级:本次更新主要是对 UI 模块做了优化,同时解决了 aar 中少量存在的 bug,您可以选择只替换 aar 文件来修复 aar 中的已知问题。

    • 使用 liveness_lib_v1.1.4.aar 替换 1.1.3 版本文件,同时在 gradle 中将引用更新为 1.1.4 即可。

V1.1.2 -> V1.1.3

版本介绍
从 SDK 获取图片方式的更改

只有活体检测成功后才会有图片

版本升级

V1.0 -> V1.1.2

版本介绍
从 SDK 获取图片

三、版本升级

有以下两种方式升级 SDK 至 1.1.2 版本,您可以结合实际需求选择其一。
新版本 aar 中已包含了 armeabi 架构,如您在 1.0 集成过程中拷贝了 libaailiveness_v1.0.0.so 至 libs/armeabi 目录下,请删除此 .so

方式一 (强烈建议)

适用于对 liveness 模块代码 无自定义改动或改动较少 的情况。

  1. 保存您做的自定义更改
  2. 删除 liveness 模块,添加对新版的依赖
  3. 恢复您的自定义更改
方式二

适用于改动了 liveness 模块。无需删除旧版本 liveness 模块。

  1. 使用新的 liveness_lib_v1.1.2.aar 文件替换 libs 目录里的旧 aar 文件
  2. 拷贝 guardian_core_v1.0.aar 到 libs 目录,并添加对此 aar 的依赖 rebuild 工程即可。

tips: 如您未改动 res 目录,可使用新版 liveness 库工程中的 res 直接拷贝覆盖旧的