react native expo生成AAB转APK安装时报解析包错误如何解决？

转换流程错误排查 #

• 首先确认bundletool转换命令的正确性，不要直接解压普通apks包提取APK，生成可直接安装的通用APK必须加--mode=universal参数，完整命令如下：
  bundletool build-apks --bundle=./app-release.aab --output=./app.apks --mode=universal
  未加该参数时生成的apks包内是拆分的多架构、多DPI分片APK，单独安装任意一个分片都会出现解析错误
• 不要直接把apks重命名为zip后随意提取APK，执行完上述universal模式命令后解压apks包，仅根目录下的universal.apk是完整可安装的通用安装包
• 确认bundletool为最新稳定版，旧版本存在AAB结构解析异常、生成APK损坏的已知问题

APK本身属性排查 #

• 检查APK的minSdkVersion配置是否低于测试设备的安卓系统版本，可通过以下命令查看APK的最低系统支持要求：
  aapt dump badging your_apk_path.apk | grep sdkVersion
• 验证APK签名有效性，执行命令：
  jarsigner -verify -verbose -certs your_apk_path.apk
  如果提示签名校验失败，需要确认生成AAB时的签名配置是否正确，Expo构建时是否正确配置了uploadKey
• 检查APK文件完整性，对比文件大小是否符合预期，传输、解压过程中的文件损坏也会导致解析失败，可重新执行转换流程生成新的APK重试

Expo构建配置排查 #

• 确认app.json中安卓配置段无异常，package字段格式正确，无特殊字符、空格
• 不要使用Expo开发构建（development build）生成的AAB转APK安装，开发构建依赖Expo Go运行环境，必须使用生产构建版本的AAB做转换
• 确认构建AAB时未开启错误的分包配置，关闭不必要的动态feature模块配置，通用APK不支持拆分的动态模块加载

设备环境排查 #

• 确认测试设备已经开启「允许安装未知来源应用」权限，安卓10及以上系统需要额外开启对应文件管理器的安装未知应用权限
• 尝试更换其他不同系统版本、不同品牌的测试设备安装，排除单设备系统异常问题
• 检查设备剩余存储空间是否充足，存储空间不足时也可能出现安装解析错误

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