客户端SDK发布记录

SDK版本号

更新时间

更新说明

2.3.46

2026-04-20

• oss 文件上传失败时支持重签名

• 新增OSS域名上传失败时降级ip重试

• 设备助手模块升级为Android-AliyunFaceGuard-10057.2

• 修复已知bug

2.3.45

2026-03-27

• 炫彩视频支持从ZimResponse中获取

• 修复已知问题

2.3.44

2026-02-25

• 刷脸页Loading样式默认为水波纹，支持配置切换为转圈样式，具体信息，请参见verify方法参数说明

• 远近活体多语言缺失修复

• 修复个别机型远近活体启动时显示异常

• 意愿认证错误弹框按钮文案显示问题修复

• 横竖屏UI逻辑统一优化

• Pad横屏切换竖屏刷脸偶发性退出优化

• 安全模块升级

• 支持so远程化，具体信息，请参见Android SDK的so远程化最佳实践

2.3.43

2025-12-18

• NFC支持多语言配置，详情请参见开始认证

• NFC刷卡界面UI支持自定义配置，详情请参见自定义UI颜色和icon图标

• 支持控制台配置存证视频时长和多张人脸图片

• 修复已知问题

2.3.42

2025-11-03

• 支持授权引导页加载阶段背景色设置

• 支持授权引导页加载阶段状态栏字体深浅设置

2.3.41

2025-10-14

• 修复部分页面多语言展示异常问题

• 移除遗留iccid相关代码以解决应用市场检出静态无效代码影响上架问题

• 优化刷脸页面交互体验

• metainfo中新增设备助手实际版本号

2.3.40

2025-09-17

• 设备助手安全能力升级

2.3.39

2025-08-22

• 适配支持16KB 页面大小（需要移除 APSecuritySDK-DeepSec-[version].[timestamp].jiagu.aar模块）

• OCR页面UI优化

• 部分特殊机型炫彩异常修复

2.3.38

2025-08-06

• OCR多语言补充及部分bug修复

• 适老化部分自定义UI配置补充

• 修复部分android8机型协议页没有返回按钮问题

• aliyun-photinus 模块在 2.3.38 及后续版本合并到 aliyun-face 模块

2.3.35

2025-05-13

• OCR支持从相册中选择

• 日志上传优化

• 修复OCR页面输入框被软键盘遮挡

2.3.33.2

2025-04-25

基于隐私合规要求的采集逻辑优化。

2.3.33

2025-04-14

• 华为非凡大师系列 OCR UI展示兼容优化

• NFC新增“不支持此类证件”场景提示

2.3.32.1

2025-02-25

修复人脸移出刷脸框偶现的Crash场景。

2.3.32

2025-02-05

• 炫彩算法优化

• Crash重启逻辑优化

• 适老化配置UI优化

• 远近活体入场时交互优化

2.3.31

2024-12-19

• 设备助手升级，增强Token替换攻击的检测。

• 修复适老化页面刷脸提示文案缺失缺陷。

• 模块集成不完整或混淆配置错误码优化。

2.3.30

2024-12-04

• 设备助手安全能力升级。

• 图片处理逻辑优化。

2.3.28

2024-11-29

• 人脸模型优化。

• 客户端错误码映射关系调整。

• NFC兼容性方案优化。

• 远近活体刷脸框默认大小调整。

• 日志和埋点数据优化。

2.3.25.1

2024-10-09

• 新增备用OSS域名。

• 优化因设备修改系统时间引发的认证异常问题。

• 设备助手能力升级。

• 新增远近活体。

2.3.24

2024-08-15

• 新增人脸严格质量检测模型。

• UI自定义优化，支持沉浸式交互 ，返回按钮自定义优化。

• 偶现Crash修复。

• 设备助手安全模块升级。

2.3.21

2024-07-09

• 客户端图片采集逻辑优化。

• 新增权限拒绝时体验优化。

• OPPO FindN/N2 UI显示缺陷修复。

2.3.20

2024-06-20

• 优化炫彩活体检测。

• 修复图像尺寸缺陷。

2.3.19

2024-05-30

• 系统优化、日志上传优化以及偶现的crash修复。

• 新增敏感权限toast停留时间自定义设置功能。

• ID_PLUS方案修复OCR图片识别成功后重复拍摄导致页面异常的缺陷。

• 安全SDK升级。

2.3.18

2024-05-17

• 存证视频传输与体验优化。

• 性能优化和兼容性适配。

