鸿蒙初开：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）、安装并启动应用到模拟器上。
4.2 使用真机调试
如果你有搭载HarmonyOS 5.0的手机，真机调试体验更佳。
- 开启开发者模式：进入手机的
设置 > 关于手机，连续点击版本号7次，直到提示已进入开发者模式。 - 启用USB调试：返回
设置，进入系统和更新 > 开发人员选项，开启 USB调试 和 USB安装（允许通过USB安装应用）。 - 连接电脑：使用USB数据线连接手机和电脑。手机会弹出授权对话框，选择
允许。 - 运行项目：在DevEco Studio中，设备选择列表里会出现你的手机型号，选择它并点击运行按钮即可。
成功运行后，你将在设备或模拟器上看到显示“Hello World”的应用界面。
需要参加鸿蒙认证的请点击 鸿蒙认证链接