donggaosheng 4dea9edbfb 在贵州大学分支上,修改人脸照片改成特征值构建人脸识别 недель назад: 2
..
src 4dea9edbfb 在贵州大学分支上,修改人脸照片改成特征值构建人脸识别 недель назад: 2
verify 4dea9edbfb 在贵州大学分支上,修改人脸照片改成特征值构建人脸识别 недель назад: 2
README.md 4dea9edbfb 在贵州大学分支上,修改人脸照片改成特征值构建人脸识别 недель назад: 2
patch.ps1 4dea9edbfb 在贵州大学分支上,修改人脸照片改成特征值构建人脸识别 недель назад: 2

README.md

cardlibrary 补丁工具

给厂商 AAR app/libs/cardlibrary-release.aar 打补丁,让卡库(览众 com.njlz.*)跟上新版 海康 face_sdk(com.hikvision.smarteyes.*)的能力。

为什么需要补丁

厂商的 cardlibrary-release.aar 里,classes.jar 是针对旧版 face_sdk 编译的:

厂商原版 新版 face_sdk
com.njlz.smartdata.FaceBuildBean picPath / faceUuid / errCode 多了 featureImportPath(特征值导入用的本地文件路径)
com.njlz.face.FaceUtils 只有 faceBuild()(按图片建模) 多了 FaceSdk.faceFeatureImport()(按特征值建模)

卡库内部靠 Gson 做一层 JSON 桥接来适配两套 bean:

faceBuild(List<com.njlz…FaceBuildBean>)
    -> Gson.toJson(卡库 bean)
    -> Gson.fromJson(json, TypeToken<List<com.hikvision…FaceBuildBean>>)
    -> FaceSdk.faceBuild(...)

因为卡库镜像 bean 里没有 featureImportPath 字段,特征值文件路径会在桥接那一步被静默丢弃, 按特征值建模退化成"按图片建模"(而 picPath 又是空的),最终建模失败。

补丁内容

只改 classes.jar 里的 2 个类(其余 22 个条目逐字节不变):

  1. com/njlz/smartdata/FaceBuildBean —— 补上 featureImportPath 字段 + getter/setter, 字段名必须与 SDK 侧完全一致(Gson 按字段名匹配)。toString() 格式保持与厂商原版一致。
  2. com/njlz/face/FaceUtils —— 新增 faceFeatureImport(List<FaceBuildBean>), 走 FaceSdk.faceFeatureImport();其余 22 个方法按厂商原版逐方法还原, @Subscribe 注解、FaceUtils$1/$2 两个 TypeToken 匿名类的编号与泛型均保持不变。

AAR 内除 classes.jar 外的 26 个条目(jni 的 .so、libs/face_sdk.jar、AndroidManifest.xml 等) 全部逐字节保持不变。

用法

powershell -ExecutionPolicy Bypass -File tools/cardlibrary-patch/patch.ps1

默认行为:

  • 输入 = 输出 = app/libs/cardlibrary-release.aar,就地打补丁
  • 厂商原版 AAR 直接放到 app/libs/cardlibrary-release.aar 即可,脚本会就地替换

也支持自定义:

powershell -ExecutionPolicy Bypass -File tools/cardlibrary-patch/patch.ps1 `
    -InputAar  D:\downloads\cardlibrary-release.aar `
    -OutputAar D:\downloads\cardlibrary-release-patched.aar

脚本做的事:

  1. 用 JDK 17(javac)编译 src/ 下的两个类,classpath = 卡库 classes.jar + libs/face_sdk.jar + gson + eventbus + android.jar(按 local.properties 的 SDK 与 gradle/libs.versions.toml 的版本自动定位)
  2. 校验 face_sdk.jar 里确实有 FaceSdk.faceFeatureImport——没有就直接报错退出
  3. 把编译产物替换回 classes.jar,再重新打包成 AAR

幂等:补丁永远由 src/ 下的源码重新编译生成,对已打过补丁的 AAR 重跑结果一致。 仓库里只保留 app/libs/ 下的一份 AAR,不重复存放厂商原版; 需要留档的话请放在仓库外(例如 D:\downloads\)。

目录

tools/cardlibrary-patch/
├── patch.ps1                                  补丁脚本
├── src/com/njlz/smartdata/FaceBuildBean.java  重写的卡库 bean
├── src/com/njlz/face/FaceUtils.java           重写的卡库门面
├── verify/VerifyPatch.java                    独立 JVM 验证器
└── build/                                     临时产物(已 gitignore)

验证

1. Gradle 单测(推荐)

app/src/test/java/xn/xxp/CardLibraryPatchTest.java 覆盖:

  • 卡库 bean 带上了 featureImportPath
  • featureImportPath 能穿过 Gson 桥接到达 SDK bean
  • FaceUtils.faceFeatureImport(List) 存在
  • 原有 8 个方法与 toString() 格式未被破坏
gradlew.bat :app:testDebugUnitTest

2. 独立 JVM 验证器(不依赖 Gradle)

java -cp "app\libs\cardlibrary-release.aar\classes.jar;..." VerifyPatch

verify/VerifyPatch.java 直接对打好补丁的 classes.jar 做校验,输出逐条 PASS/FAIL。 classpath 需要:补丁后的 classes.jar + libs/face_sdk.jar + gson + eventbus + android.jar。

3. 完整构建

gradlew.bat :app:checkDebugDuplicateClasses :app:assembleDebug

注意

  • app/libs 下不要再单独放 face_sdk.jar:AAR 里已经内嵌了一份,重复放置会产生 Duplicate class 编译错误。
  • 特征值导入依赖设备端人脸服务进程;RK3566 自建人脸(ThirdArm)通路只认 picPath, 不支持 featureImportPath。
  • 设备端的人脸服务 APK 也必须是支持 featureImportPath 的版本,否则该字段不生效。