明白了,这是一个非常典型的 “乙方(APK提供方)与甲方(系统集成方)协作” 时的编译配置问题。
作为 APK 的提供方,你们负责把 APK 做出来并签好名;而客户(系统固件方)在将你们的 APK 内置到 Android 源码中编译 Release 版本时,没有在他们的编译脚本中正确配置“保留原签名(PRESIGNED)” 。
因为 APK 是你们签名的,客户手里没有你们的签名私钥(keystore) ,所以客户不能(也不应该)在编译时用他们自己的 Android 平台 key 去重新签名你们的 APK,否则 APK 的签名被篡改,可能会导致应用无法正常拉起、数据无法共享,甚至直接闪退。因此,客户唯一正确的做法就是原样保留(PRESIGNED) 。
你可以直接把以下排查点和修改方法发给客户(系统固件方),让他们按这个去查:
1. 告诉客户:在源码的 Android.mk 中必须加 PRESIGNED
让客户找到这三个 APK 在源码里的预编译配置(Android.mk 或 Android.bp)。由于这三个 APK 是你们提供的,客户肯定是作为 PREBUILT(预编译)放入系统的。
让他们检查配置,必须要有 LOCAL_CERTIFICATE := PRESIGNED 这一行。
正确的 Android.mk 示例:
makefile
LOCAL_PATH := $(call my-dir)
include $(CLEAR_VARS)
LOCAL_MODULE := FTAIPlayNouT_v98
LOCAL_SRC_FILES := FTAIPlayNouT_v98_V1.0.1.5.14929.20261104_release.apk
LOCAL_MODULE_CLASS := APPS
LOCAL_MODULE_SUFFIX := $(COMMON_ANDROID_PACKAGE_SUFFIX)
LOCAL_CERTIFICATE := PRESIGNED # <--- 客户必须加上这一行!
include $(BUILD_PREBUILT)
如果客户用的是 Android.bp,则需要写 certificate: "PRESIGNED",。
2. 告诉客户:在 OTA 打包脚本中要“放行”这三个 APK
如果在 Android.mk 中加了 PRESIGNED 还是报错(或者客户把 APK 直接丢在 vendor 目录下用拷贝的方式集成,没有写 mk 文件),那说明在打包 OTA 包(sign_target_files_apks.py)时,脚本依然不认识它们。
客户需要在编译 OTA 的脚本里(或者 build/make/core/Makefile 中的 sign_target_files_apks 调用处)加上 --extra_apks 参数,告诉签名脚本:“遇到这三个 APK,直接跳过,保留原样”。
客户需要添加的编译参数:
bash
--extra_apks=FTAIPlayNouT_v98_V1.0.1.5.14929.20261104_release.apk=PRESIGNED
--extra_apks=FtpInaNouT_v98_V1.0.1.2.13148.20261104_release.apk=PRESIGNED
--extra_apks=FttFCAFTKZ_FTZx_v3.0.4.16840.20261104_release.apk=PRESIGNED
3. 解释为什么 Debug 正常,而 Release 报错
- Debug 版:客户编译 Debug 时,系统通常不校验第三方 APK 的签名,或者默认给个测试签名(testkey)就放过了,所以能编过。
- Release 版:客户编译 Release(生成 OTA 固件)时,
sign_target_files_apks.py脚本会做严格检查。如果发现这个 APK 既没有指定用哪个系统 Key 重签,也没有标明是PRESIGNED,它就会强制报AssertionError,防止把错误的包发出去。
4. 提醒客户检查目录
顺便提醒客户看看截图最下方的报错: cp: bad '/20260403czm/yang/h727_20260901/h72x_android14_0825/vendor/czm/product/*': No such file or directory 让客户确认一下,是不是你们提供的 APK 没有正确放到 vendor/czm/product/ 这个目录下,或者这个目录压根没建。这可能是导致 OTA 脚本扫描不到签名配置的连带原因。