uni-app HBuilder X（最新版本）本地打包在Android studio（最新版本）中安卓11真机调试一直显示白屏

uni-app HBuilder X（最新版本）本地打包在Android studio（最新版本）中安卓11真机调试一直显示白屏

操作步骤：

  • 在hbuliderX 中做一个最简单的页面，本地打包，放入Android studio中，安卓11真机调试

预期结果：

  • 安卓11上面可以显示正常的页面

实际结果：

  • 安卓11白屏

bug描述：

  • hbuilder X （最新版本）本地打包放在Android studio （最新版本）中，安卓11真机调试，一直显示白屏。安卓10（包括安卓10）以下版本都能正常显示。刚测试的，Android studio 连接安卓10 真机调试，compileSdkVersion 30–targetSdkVersion 28 能正常显示，compileSdkVersion 30–targetSdkVersion 29 白屏，安卓11 不管在什么情况下都是白屏显示。

更多关于uni-app HBuilder X（最新版本）本地打包在Android studio（最新版本）中安卓11真机调试一直显示白屏的实战教程也可以访问 https://www.itying.com/category-93-b0.html

13 回复

你试下HX默认基座 是否也这样

更多关于uni-app HBuilder X（最新版本）本地打包在Android studio（最新版本）中安卓11真机调试一直显示白屏的实战教程也可以访问 https://www.itying.com/category-93-b0.html


默认基座和真机调试都正常。

有人反应过这个情况吗？咱们这边测试过吗？Android studio 生成apk了以后，能正常安装，打开app的话，如果有底部导航条也能看到，上面内容显示白屏，点击底部导航条切换，没有反应。

https://ask.dcloud.net.cn/question/126937

回复 飞花飞絮: 你是本地打包然后调试白屏是吗 SDK用的什么版本，更新最新的试下

回复 DCloud_Android_ST: HBuliderx 是最新版本，SDK版本在哪里看？

回复 飞花飞絮: 下载的文件上有版本号和日期

回复 DCloud_Android_ST: 大神，不太懂能加扣扣聊吗？我的825546419

回复 DCloud_Android_ST: 生成本地打包app资源，放在Android studio 文件里面\app\src\main\assets\apps

回复 DCloud_Android_ST: Android 离线SDK - 正式版 注意：HBuilderX 3.2.5版本之后适配了AndroidX，升级时需要参考文档重新配置 是这块吗？ 下载了SDK，怎么处理

回复 飞花飞絮: 加你QQ有添加问题 你可以私信告诉我

处理好了，就是Android studio sdk该更新了，Android studio版本更新以后，里面好多引用得文件名称也得跟着修改，具体步骤，我是参照这个页面弄得，https://wangjinchan.blog.csdn.net/article/details/120486710，希望有所帮助

根据你的描述，问题主要出现在Android 11（API 30）及targetSdkVersion 29+的环境下。白屏通常与WebView初始化、文件访问权限或资源加载有关。以下是几个关键排查点：

  1. WebView兼容性：Android 10（API 29）起对WebView进行了限制，尤其是非公开目录的文件访问。确保在AndroidManifest.xml中配置了正确的文件访问权限：

    <application android:requestLegacyExternalStorage="true" ...>

    但注意：Android 11（API 30）中此标志可能失效，需改用Scoped Storage适配。

  2. 资源路径问题：本地打包时，HBuilder X生成的资源文件（如HTML/JS）默认存放在assets目录。在Android 11中，需确保加载路径正确。检查以下代码段是否在WebView初始化时正确指向assets：

    webView.loadUrl("file:///android_asset/你的页面路径");

  3. targetSdkVersion 29+的适配：从targetSdkVersion 29开始，默认禁止访问非公开目录。若应用需要读取本地文件，需在AndroidManifest.xml中声明权限：

    <uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />

    同时，动态请求权限（Android 11需使用MANAGE_EXTERNAL_STORAGE权限，并引导用户手动授权）。

  4. WebView设置检查：在WebView初始化时启用以下设置，避免安全限制导致阻塞：

    webView.getSettings().setAllowFileAccess(true);
webView.getSettings().setAllowContentAccess(true);
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.JELLY_BEAN) {
    webView.getSettings().setAllowFileAccessFromFileURLs(true);
    webView.getSettings().setAllowUniversalAccessFromFileURLs(true);
}
回到顶部