Harmony学习之开发环境搭建与第一个应用

Harmony学习之开发环境搭建与第一个应用

一、场景引入

小明是一名刚接触HarmonyOS开发的新手，他想要开发一个简单的待办事项应用，但不知道从哪里开始。第一步需要搭建开发环境并创建第一个应用。本文将手把手带你完成这个关键步骤，为后续学习打下坚实基础。

二、开发环境准备

1. 系统要求

在开始安装前，请确保你的电脑满足以下最低配置要求：

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

2. 下载DevEco Studio

访问华为开发者联盟官网（https://developer.harmonyos.com），在"开发"板块选择"下载DevEco Studio"。根据你的操作系统选择对应版本下载。Windows系统下载.exe文件，macOS系统下载.dmg文件

3. 安装DevEco Studio

Windows系统安装步骤：

1. 双击下载的.exe文件运行安装程序
2. 选择安装路径（建议选择非系统盘且路径中不包含中文的目录）
3. 勾选"创建桌面快捷方式"和"将安装路径添加到系统环境变量"
4. 点击"Install"开始安装，完成后点击"Finish"

macOS系统安装步骤：

将下载的.dmg文件中的DevEco Studio.app拖拽到Applications文件夹即可

三、首次配置

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

1. 同意许可协议：阅读并同意软件许可协议
2. 配置Node.js和Ohpm：IDE会自动检测并安装合适版本的Node.js（要求v14.19.1及以上）和Ohpm包管理器
3. 配置HarmonyOS SDK路径：选择SDK存储路径，确保有足够的磁盘空间
4. 选择SDK版本：勾选需要安装的SDK组件，包括Platform、Toolchains、Previewer等

四、创建第一个项目

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版本12）
• Language：选择ArkTS
• Model：保持默认的Stage模型
• Device Type：选择Phone

点击"Finish"完成项目创建，等待项目同步完成。

2. 项目结构解析

创建成功后，项目的基本结构如下：

MyFirstApp/
├── entry/                 # 主模块
│   ├── src/
│   │   ├── main/
│   │   │   ├── ets/       # ArkTS代码存放目录
│   │   │   │   ├── pages/ # 页面目录
│   │   │   │   │   └── Index.ets # 应用入口页面
│   │   │   ├── resources/ # 资源文件（图片、字符串、样式等）
│   │   │   └── module.json5 # 模块配置文件
│   │   └── oh-package.json # 项目依赖管理文件
├── AppScope/              # 应用全局配置
│   └── app.json5          # 应用配置文件
└── 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自动更新，这是声明式UI的核心特性之一
• build()：组件必须实现的方法，在其中声明UI布局。这里使用Row和Column进行横向和纵向布局，内部包含一个显示message变量的Text文本组件

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

六、运行与调试

1. 使用模拟器

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

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

2. 使用真机调试

如果你有搭载HarmonyOS 5.0的手机，真机调试体验更佳：

1. 开启开发者模式：进入手机的"设置 > 关于手机"，连续点击"版本号"7次，直到提示已进入开发者模式
2. 启用USB调试：返回"设置"，进入"系统和更新 > 开发人员选项"，开启"USB调试"和"USB安装"
3. 连接电脑：使用USB数据线连接手机和电脑，手机会弹出授权对话框，选择"允许"
4. 运行项目：在DevEco Studio中，设备选择列表里会出现你的手机型号，选择它并点击运行按钮即可

七、常见问题解决

1. SDK下载失败

• 检查网络连接是否稳定
• 尝试使用代理或手动下载SDK包离线安装
• 确认网络代理设置是否正确

2. 模拟器无法启动

• 检查是否开启虚拟化技术（BIOS设置）
• 确保安装了正确版本的SDK
• 检查系统内存是否充足
• Windows系统需开启Hyper-V功能

3. 编译错误

• 检查Node.js版本是否兼容
• 确保Python环境变量正确配置
• 清理项目缓存后重新构建

八、总结与行动建议

核心要点回顾

1. 环境搭建：下载并安装DevEco Studio，配置Node.js和HarmonyOS SDK
2. 项目创建：使用Empty Ability模板创建第一个项目，配置项目基本信息
3. 代码结构：理解@Entry、@Component、@State等核心装饰器的作用
4. 运行调试：使用模拟器或真机运行应用，验证环境配置成功

行动建议

1. 动手实践：按照本文步骤，独立完成开发环境搭建和第一个应用的创建
2. 代码修改：尝试修改message变量的值，观察UI自动更新的效果
3. 探索功能：在模拟器中体验应用的基本操作，熟悉开发工具界面
4. 查阅文档：遇到问题时，访问华为开发者联盟官网查阅官方文档和常见问题解答

通过本篇文章的学习，你已经成功迈出了HarmonyOS应用开发的第一步。下一篇文章将深入讲解ArkTS语言基础，帮助你掌握HarmonyOS开发的核心语言特性。