• SDK新增自定义提醒文案功能，详情参考Android SDK UI自定义配置说明。

2.3.16.1

2024-04-18

• 炫彩模型优化环境光检测。

• 修复偶现应用变量异常问题。

2.3.15

2024-04-02

• 新增UI自定义业务提示。

• OCR身份证校验规则调整。

• 线上稳定性问题修复。

• 安全SDK升级，去除UTdid库依赖。

2.3.13.1

2024-03-11

• SDK安全链路优化。

• SDK回调新增retMessageSub字段，优化code的中文描述说明。

2.3.11.1

2024-02-01

• SDK UI升级，支持语种、皮肤自定义等配置。

• 新增生僻字输入认证功能。

• 新增自定义敏感权限弹窗功能。

• 安全能力升级。

• 修复左右分屏手机认证时偶现崩溃缺陷。

2.3.8.2

2023-11-28

• 修复视频返回缺陷。

• 修复偶现崩溃。

2.3.7

2023-11-02

• 引导页面优化。

• 安全性能升级。

• 修复偶现点击返回认证未中断缺陷。

2.3.4.1

2023-10-17

认证链路优化，提升合规性。

2.3.4

2023-09-07

• 认证链路加密，提升安全性。

• 炫彩活体漏洞修复。

• 设备助手升级，提升安全性。

• 减少SDK包大小。

• 多人脸检测能力升级。

2.2.8.1

2023-07-28

• 支持NFC认证。

• Bug修复。

2.2.7.2

2023-06-16

• 减少SDK包大小。

• Bug修复及体验优化。

2.2.6

2023-04-19

• 增加适老化支持。

• Bug修复及体验优化。

2.2.4.2

2023-03-09

提升兼容性。

2.2.1

2022-12-29

功能优化，提升稳定性。

2.1.3.1

2022-12-01

部分问题修复。

2.1.3

2022-11-21

功能优化，体验提升。

2.1.2

2022-10-28

• 优化刷脸认证功能，提升体验。

• 部分问题修复。

2.1.1.1

2022-09-29

• fastjson版本升级，体验提升。

• 修复OCR功能的混淆问题。

2.1.0

2022-09-05

• 优化扫脸体验。

• 增强人脸安全检测能力。

• 减少SDK包大小。

2.0.1

2022-07-07

新增多因子意愿认证功能。更多信息，请参见多因子意愿认证方案。

1.6.7

2022-08-22

• 优化扫脸体验。

• 增强人脸安全检测能力。

1.6.5

2022-07-12

修复Bug，优化性能。

1.6.4

2022-06-22

• 修复Bug。

• 优化扫脸体验。

1.5.2

2022-01-14

刷脸界面关闭按钮位置自定义。

1.4.9

2021-11-12

• 刷脸拉起后置摄像头bugfix。

• 部分手机视频绿屏问题bugfix。

1.4.8

2021-10-21

SDK完整性校验，避免Android某些机型上安装问题导致的Crash。

1.4.7

2021-09-06

• 链路安全加密。

• 支持国际化多语言。

1.4.6

2021-07-26

• 服务端返回视频。

• 支持客户端网络容灾。

1.4.4

2021-06-21

设备安全能力升级。

1.4.2

2021-03-30

• 适配IPv6。

• 炫彩活体检测优化。

• 修复OnePlus8 Pro在Android 11系统上，Read_Phone_State权限被主动拒绝后导致启动人脸Crash的Bug。

1.3.9

2021-01-25

优化设备信息传输路径。

1.3.8

2021-01-21

更新设备风险识别能力。

1.3.3

2020-09-30

• 优化SDK包大小。

• 修正内部版本号，当前版本号是1.3.3。

• 修复身份证OCR反面图片显示问题。

1.3.2

2020-09-17

退出键适配特殊尺寸屏幕，如水滴屏、挖洞屏等。

1.3.1

2020-09-07

更新设备安全能力。

1.2.9

2020-08-24

• 修复活体检测偶现processing的缺陷。

• 优化刷脸超时弹窗状态下物理按键退出的点击事件。

• 删除设备信息中的手机号码和蓝牙信息。

1.2.8

2020-08-10

• 优化刷脸界面的Home键退出与刷脸超时退出逻辑，避免用户误操作退出。

• 细化SDK返回值，区分刷脸失败类型。

• 优化刷脸界面的圆框大小自适应功能。

1.2.7

2020-07-15

• 新增OCR能力。

