给厂商 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 个条目逐字节不变):
com/njlz/smartdata/FaceBuildBean —— 补上 featureImportPath 字段 + getter/setter,
字段名必须与 SDK 侧完全一致(Gson 按字段名匹配)。toString() 格式保持与厂商原版一致。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,就地打补丁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
脚本做的事:
javac)编译 src/ 下的两个类,classpath = 卡库 classes.jar +
libs/face_sdk.jar + gson + eventbus + android.jar(按 local.properties 的 SDK 与
gradle/libs.versions.toml 的版本自动定位)face_sdk.jar 里确实有 FaceSdk.faceFeatureImport——没有就直接报错退出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)
app/src/test/java/xn/xxp/CardLibraryPatchTest.java 覆盖:
featureImportPathfeatureImportPath 能穿过 Gson 桥接到达 SDK beanFaceUtils.faceFeatureImport(List) 存在toString() 格式未被破坏gradlew.bat :app:testDebugUnitTest
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。
gradlew.bat :app:checkDebugDuplicateClasses :app:assembleDebug
app/libs 下不要再单独放 face_sdk.jar:AAR 里已经内嵌了一份,重复放置会产生
Duplicate class 编译错误。picPath,
不支持 featureImportPath。featureImportPath 的版本,否则该字段不生效。