当前位置：首页 > news >正文

HarmonyOS 5开发从入门到精通（一）：环境搭建与第一个Hello World应用

news 2026/3/25 22:48:48

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%')}
}

代码解析：