鸿蒙 App 零文档环境搭建记录：DevEco Studio + OpenHarmony 模拟器配置

没有文档时，配置需按步骤验证，避免主观推测。以下为实际操作的四个阶段。

1. SDK 版本选择与安装

进入 DevEco Studio 后，提示 SDK location 未指定。

问题：项目要求兼容 5.0.0(12)，目标版本为 5.0.5(17)，但本地未配置 SDK 路径，无法获取版本列表。

处理：指定本地 SDK 存储目录，触发 DevEco 从远端拉取版本列表。对照项目配置勾选 5.0.0(12) 及 5.0.5(17)，完成 License 协议签署。

结果：系统镜像文件下载至本地目录。

2. 模拟器创建与启动

SDK 配置完成后，打开 Device Manager，列表为空。

问题：Device Manager 默认显示已创建的模拟器实例，而非可创建的版本。

处理：点击 + New Emulator，选择 Phone 类型（非 Tablet），勾选已下载的 HarmonyOS 5.0.5(17) 镜像并创建。

结果：模拟器启动，进入系统桌面。

3. 构建与通信异常排查

执行 Rebuild 时，超过 15 分钟无进度更新。

问题：控制台输出 hdc Command Exception 与 No Devices 错误，并非编译缓慢，而是 IDE 与模拟器间通信中断。

处理：停止构建，依次执行模拟器重启、终止 hdc 进程、重启 hdc 服务，恢复设备连接后再继续。

4. 分层干预机制

为避免长时间无响应，采用以下分层处理：

15 分钟原则：任意操作超过 15 分钟无日志滚动或状态变化，即触发干预。

本次会话中 Cursor 额度变化如下：

总消耗约 135.4 万 tokens。AI 主要用于报错分析与建议生成，关键决策仍由人工基于设备状态与日志执行。

复盘发现以下问题：

• 版本兼容性：OpenHarmony SDK、Toolchain 与项目 React Native 版本的约束关系未进行系统验证，当前配置成功带有偶然性。
• 验证完整性：模拟器进入桌面并执行 Run，但未记录应用 Ability 启动成功或 Logcat 输出的完整证据。
• 异常根因：hdc 通信中断通过重启解决，但未定位具体原因（虚拟化冲突或超时）。

1. Run 前检查项

执行 Run 前确认：

• ✓DevEco 顶部设备下拉列表未显示 No Devices
• ✓终端执行 hdc list targets 可列出模拟器 ID
• ✓模拟器已进入可交互桌面状态

2. 时间止损规则

• 构建超过 15 分钟且日志无更新：执行 Clean/Rebuild 或重启 IDE。
• Run 阶段出现 hdc exception：停止重试，优先排查 hdc 进程。

3. 操作记录建议

每次操作后记录：

在无文档场景下，环境配置需依赖日志、设备状态与分层干预，而非主观判断。AI 可辅助分析，但最终验证仍需人工执行。本文提供的检查清单可作为同类项目的参考。