emulator-notes.md 1.6 KB

模拟器启动注意事项(2026-08-23 更新至 v2)

当前环境(最终状态)

实例 镜像 状态 用途
DSH_MB6 HarmonyOS 6.0.0.48 (API 20) Release ✅ 在用,hdc 127.0.0.1:5555 主验证环境——正好匹配 compatibleSdkVersion 6.0.0(20) 下限验证
MateBook Pro 指向已不存在的 7.0.0-B1 镜像 ⚠️ 失效实例(勿启动;如需复用可重指向 6.0.0)
Mate X7 / MatePad Pro 13 / Pura 90 Pro 未验证 未使用

已验证结论

  1. 镜像下载:Device Manager GUI 触发 emulator -install 下载+解压(6.0.0 约 7.5GB,~10MB/s 下 25 分钟);首次解压可能被判不完整自动重来,等 info.json 有内容才算完成
  2. 实例创建Emulator -create 在 GUI 已登录环境下会挂起(等交互),不要用 CLI 建——在 Device Manager GUI 里建(DSH_MB6 即此法)
  3. 启动:GUI Device Manager 启动成功后,hdc 层一切操作(install/launch/screenshot/ui_dump)AI 全接管可用
  4. 完整闭环已验证(2026-08-23 20:0x):MCP install 签名 HAP → launch → app_state 前台确认 com.dotouch.dshharmony ✅

命令坑记录(勿重复踩)

  • yes | cmd & 后台管道会挂住 bash 会话(stdin 持有)→ 用 nohup bash -c "..." & 完全脱离
  • Emulator -license accept 不能持久化全部 4 份协议(SDK Agreement 始终 disagree),勿再走此路
  • macOS 无 timeout 命令;-create 交互挂起用 pkill 清理
  • 模拟器重启需用户从 Device Manager 操作(账号鉴权),运行期间无需再动