Android模拟器运行项目时显示白屏,求解决方案
Android模拟器白屏问题解决方案
以下是针对多个Android模拟器均出现启动白屏、但项目在浏览器正常运行问题的排查和解决步骤:
调整模拟器GPU渲染模式
打开模拟器右侧的扩展菜单(三个点图标),进入Settings > Advanced,切换Graphics renderer选项(可尝试从自动切换为软件渲染或硬件渲染),同时确认OpenGL ES API level与项目配置的版本匹配,设置完成后重启模拟器。重置/重建模拟器
- 在Android Studio的AVD Manager中,选中目标模拟器,点击
Actions > Wipe Data清除缓存后重启测试; - 若无效,删除现有模拟器,重新下载官方稳定版的系统镜像(优先选择x86_64架构的Android 13/14镜像),再创建新的模拟器实例。
- 在Android Studio的AVD Manager中,选中目标模拟器,点击
检查项目Android配置
- 确认
AndroidManifest.xml中启动Activity的intent-filter配置正确,且android:theme未设置为透明主题(避免启动阶段白屏); - 核对Module级
build.gradle中的minSdkVersion、targetSdkVersion与模拟器的系统版本兼容,比如模拟器为Android 14时,targetSdkVersion建议不低于13。
- 确认
排查系统虚拟化资源冲突
- 确认电脑BIOS/UEFI中已开启CPU虚拟化功能(Intel VT-x/AMD-V);
- 关闭Docker、VirtualBox等占用虚拟化资源的程序,再重新启动模拟器。
验证基础环境可用性
创建一个全新的空Android项目,运行到模拟器上。若仍出现白屏,说明是模拟器环境问题,尝试将Android Studio及模拟器组件(SDK Manager中更新Emulator)升级到最新稳定版。
内容的提问来源于stack exchange,提问作者mmdsarhadi
相关产品推荐
相关产品推荐

