已签名APK出现App not installed及Package appears to corrupted错误咨询

1. 签名配置类问题 #

• Android 11（API 30）强制要求APK同时支持V2+V3签名方案，仅开启V2签名无法通过系统包管理器的校验，需在构建配置中同时开启v2SigningEnabled true、v3SigningEnabled true参数
• 新旧包签名证书不匹配：设备上已安装同包名的旧版应用时，签名证书不一致的新版APK会被系统拦截，需先卸载设备上的同包名旧应用再安装测试
• CI/CD分发环节签名异常：App Circle分发流程若配置了自动重签名规则，重签名过程出现证书错误、签名不完整问题会直接导致包损坏，可直接安装本地构建的签名APK到设备测试，排除分发环节的签名问题

2. APK包结构类问题 #

• 下载过程文件损坏：网络波动可能导致APK下载时字节丢失，可重新下载后对比安装包与构建产物的SHA256哈希值，确认文件一致性
• 构建配置错误导致包解析失败：构建时异常的混淆规则、资源压缩逻辑、分包配置都可能破坏APK包结构，可临时关闭R8混淆、资源压缩、动态特性拆分后重新构建测试
• 架构不匹配：若开启了ABI拆分、屏幕密度拆分配置，设备下载到了不匹配自身架构的拆分APK会触发校验失败，可改用全架构通用包测试

3. 设备环境类问题 #

• 剩余存储空间不足：Android 11 要求安装APK时剩余存储空间至少为APK大小的2倍，空间不足时会触发包损坏报错，清理存储空间后重试即可
• 安装权限配置不全：Android 11 对未知来源应用增加了额外权限校验，需给用于安装APK的载体（浏览器、文件管理器、App Circle客户端）开启「允许安装未知来源应用」权限
• 包管理器缓存异常：多次安装失败会导致系统包管理器缓存异常，可重启设备后重试，或通过adb命令adb install -r <apk文件路径>安装，通过返回的错误日志定位具体问题

内容的提问来源于stack exchange，提问作者Rpj