快速上手 HarmonyOS 应用开发

一、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. 安装与配置本地模拟器

1. 安装模拟器：

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

2. 未开启Hyper-V问题：

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

3. 运行项目：

• 启动模拟器后，在项目工具栏点击 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()	设置按钮点击事件处理逻辑。

---

凡是过去，皆为序章；凡是未来，皆有可期。