HarmonyOS 开发入门指南

📅 2025-05-20 · ⏱ 10 分钟 · 入门

HarmonyOS（鸿蒙操作系统）是华为自主研发的分布式操作系统，旨在实现跨设备的无缝协同体验。本教程将带你从零开始，完成第一个鸿蒙应用。

一、开发环境搭建

要开发鸿蒙应用，首先需要安装 DevEco Studio，这是华为官方提供的集成开发环境（IDE），基于 IntelliJ IDEA 构建。

1. 下载 DevEco Studio

前往华为开发者官网下载 DevEco Studio 最新版本。目前支持 Windows 和 macOS 平台。

2. 安装步骤

• 双击安装包，按照向导完成安装
• 首次启动配置 SDK 路径，建议使用默认路径
• 配置 Node.js 和 ohpm（鸿蒙包管理器）环境
• 等待 SDK 下载完成（可能需要 10-20 分钟）

3. 系统要求

• Windows 10/11 64位 或 macOS 12+
• 至少 8GB 内存（推荐 16GB）
• 至少 30GB 可用磁盘空间
• 稳定的网络连接（用于下载 SDK）

二、创建第一个项目

打开 DevEco Studio，点击 Create New Project，选择模板：

• Empty Ability：空白模板，适合初学者
• Application 应用类型
• 选择 ArkTS 作为开发语言
• 设置项目名称和包名（如 com.example.helloworld）

三、项目结构

一个标准的鸿蒙项目包含以下关键目录和文件：

MyApplication/
├── entry/
│   ├── src/main/
│   │   ├── ets/          # ArkTS 源代码
│   │   │   ├── entryability/  # Ability 生命周期
│   │   │   └── pages/         # 页面文件
│   │   ├── resources/    # 资源文件（图片、字符串等）
│   │   └── module.json5  # 模块配置
│   └── build-profile.json5
├── oh_modules/
├── build-profile.json5   # 项目级构建配置
└── package.json          # 依赖配置

四、编写 Hello World

打开 entry/src/main/ets/pages/Index.ets（或在最新版中可能是 Index.ets），替换为以下代码：

@Entry
@Component
struct Index {
  @State message: string = "Hello HarmonyOS!"

  build() {
    Column() {
      Text(this.message)
        .fontSize(28)
        .fontWeight(FontWeight.Bold)
        .fontColor(Color.Red)
        .margin({ bottom: 20 })

      Button("点击我")
        .onClick(() => {
          this.message = "欢迎来到鸿蒙世界! 🎉"
        })
    }
    .width("100%")
    .height("100%")
    .padding(20)
  }
}

代码解析

• @Entry：标记页面入口
• @Component：声明一个 UI 组件
• @State：状态变量，变化时自动更新 UI
• build()：描述 UI 布局的声明式方法
• Column / Text / Button：ArkUI 基础组件

五、运行应用

DevEco Studio 提供了多种运行方式：

• 本地模拟器：在电脑上运行鸿蒙模拟器，适合快速测试
• 真机运行：连接到华为手机或平板进行调试
• 远程设备：通过 Cloud Testing 远程调试

点击顶部工具栏的 Run 按钮（▶️），选择设备后即可看到运行效果。

六、下一步学习

完成第一个应用后，建议继续学习：

• 深入研究 ArkTS 语言 的类型系统和装饰器
• 掌握 ArkUI 组件库 的各种组件
• 学习 页面路由 和导航设计
• 了解 数据管理 和状态共享