首页/资讯中心/详情

HarmonyOS 5开发从入门到精通（一）：环境搭建与第一个Hello World应用

HarmonyOS 5开发从入门到精通（一）：环境搭建与第一个Hello World应用
📅 发布时间：2026/6/21 20:39:21

HarmonyOS 5开发从入门到精通（一）：环境搭建与第一个Hello World应用

一、开发环境准备

1.1 系统要求

在开始HarmonyOS 5应用开发前，请确保您的电脑满足以下最低配置要求：

  • 操作系统：Windows 10/11 64位，或macOS 10.15及以上版本
  • 内存：8GB（推荐16GB及以上）
  • 硬盘空间：至少10GB可用空间（推荐100GB以上）
  • 分辨率：1280×800像素及以上

1.2 下载DevEco Studio

访问华为开发者联盟官网（https://developer.huawei.com/consumer/cn/download/），下载最新版本的DevEco Studio安装包。根据您的操作系统选择对应的版本（Windows系统下载.exe文件，macOS系统下载.dmg文件）。

1.3 安装DevEco Studio

Windows系统安装步骤：

  1. 双击下载的.exe文件启动安装向导
  2. 选择安装路径（建议选择非系统盘，路径中不要包含中文）
  3. 勾选"DevEco Studio"、"桌面快捷方式"和"将安装路径添加到系统环境变量"
  4. 点击"下一步"完成安装

macOS系统安装步骤：

  1. 将下载的.dmg文件中的DevEco Studio.app拖拽到Applications文件夹
  2. 在应用程序中启动DevEco Studio

二、配置开发环境

2.1 首次启动配置

首次启动DevEco Studio时，会进入配置向导：

  1. 选择"Do not import settings"（不导入设置）
  2. 阅读并同意软件许可协议
  3. 在基础配置页面，IDE会自动安装Node.js和Ohpm（HarmonyOS包管理器）
  4. 配置HarmonyOS SDK存储路径，确保有足够的磁盘空间
  5. 点击"Start using DevEco Studio"完成配置

2.2 安装模拟器

为了测试应用，需要安装模拟器：

  1. 点击菜单栏的"Tools" → "Device Manager"
  2. 在"Local Emulator"标签页，点击"Install"下载手机模拟器镜像
  3. 选择存储路径后，点击"+ New Emulator"创建并启动模拟器
  4. 选择"Huawei_Phone"手机模拟器，下载API 9或更高版本的系统镜像

三、创建第一个Hello World项目

3.1 新建项目

  1. 在DevEco Studio欢迎界面，点击"Create Project"
  2. 选择"Application" → "Empty Ability"模板，点击"Next"
  3. 配置项目参数： Project Name：HelloWorld（项目名称） Bundle Name：com.example.helloworld（应用包名，采用反向域名规则） Save Location：选择项目保存路径 Compile SDK：选择HarmonyOS 5.0（API 9或更高版本） Language：选择ArkTS（推荐语言） Model：保持默认的Stage模型 Device Type：选择Phone
  4. 点击"Finish"完成项目创建

3.2 项目结构解析

项目创建成功后，主要目录结构如下：

HelloWorld/
├── entry/                 # 主模块
│   └── src/
│       └── main/
│           ├── ets/      # ArkTS代码存放目录
│           │   └── pages/
│           │       └── Index.ets  # 应用入口页面
│           └── resources/ # 资源文件（图片、字符串、样式等）
├── oh-package.json        # 项目依赖管理文件
└── build-profile.json5   # 构建配置文件

四、编写核心代码

打开entry/src/main/ets/pages/Index.ets文件，这是应用的主页面：

@Entry
@Component
struct Index {@State message: string = 'Hello World'build() {Row() {Column() {Text(this.message).fontSize(50).fontWeight(FontWeight.Bold)}.width('100%')}.height('100%')}
}

代码解析：

  • @Entry：装饰器，表示这个Index组件是页面的入口点，每个页面有且仅有一个@Entry装饰的组件
  • @Component：装饰器，表示这个struct是一个可以复用的UI组件
  • @State：装饰器，用于管理组件的状态，当message变量的值改变时，会触发UI自动更新
  • build()：组件必须实现的方法，用于声明UI布局
  • Text()：文本组件，用于显示文本内容
  • Row()和Column()：布局容器，用于横向和纵向排列组件

五、运行与调试

5.1 使用模拟器运行

  1. 确保模拟器已启动（在Device Manager中启动）
  2. 在DevEco Studio顶部的运行配置下拉菜单中，选择模拟器
  3. 点击绿色的"Run 'entry'"按钮（或使用快捷键Shift+F10）
  4. IDE会自动编译、安装并启动应用到模拟器上

5.2 使用真机调试

如果您有搭载HarmonyOS 5.0的手机：

  1. 开启开发者模式：进入手机"设置" → "关于手机"，连续点击"版本号"7次
  2. 启用USB调试：返回"设置"，进入"系统和更新" → "开发人员选项"，开启"USB调试"和"USB安装"
  3. 使用USB数据线连接手机和电脑，手机弹出授权对话框时选择"允许"
  4. 在DevEco Studio中选择您的手机型号，点击运行按钮

六、常见问题解决

6.1 模拟器无法启动

如果启动模拟器时提示"未开启Hyper-V"：

  1. 打开控制面板 → "程序" → "程序和功能" → "启动或关闭Windows功能"
  2. 勾选"Hyper-V"、"Windows虚拟机监控程序平台"、"虚拟机平台"
  3. 点击确定并重启电脑

6.2 编译错误

如果出现编译错误，请检查：

  1. SDK版本是否匹配（Compile SDK应为HarmonyOS 5.0）
  2. 项目路径是否包含中文（建议使用英文路径）
  3. Node.js版本是否正常（应为16.x或18.x）

七、总结

通过本教程，您已经成功完成了：

✅ 开发环境搭建（DevEco Studio安装与配置）

✅ 创建第一个HarmonyOS 5项目

✅ 编写并理解核心代码（@Entry、@Component、@State装饰器）

✅ 使用模拟器或真机运行应用

这是HarmonyOS 5开发的第一步，后续我们将深入学习ArkTS语言特性、布局系统、状态管理等核心概念。建议您尝试修改代码中的message变量，观察UI如何自动更新，这是声明式UI的核心特性之一。