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系统安装步骤：
- 双击下载的.exe文件启动安装向导
- 选择安装路径（建议选择非系统盘，路径中不要包含中文）
- 勾选"DevEco Studio"、"桌面快捷方式"和"将安装路径添加到系统环境变量"
- 点击"下一步"完成安装
macOS系统安装步骤：
- 将下载的.dmg文件中的DevEco Studio.app拖拽到Applications文件夹
- 在应用程序中启动DevEco Studio
二、配置开发环境
2.1 首次启动配置
首次启动DevEco Studio时，会进入配置向导：
- 选择"Do not import settings"（不导入设置）
- 阅读并同意软件许可协议
- 在基础配置页面，IDE会自动安装Node.js和Ohpm（HarmonyOS包管理器）
- 配置HarmonyOS SDK存储路径，确保有足够的磁盘空间
- 点击"Start using DevEco Studio"完成配置
2.2 安装模拟器
为了测试应用，需要安装模拟器：
- 点击菜单栏的"Tools" → "Device Manager"
- 在"Local Emulator"标签页，点击"Install"下载手机模拟器镜像
- 选择存储路径后，点击"+ New Emulator"创建并启动模拟器
- 选择"Huawei_Phone"手机模拟器，下载API 9或更高版本的系统镜像
三、创建第一个Hello World项目
3.1 新建项目
- 在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或更高版本） Language：选择ArkTS（推荐语言） Model：保持默认的Stage模型 Device Type：选择Phone
- 点击"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 使用模拟器运行
- 确保模拟器已启动（在Device Manager中启动）
- 在DevEco Studio顶部的运行配置下拉菜单中，选择模拟器
- 点击绿色的"Run 'entry'"按钮（或使用快捷键Shift+F10）
- IDE会自动编译、安装并启动应用到模拟器上
5.2 使用真机调试
如果您有搭载HarmonyOS 5.0的手机：
- 开启开发者模式：进入手机"设置" → "关于手机"，连续点击"版本号"7次
- 启用USB调试：返回"设置"，进入"系统和更新" → "开发人员选项"，开启"USB调试"和"USB安装"
- 使用USB数据线连接手机和电脑，手机弹出授权对话框时选择"允许"
- 在DevEco Studio中选择您的手机型号，点击运行按钮
六、常见问题解决
6.1 模拟器无法启动
如果启动模拟器时提示"未开启Hyper-V"：
- 打开控制面板 → "程序" → "程序和功能" → "启动或关闭Windows功能"
- 勾选"Hyper-V"、"Windows虚拟机监控程序平台"、"虚拟机平台"
- 点击确定并重启电脑
6.2 编译错误
如果出现编译错误，请检查：
- SDK版本是否匹配（Compile SDK应为HarmonyOS 5.0）
- 项目路径是否包含中文（建议使用英文路径）
- Node.js版本是否正常（应为16.x或18.x）
七、总结
通过本教程，您已经成功完成了：
✅ 开发环境搭建（DevEco Studio安装与配置）
✅ 创建第一个HarmonyOS 5项目
✅ 编写并理解核心代码（@Entry、@Component、@State装饰器）
✅ 使用模拟器或真机运行应用
这是HarmonyOS 5开发的第一步，后续我们将深入学习ArkTS语言特性、布局系统、状态管理等核心概念。建议您尝试修改代码中的message变量，观察UI如何自动更新，这是声明式UI的核心特性之一。