• 新增活体页面自定义进度条颜色设置。

• 在未开启炫彩模式的情况下，修复客户端产生的垃圾信息缺陷。

• 修复偶现反馈的crash问题。

1.2.6

2020-06-29

优化App认证方案、活体人脸验证方案、活体检测方案，支持设置动作+炫彩双重检测模式。

1.2.2

2020-06-12

在App认证方案、活体人脸验证方案、活体检测方案的Android客户端接入文档中，补充权限说明内容。

1.2.1

2020-06-08

优化SDK包大小。

1.2.0

2020-05-22

在App认证方案、纯服务端接入方案、活体人脸验证方案、活体检测方案和人脸比对方案的服务端接入文档中，提供接口服务地址。

1.1.9

2020-05-13

优化SDK包大小。

1.1.8

2020-04-29

在App认证方案、活体人脸验证方案和活体检测方案中，新增活体视频返回能力。

SDK版本号

更新时间

更新说明

2.3.46

2026-04-20

• oss 文件上传失败时支持重签名

• 移除类DTFMobileIdentifier

2.3.45

2026-03-27

炫彩视频支持从ZimResponse中获取

2.3.44

2026-02-25

• 刷脸页Loading样式默认为水波纹，支持配置切换为转圈样式，详情请参见extParams参数说明

• OCR模块图片大小缩减

• 认证请求防连点优化

• 远近活体多语言缺失修复

2.3.43

2025-12-18

• NFC支持多语言配置，详情请参见调用SDK

• NFC刷卡界面UI支持自定义配置，详情请参见自定义UI颜色和icon图标

• 支持控制台配置返客视频长度和返客图片数量

• 协议认证界面导航栏返回箭头位置调整

• 修复某些场景下设置存证视频后未返回视频链接的问题

2.3.42

2025-11-03

支持授权引导页加载阶段背景色设置。

2.3.41

2025-10-14

• OCR模块支持多语言配置

• 适老化模式新增UI自定义配置

• 刷脸认证引导页关闭按钮支持位置配置（和刷脸页面配置一致）

• metainfo中新增设备助手实际版本号

2.3.40

2025-09-17

• 修复意愿认证二次录音阶段唇动识别异常问题

• 修复活体认证阶段屏幕低亮度时无法自动调整亮度问题

• 修复NFC认证时某些异常数据触发崩溃问题

• 修复适老化在炫彩场景无法关闭声音提示问题

2.3.39

2025-08-22

• APPSecuritySDK升级：解决苹果应用上架审核问题

• 修复OCR 页面在ipad部分场景下不兼容问题

2.3.38

2025-08-06

• 意愿认证场景UI问题及部分bug修复

• UI自定义支持设置透明度

2.3.36

2025-06-06

• OCR支持从相册中选择

• 设备助手升级

• 深色模式下部分页面UI优化

• 部分页面交互优化

2.3.34.1

2025-05-14

修复偶现的Crash问题。

2.3.34

2025-04-25

基于隐私合规要求的优化。

2.3.33

2025-04-14

• NFC新增“不支持此类证件”场景提示

• 偶现crash问题优化

• 安全SDK升级

• 设备助手模块升级

2.3.32

2025-02-05

• 炫彩算法优化

• 适老化页面UI优化

• 意愿引导页无法退出问题修复

• idfa获取逻辑优化

2.3.31

2024-12-19

• 设备助手升级，增强Token替换攻击的检测。

• 修复日志中版本号不准确的缺陷。

• 模块集成不完整导致SDK退出的错误码优化。

2.3.30

2024-12-04

• 引导页自定义UI配置不生效问题修复。

• iOS横屏crash问题修复 。

• 客户端模型兼容远近+炫彩。

2.3.29

2024-11-29

• 客户端错误码调整。

• 炫彩检测优化。

• metainfo中添加session ID字段。

• 日志上传优化。

• 偶现crash问题优化。

2.3.27

2024-10-18

• 新增远近活体。

• SDK点击退出错误码修复。

• NFC支持模拟器。

• 兼容性问题修改。

• 引导页面优化。

2.3.25.1

2024-10-09

• 新增备用OSS域名。

• 优化因设备修改系统时间引发的认证异常问题。

• 修复相机权限提示无法弹出的缺陷。

• 修复安全模块权限获取缺陷。

2.3.25

2024-09-09

• 修复安全SDK偶现崩溃缺陷。

• 修复因修改手机系统时间导致的OCR异常。

