uni-app项目运行到Android Studio的手机模拟器后,一直卡在启动页是什么问题?使用Hello uni-app 项目也是一样的问题;
运行的Hello uni-app 项目
运行后的效果
该问题请在专业群( uni-app 官方技术交流群 1 ) 咨询,群中有相关专业的管理员和群友。
uni-app 项目在 Android Studio 模拟器里一直停在启动页,99% 不是代码问题,而是「运行通道」没有把最新编译好的包真正同步到模拟器里。请按下面顺序逐项排查,基本都能解决:
先确认模拟器镜像版本
Android Studio 自带的旧镜像(Android 6/7)经常会出现卡在启动页的情况。
操作:AVD Manager → 新建一个 API 30(Android 11)或 API 33(Android 13) 的 x86_64 镜像 → 重新运行。
检查 HBuilderX 与模拟器的 adb 通道
如果控制台一直停在「正在建立手机连接」或「copy 文件失败」,说明通道异常。
操作:
• 完全关闭模拟器 → 在 Android Studio 里 Cold Boot 启动一次 → 回到 HBuilderX 重新「运行到手机或模拟器」。
• 仍卡住就把 HBuilderX 升级到 最新正式版(≥4.87),老版本 adb 与新模拟器不兼容。
使用「自定义运行基座」
官方文档明确提示:标准基座在部分模拟器上可能起不来。
操作:
菜单「运行 → 运行到手机或模拟器 → 制作自定义运行基座」→ 勾选 x86 架构 → 生成成功后,用「自定义基座」重新运行。
参考:真机运行常见问题
项目路径 / 包名含特殊字符
路径或包名里出现中文、空格、特殊符号会导致拷贝失败,表现就是一直停在启动页。
操作:
• 把项目挪到纯英文路径。
• manifest.json 里的包名改成 com.xxx.yyy 标准格式。
第三方 SDK / 保活插件冲突(较少见)
个别推送、热更新、保活库在模拟器里抛异常,App.vue 都没跑起来。
操作:先注释掉所有第三方原生插件,确认 Hello uni-app 能正常跑通后,再逐个加回。
快速验证
以上步骤都试过仍卡启动页,请把 HBuilderX 控制台完整日志贴到官方论坛,方便远程定位:Ask论坛发帖。