本文将通过简洁的步骤指导新手开发者快速完成鸿蒙5（HarmonyOS 5）应用的创建与部署，包含完整的代码实例与开发要点解析。

---

一、环境配置（2分钟）

1. 安装开发工具
   下载最新版 DevEco Studio，支持Windows/macOS/Linux系统。安装时需配置Node.js和HarmonyOS 5 SDK。

2. 开发者账号注册
   访问 华为开发者联盟完成实名认证，用于后续应用签名与发布。

---

二、创建项目（2分钟）

1. 初始化工程
   打开DevEco Studio → 选择 File > New > Project → 模板选 **Empty Ability (ArkTS)。

   • 关键配置
     • Project Name: HelloWorld
     • Bundle Name: com.example.helloworld
     • Compile SDK: HarmonyOS 5.0
     • Language: ArkTS

---

三、编写核心代码（3分钟）

1. 基础Hello World
修改 entry/src/main/ets/pages/Index.ets：

@Entry
@Component
struct Index {
  @State message: string = 'Hello HarmonyOS 5'

  build() {
    Column() {
      Text(this.message)
        .fontSize(30)
        .fontColor('#007DFF')
    }
    .width('100%')
    .height('100%')
  }
}

2. 添加交互功能（点击计数）

@Entry
@Component
struct Index {
  @State clickCount: number = 0

  build() {
    Column() {
      Text(`点击次数: ${this.clickCount}`)
        .fontSize(20)
        .margin(20)

      Button('点击+1')
        .width(150)
        .onClick(() => {
          this.clickCount++
        })
    }
    .width('100%')
    .height('100%')
  }
}

---

四、运行与调试（2分钟）

1. 选择部署目标

   • 点击工具栏 Tools > Device Manager 创建本地模拟器（推荐Phone类型）
   • 或通过USB连接鸿蒙真机（需开启开发者模式）

2. 启动应用
   点击工具栏 Run 'entry'，等待编译完成后即可看到运行效果。

---

五、扩展功能：页面跳转（1分钟）

1. 创建新页面

新建 Detail.ets：

@Component
export struct Detail {
  build() {
    Column() {
      Text('欢迎来到详情页')
        .fontSize(24)
    }
    .width('100%')
    .height('100%')
  }
}

2. 配置路由
修改 module.json5：

{
  "module": {
    "pages": [
      "pages/Index",
      "pages/Detail"
    ]
  }
}

3. 实现跳转逻辑

修改 Index.ets 的按钮事件：

Button('跳转详情')
  .onClick(() => {
    router.push({ url: 'pages/Detail' })
  })

---

六、项目打包（1分钟）

1. 点击 Build > Build HAP(s) 生成安装包
2. 输出文件路径：build/outputs/default/entry-default-signed.hap
3. 可通过华为应用市场或ADB命令安装测试

---

七、常见问题

1. 预览器无响应
   检查Node.js版本是否为16+，并重启DevEco Studio。

2. 真机无法连接
   确认设备已开启 USB调试 与 开发者模式。

3. ArkTS语法报错
   通过 Ctrl+Alt+L 格式化代码，或参考官方文档更新SDK。

---

通过本教程，您已掌握鸿蒙5应用的基础开发流程。建议后续学习原子化服务开发与分布式设备协同能力，深入鸿蒙生态建设。完整示例代码可通过DevEco Studio内置模板快速获取。