• OCR信息修改引导提示优化。

2.3.24

2024-08-15

• C++三方库命名优化。

• 适配iOS 18系统版本。

• 视频优化。

• 优化UI自定义。

2.3.21.1

2024-07-25

修复偶现crash。

2.3.21

2024-07-09

• 客户端图片采集逻辑优化。

• 参数优化。

2.3.20

2024-06-20

• 优化炫彩活体检测。

• 隐私清单文件更新至framework中。

2.3.19

2024-05-30

• 新增部分异常场景埋点。

• 新增敏感权限toast停留时间自定义设置功能。

2.3.18

2024-05-17

• 存证视频优化帧率。

• 意愿认证方案音视频权限优化。

• 性能优化和兼容性适配。

• 横屏场景退出和loading状态体验优化。

• SDK新增自定义提醒文案功能，详情参考iOS SDK UI 自定义配置说明。

2.3.16

2024-04-18

• 修复iOS16系统下横屏使用缺陷。

• 修复设备助手应用缺陷。

2.3.13

2024-03-11

• SDK安全链路优化。

• SDK新增隐私清单文件。

2.3.11

2024-02-01

• SDK UI升级，支持语种、皮肤自定义等配置。

• 新增生僻字输入认证功能。

• 新增自定义敏感权限弹窗功能。

2.3.7

2023-11-06

• 引导页面优化。

• 安全性能升级。

• 修复偶现缺陷。

2.3.5

2023-09-25

• iOS SDK兼容Xcode 15。

• 设备助手更新，提升安全性。

• 减少SDK包大小，移除非必要依赖。

• Bug修复，防止Crash。

• 意愿认证功能优化。

2.3.3

2023-09-07

• 认证链路加密，提升安全性。

• 炫彩活体漏洞修复。

• 多人脸检测能力升级。

2.2.8

2023-07-28

支持NFC认证。

2.2.7

2023-06-16

• 减少SDK包大小。

• Bug修复及体验优化。

2.2.5

2023-04-19

• 增加适老化支持。

• Bug修复及体验优化。

2.2.4

2023-03-20

功能优化，问题修复，提升稳定性。

2.2.2

2022-12-16

增加网络容错方案，提升稳定性。

2.2.1

2022-12-12

功能优化，提升稳定性。

2.1.3

2022-11-17

常见问题修复，体验提升。

2.1.2

2022-11-04

• 优化网络异常场景下认证资料传输。

• SDK模块化，在全量刷脸SDK的基础上，支持OCR、炫彩、意愿认证模块的个性化裁剪。

• OCR摄像头权限申请时间点调整至点击拍照时获取。

• 适配iPhone14 Pro UI。

• 减少SDK包大小。

2.0.1

2022-07-07

新增多因子意愿认证功能。更多信息，请参见多因子意愿认证方案。

1.5.1

2022-04-21

• 活体检测新增多动作活体检测模式。

• 新增页面关闭按钮自定义类型。

• 设备安全模块升级。

• 新增用户拒绝授权的错误类型。

• 优化异常网络下图片上传失败的处理逻辑，新增错误类型Z1026。

• 修复iOS 15.4系统下，开启12小时格式时间引发的偶现异常错误问题。

1.4.4

2021-11-08

设备安全删除SSID、BSSID权限。

1.4.2

2021-10-14

• 支持国际化多语言。

• 启动时性能优化。

• 链路安全加密升级。

• 刷脸过程中若退出到后台，SDK自动释放摄像头退出。

1.4.1

2021-07-27

支持客户端网络容灾。

1.4.0

2021-06-21

设备安全能力升级。

1.3.8

2021-03-30

• 适配日本日历等。

• 适配语言优化。

• 适配IPv6。

• 新增是否需要服务端视频参数。

• 删除IDFA权限要求。

1.3.7

2021-01-25

• 优化设备信息传输路径。

• 更新设备风险识别能力。

1.3.5

2020-12-08

• 优化对蚂蚁开放平台SDK的兼容性。

• 增加设备安全的模拟器包。

• 修复反复按压home键导致的刷脸页面无法弹出提醒的缺陷。

• 支持OCR等功能可插拔接入，优化SDK包大小。

1.3.1

2020-09-17

更新设备安全能力。

1.2.9

2020-08-24

• 优化日志上传的路径，并修复活体检测偶现图片上传引发processing的缺陷。

• 适配iOS暗黑模式。

1.2.8

