打包安卓应用显示白屏

欢迎到专业群（ uni-app 官方技术交流群 1 ） 咨询，群中有相关专业的管理员和群友。

这种情况通常是特定设备上的兼容性问题，特别是低版本安卓系统（如5.1.1）对现代 JavaScript 语法或 WebView 的内核支持不够完善导致的。既然同一个安装包在联迪的安卓5.1.1上正常，但在新大陆设备上白屏，说明问题很可能出在设备本身的 WebView 版本或系统厂商的定制上。

你可以按照以下思路进行排查和解决：

1. 排查 JS 语法兼容性（最常见原因）
新大陆设备内置的 WebView（通常是 Android System WebView）版本可能非常老旧，不支持 ES6+ 的语法（如箭头函数、const/let、Promise 等）。

• 检查方案：在 manifest.json 中配置 vueVersion，如果是 Vue3 项目，可以尝试切换为 Vue2 重新打包测试。Vue3 的代码编译后可能包含更多现代语法。
• 根本解决：在 manifest.json 的源码视图中，确保没有配置 minSdkVersion 过高。对于安卓5.1.1，建议 minSdkVersion 设置为 19 或 21。如果设置得较高（如大于 21），需要在原生配置中添加 android:extractNativeLibs="true"，但这通常用于原生离线打包。云打包时，可以尝试在 manifest.json 的 app-plus 下配置 "runmode" : "liberate" 来释放资源，确保文件加载正常。

2. 排查 WebView 内核兼容性
新大陆这类行业设备（如 PDA）的安卓系统可能有深度定制，其 WebView 内核可能存在缺失或不兼容。

• 尝试引入 X5 内核：腾讯 X5 内核可以替代系统 WebView，统一浏览器的渲染环境，能有效解决低版本安卓的兼容性问题。
  • 在 HBuilderX 中打开 manifest.json -> App 模块配置，勾选 X5 内核。
  • 在 App 权限配置 中确保没有勾选 CPU 类型为 x86（X5 不支持模拟器）。
  • 重新云打包测试。
• 参考文档：Android 常见问题 - 应用启动白屏

3. 排查第三方插件或组件
有些原生插件或 npm 包在特定的低版本安卓上初始化失败会导致应用直接卡死在启动页（白屏）。

• 二分法排错：先创建一个空的 uni-app 模板项目，进行云打包，安装到新大陆设备上。如果空白项目能打开，说明是你项目中引用的某个插件或第三方库导致的。
• 重点排查：检查项目中是否使用了不支持低版本安卓的 SDK（如某些地图、WebRTC、新版推送等）。例如，历史案例中引入火山引擎的 WebRTC SDK 就曾导致安卓打包后白屏。

4. 检查打包配置与资源

• AAB 打包：如果你是在 Google Play 上传的 AAB 包出现白屏，需要检查 gradle.properties 和 AndroidManifest.xml 中关于 extractNativeLibs 的配置，虽然这通常是离线打包的问题，但配置错误也会导致白屏。
• 文件释放模式：对于部分老旧设备，应用资源在 apk 的 assets 目录下可能无法正确读取。可以尝试在 manifest.json 中将 runmode 设置为 liberate，让应用在首次运行时释放资源到存储目录，参考 plus.io 文档。

5. 查看历史类似案例
在社区的反馈中，有开发者遇到类似情况：HBuilderX 3.8.3 版本云打包后部分安卓手机白屏，回退 HBuilderX 版本（如 3.7.11）后恢复正常。如果以上方法均无效，且你使用的是较新版本的 HBuilderX，可以尝试下载 历史版本 重新打包看是否能临时规避。

建议先从最简单的“创建空白项目”测试和“引入 X5 内核”入手，这能最快定位是项目代码问题还是设备内核问题。

使用了Webview-x5 还是不行