快速上手 HarmonyOS 应用开发

devtools/2025/1/17 1:32:40/

一、DevEco Studio 安装与配置

1. DevEco Studio 简介

DevEco Studio 是 HarmonyOS 的一站式集成开发环境（IDE），提供了丰富的工具和功能，支持 HarmonyOS 应用开发的全流程。

2. DevEco Studio 下载与安装

下载地址：华为开发者官网
推荐版本：DevEco Studio 5.0.0 Release
安装建议：使用官方原版，不建议使用汉化版。

二、DevEco Studio 快速上手

1. 启动 DevEco Studio

双击 DevEco Studio 图标启动。
选择 Do not import settings，点击 OK。(没用过的)

2. 创建新项目

选择 Project > Create Project > Application > Empty Ability。
设置项目名称、保存位置及目标设备类型。
点击 Finish 完成项目创建。

三、运行 HelloWorld 项目

1. 运行方式

Previewer 预览模式：适用于静态页面开发，不支持网络通信和原生能力测试。
Local Emulator 本地模拟器：适用于大部分场景的调试和运行。
Local Device 本地真机：适用于特定机型测试。

2. 安装与配置本地模拟器

安装模拟器：

单击顶部工具栏Tools>Device Manager；选择Huawei_Phone手机模拟器，单击’Next’，进入模拟器系统下载页。

未开启Hyper-V问题：

找到命令提示符，以管理员的身份打开，执行：bcdedit /set hypervisorlaunchtype auto并重启电脑。

运行项目：

启动模拟器后，在项目工具栏点击 Run，将项目运行到模拟器中。（刚开始可以在预览模式内观看）

四、HarmonyOS 项目结构解析

1. 项目架构

APP Pack：应用发布形态，由一个或多个 HAP（Harmony Ability Package）包组成。
HAP：包含代码、资源、第三方库及配置文件，是 HarmonyOS 应用的核心模块。

2. 项目目录结构

目录/文件	描述
AppScope	存放全局资源文件。
entry	应用的主模块，包含代码和资源。
oh_modules	存放工程的依赖包。
build-profile.json5	工程级配置信息。
hvigorfile.ts	工程级编译构建任务脚本。

五、开发示例：HelloWorld 案例

在entry\src\main\ets\pages创建文件

代码示例

@Entry
@Component
struct Index {@State myTest: string = "world";build() {Column() {Text(`hello ${this.myTest}`).fontSize(50);Divider();Button("点我啊").onClick(() => {this.myTest = "ArkUI";}).height(50).width(200);}}
}

代码解析

组件/方法	描述
`@Entry`	将组件标记为 UI 页面入口。
`@Component`	定义自定义组件。
`@State`	标记状态变量，状态变化时自动刷新 UI。
`build()`	不可缺少。
`Column()`	布局组件，用于垂直排列内容。
`Text()`	文本组件，用于显示文字内容。
`Button()`	按钮组件，可设置点击事件。
`.fontSize()`	设置字体大小。
`.onClick()`	设置按钮点击事件处理逻辑。