鸿蒙初开：HarmonyOS 5应用开发环境搭建（DevEco Studio）全指南

news/2025/10/30 10:47:14/文章来源:https://www.cnblogs.com/ifeng0918/p/19176191

鸿蒙初开：HarmonyOS 5应用开发环境搭建（DevEco Studio）全指南

本文将手把手带你完成HarmonyOS 5应用开发的第一步，也是最关键的一步——开发环境的搭建。我们将从系统要求开始，直至在模拟器上成功运行第一个“Hello World”应用，为后续学习打下坚实基础。

一、环境准备与DevEco Studio安装

1.1 系统要求

在开始安装前，请确保你的电脑满足以下最低配置要求，以保证DevEco Studio流畅运行：

操作系统：Windows 10 64位 / Windows 11 64位；或 macOS 10.14及以上版本。
内存：8GB（推荐16GB及以上）。
硬盘空间：至少需要10GB可用空间（推荐100GB以上以容纳SDK、模拟器等）。
分辨率：1280x800像素及以上。

1.2 下载与安装DevEco Studio

获取安装包：访问 华为开发者联盟官网 或 HarmonyOS开发者官网，下载最新版本的DevEco Studio安装包
运行安装程序： Windows系统：双击下载的.exe文件，按照安装向导提示进行操作。建议选择非系统盘（非C盘）且路径中不包含中文的目录作为安装路径。在安装选项界面，请务必勾选DevEco Studio、桌面快捷方式以及将安装路径添加到系统环境变量等选项。 macOS系统：将下载的.dmg文件中的DevEco Studio.app拖拽到Applications文件夹即可。
初次配置：首次启动DevEco Studio时，会进入配置向导。阅读并同意软件许可协议。在基础配置页面，IDE会提示安装Node.js（版本要求通常为16.x或18.x，需不低于v14.19.1且低于v17.0.0的版本可能被推荐）和Ohpm（HarmonyOS包管理器）。请选择安装路径并在线下载安装。接下来配置HarmonyOS SDK路径。SDK包含开发所必需的工具链、平台版本和模拟器镜像。确保选择的路径有足够的磁盘空间。

二、创建你的第一个HarmonyOS项目

环境配置完成后，让我们创建一个简单的Hello World项目来验证环境。

启动并创建项目：在DevEco Studio欢迎界面，点击Create Project。对于新学者，选择 Application-> Empty Ability 模板，然后点击Next。
配置项目参数：这是非常重要的一步，请按照以下说明填写： Project Name：你的项目名称，例如 HelloWorld。 Bundle Name：应用包名，作为应用的唯一标识，通常采用反向域名规则，如 com.example.helloworld。 Save Location：项目保存的本地路径。 Compile SDK：选择 HarmonyOS 5.0（对应API版本通常为9或更高，请确保选择不低于API 9的版本以匹配HarmonyOS 5.0）。 Language：选择 ArkTS。这是HarmonyOS应用开发的推荐语言，在TypeScript基础上扩展了声明式UI语法。 Model：保持默认的 Stage模型。这是API 9及以上版本推荐的应用模型，提供了更好的能力隔离和生命周期管理。 Device Type：选择 Phone。
完成创建：点击Finish按钮，DevEco Studio会自动创建项目并完成初始化的Gradle同步过程。耐心等待同步完成。

三、项目结构初探与核心代码解读

项目创建成功后，我们先来熟悉一下最基本的项目结构，这对于后续开发至关重要。

MyFirstApp/
├── entry/          # 主模块
│   └── src/
│       └── main/
│           ├── ets/        # ArkTS代码存放目录
│           │   ├── pages/   # 页面目录
│           │       └── Index.ets  # 应用入口页面
│           └── resources/  # 资源文件（图片、字符串、样式等）
└── oh-package.json  # 项目依赖管理文件（类似Node.js的package.json）

现在，打开 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自动更新。这是声明式UI的核心特性之一。
build()：组件必须实现的方法，在其中声明UI布局。这里使用Row和Column进行横向和纵向布局，内部包含一个显示message变量的Text文本组件。

你可以尝试修改message的字符串，例如改为 '你好，鸿蒙！'，并观察效果。

四、运行与调试：让应用“活”起来

4.1 使用模拟器

对于没有真机的开发者，模拟器是极佳的测试工具。

点击工具栏的 Tools > Device Manager。
在Local Emulator标签页，点击Install来下载手机模拟器镜像（如Huawei_Phone）。选择存储路径后，点击+ New Emulator创建并启动模拟器。
模拟器启动后，在DevEco Studio顶部的运行配置下拉菜单中，选择该模拟器。
点击绿色的 Run 'entry' 按钮（或使用快捷键，如Shift+F10）。IDE将自动编译（编译HAP）、安装并启动应用到模拟器上。