2020-08-10

优化刷脸界面的Home键退出与刷脸超时退出逻辑，避免用户误操作退出。

1.2.6

2020-07-15

• 新增OCR能力。

• 新增活体页面自定义进度条颜色设置。

• 删除不必要的AdSupport.framework依赖。

• 删除日志模块会扫描本地未上传日志的功能。

• 删除task类里面的KVO配对，提高系统的稳定性。

1.2.4

2020-06-29

优化App认证方案、活体人脸验证方案、活体检测方案，支持设置动作+炫彩双重检测模式。

1.2.0

2020-05-22

在App认证方案、纯服务端接入方案、活体人脸验证方案、活体检测方案和人脸比对方案的服务端接入文档中，提供接口服务地址。

1.1.8

2020-04-29

在App认证方案、活体人脸验证方案和活体检测方案中，新增活体视频返回能力。

SDK版本号

更新时间

更新说明

2.3.46

2026-04-20

• oss 文件上传失败时支持重签名

• 增加模块README.md 和CHANGELOG.md

2.3.45

2026-03-27

• 炫彩视频支持从ZimResponse中获取

• 设备助手模块升级

• 适配鸿蒙6.0系统

• 解决部分极端网络情况下的超时问题

2.3.44

2026-02-25

• 修复重复刷脸提示“打开相机失败”问题

• 修改har包的描述语长度， 解决部分场景对描述语长度限制问题

2.3.43

2025-12-18

支持配置返客视频长度和返客图片数量

1.3.10

2025-10-21

PC和Pad场景下的交互适配。

1.3.9

2025-09-19

• 人脸保镖安全升级

• 修复低端机概率性 crash 问题

1.3.7

2025-06-20

• 设备助手安全能力升级（必须更新接口配置：接口混淆配置）

• 移除部分冗余权限

• OCR 页面支持自定义配置（对应配置：Harmony SDK UI 自定义配置说明）

1.3.5

2025-05-13

OCR支持从相册中选择。

1.3.4

2025-04-14

• 新增 UI自定义设置

• 适配鸿蒙PuraX摄像头

1.3.2

2025-02-25

• 支持安全摄像头能力

  （需在 Harmony 官网针对 APP 配置，详见Harmony 开启安全摄像头能力）

• 修复非主HSP打包时raw资源无法读取的问题

• 修复多动作活体检测重试场景下顺序未随机问题

1.3.1

2025-02-05

• 炫彩算法优化

• 鸿蒙折叠摄像头API下线

• 修复多视频采集视频丢失问题

• SDK命名导入支持本地导入以及私仓导入方式

1.2.2

2024-12-25

• 设备助手更新，增强Token替换攻击检测。

• 设备助手修复弱网场景偶现缺陷。

• 支持鸿蒙编译器 caseSensitiveCheck 开关。

1.2.1

2024-12-04

• SDK支持强制竖屏认证。

• 设备助手安全能力升级。

• bug修复。

1.2.0

2024-11-01

• SDK默认开启字节码编译能力。

• SDK启动支持UIContext启动。

• 修复日志级别控制问题。

• 修复线上反馈异常问题。

1.1.12.2

2024-10-09

• 适配鸿蒙API12系统。

• 返回视频逻辑优化。

• 新增远近活体。

• 人脸图片获取功能优化。

1.1.10

2024-08-29

修复第二次打开人脸认证界面一直loading问题。

1.1.8

2024-08-15

• OCR页面UI优化，沉浸式布局优化。

• 日志请求优化。

• 多次认证引发的体验问题优化。

• 修复鸿蒙系统升级NEXT.0.0.31导致的兼容性问题。

1.1.7

2024-08-07

• API编译最低支持鸿蒙API 11版本。

• 沉浸式UI布局适配。

• 折叠屏场景下交互适配。

• OCR拍照预览尺寸适配。

1.1.4

2024-05-31

• 适配API 12版本。

• 适配ID_PLUS方案。

• 认证报文优化。

• 修复认证流程无法结束、摄像头选取异常的偶现缺陷。

1.1.2

2024-05-06

• 新增客户端视频返回功能。

• 新增炫彩活体检测。

• 新增设备助手模块，安全能力升级。

1.1.0

2024-03-19

• 不支持返回视频。

• 减少SDK包大小。

1.0.0

2024-03-15

初始化版本。

支持金融级实人认证方案（ID_PRO)，金融级活体人脸验证方案、金融级活体检测方案。