安装
本章节将指导你安装 HarmonyOS 开发所需的工具和环境。
DevEco Studio
DevEco Studio 是 HarmonyOS 官方的集成开发环境(IDE),基于 IntelliJ IDEA Community 版本构建。
系统要求
在安装 DevEco Studio 之前,请确保你的系统满足以下要求:
Windows
- 操作系统:Windows 10/11 64 位
- 内存:8 GB 及以上(推荐 16 GB)
- 硬盘:至少 10 GB 可用空间
- 分辨率:1280×800 及以上
macOS
- 操作系统:macOS 10.15 及以上
- 内存:8 GB 及以上(推荐 16 GB)
- 硬盘:至少 10 GB 可用空间
- 分辨率:1280×800 及以上
下载安装
- 访问 HarmonyOS 官网
- 根据你的操作系统下载对应版本
- 运行安装程序,按照提示完成安装
注意
首次启动 DevEco Studio 时,需要下载 SDK 和工具链,请确保网络连接正常。
Node.js 环境(可选)
如果你需要开发 Web 应用或使用某些工具,建议安装 Node.js。
安装 Node.js
- 访问 Node.js 官网
- 下载 LTS 版本(推荐)
- 按照安装向导完成安装
验证安装
打开终端或命令提示符,运行以下命令:
bash
node -v
npm -v如果显示版本号,说明安装成功。
HarmonyOS SDK
SDK 会在 DevEco Studio 首次启动时自动下载,也可以手动管理。
手动配置 SDK
- 打开 DevEco Studio
- 进入 File → Settings → SDK
- 选择需要的 API 版本并下载
SDK 版本选择
建议下载最新的稳定版本 SDK,以获得最新特性和最佳性能。
验证安装
创建测试项目
- 打开 DevEco Studio
- 选择 Create Project
- 选择 Empty Ability 模板
- 填写项目信息,点击 Finish
- 等待项目创建完成
运行项目
- 点击工具栏的 Run 按钮(▶️)
- 选择模拟器或真机设备
- 等待应用启动
如果应用成功运行,说明开发环境配置完成!
常见问题
SDK 下载失败
问题:SDK 下载速度慢或失败
解决方案:
- 检查网络连接
- 尝试使用代理
- 从镜像站点下载
模拟器无法启动
问题:模拟器启动失败或黑屏
解决方案:
- 检查 BIOS 是否开启虚拟化(VT-x/AMD-V)
- 确保内存充足(至少 4 GB)
- 更新显卡驱动
下一步
环境配置完成后,你可以: