r***@sina.com
r***@sina.com
  • 发布:2026-01-23 15:54
  • 更新:2026-01-23 16:00
  • 阅读:85

uni-app项目运行到Android Studio的手机模拟器后,一直卡在启动页是什么问题?

分类:uni-app

uni-app项目运行到Android Studio的手机模拟器后,一直卡在启动页是什么问题?使用Hello uni-app 项目也是一样的问题;
运行的Hello uni-app 项目


运行后的效果

2026-01-23 15:54 负责人:无 分享
已邀请:
Ask小助手

Ask小助手

该问题请在专业群( uni-app 官方技术交流群 1 ) 咨询,群中有相关专业的管理员和群友。

uni-app 项目在 Android Studio 模拟器里一直停在启动页,99% 不是代码问题,而是「运行通道」没有把最新编译好的包真正同步到模拟器里。请按下面顺序逐项排查,基本都能解决:

  1. 先确认模拟器镜像版本
    Android Studio 自带的旧镜像(Android 6/7)经常会出现卡在启动页的情况。
    操作:AVD Manager → 新建一个 API 30(Android 11)或 API 33(Android 13)x86_64 镜像 → 重新运行。

  2. 检查 HBuilderX 与模拟器的 adb 通道
    如果控制台一直停在「正在建立手机连接」或「copy 文件失败」,说明通道异常。
    操作
    • 完全关闭模拟器 → 在 Android Studio 里 Cold Boot 启动一次 → 回到 HBuilderX 重新「运行到手机或模拟器」。
    • 仍卡住就把 HBuilderX 升级到 最新正式版(≥4.87),老版本 adb 与新模拟器不兼容。

  3. 使用「自定义运行基座」
    官方文档明确提示:标准基座在部分模拟器上可能起不来。
    操作
    菜单「运行 → 运行到手机或模拟器 → 制作自定义运行基座」→ 勾选 x86 架构 → 生成成功后,用「自定义基座」重新运行。
    参考:真机运行常见问题

  4. 项目路径 / 包名含特殊字符
    路径或包名里出现中文、空格、特殊符号会导致拷贝失败,表现就是一直停在启动页。
    操作
    • 把项目挪到纯英文路径。
    • manifest.json 里的包名改成 com.xxx.yyy 标准格式。

  5. 第三方 SDK / 保活插件冲突(较少见)
    个别推送、热更新、保活库在模拟器里抛异常,App.vue 都没跑起来。
    操作:先注释掉所有第三方原生插件,确认 Hello uni-app 能正常跑通后,再逐个加回。

快速验证

  1. 新建空白 Hello uni-app 项目
  2. 新建 API 30 的模拟器
  3. 用「自定义基座」运行
    若此时能正常进入首页,说明环境 OK,再把业务代码拷进去即可。

以上步骤都试过仍卡启动页,请把 HBuilderX 控制台完整日志贴到官方论坛,方便远程定位:Ask论坛发帖

内容为 AI 生成,仅供参考
II优选

II优选 - 定制插件开发-联系QQ:770104707

我这边一直都是这样,我一般测试都是用的真机才可以

要回复问题请先登录注册