Skip to content

安装

本章节将指导你安装 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 及以上

下载安装

  1. 访问 HarmonyOS 官网
  2. 根据你的操作系统下载对应版本
  3. 运行安装程序,按照提示完成安装

注意

首次启动 DevEco Studio 时,需要下载 SDK 和工具链,请确保网络连接正常。

Node.js 环境(可选)

如果你需要开发 Web 应用或使用某些工具,建议安装 Node.js。

安装 Node.js

  1. 访问 Node.js 官网
  2. 下载 LTS 版本(推荐)
  3. 按照安装向导完成安装

验证安装

打开终端或命令提示符,运行以下命令:

bash
node -v
npm -v

如果显示版本号,说明安装成功。

HarmonyOS SDK

SDK 会在 DevEco Studio 首次启动时自动下载,也可以手动管理。

手动配置 SDK

  1. 打开 DevEco Studio
  2. 进入 FileSettingsSDK
  3. 选择需要的 API 版本并下载

SDK 版本选择

建议下载最新的稳定版本 SDK,以获得最新特性和最佳性能。

验证安装

创建测试项目

  1. 打开 DevEco Studio
  2. 选择 Create Project
  3. 选择 Empty Ability 模板
  4. 填写项目信息,点击 Finish
  5. 等待项目创建完成

运行项目

  1. 点击工具栏的 Run 按钮(▶️)
  2. 选择模拟器或真机设备
  3. 等待应用启动

如果应用成功运行,说明开发环境配置完成!

常见问题

SDK 下载失败

问题:SDK 下载速度慢或失败

解决方案

  • 检查网络连接
  • 尝试使用代理
  • 从镜像站点下载

模拟器无法启动

问题:模拟器启动失败或黑屏

解决方案

  • 检查 BIOS 是否开启虚拟化(VT-x/AMD-V)
  • 确保内存充足(至少 4 GB)
  • 更新显卡驱动

下一步

环境配置完成后,你可以:

全栈若城