目录

引言

基本概念解析

1. 工程目录结构

2. 模块组成

3. 资源管理

开发环境搭建

1. 安装DevEco Studio

2. 工程创建

ArkTS语言基础与ArkUI框架

1. ArkTS语言特性

2. ArkUI框架概述

示例：天气应用首页

总结与后续学习建议

---

引言

随着万物互联时代的到来，HarmonyOS作为新一代智能终端操作系统，正在为开发者提供全新的开发体验。HarmonyOS NEXT作为全新架构版本，在开发工具、语言特性和工程结构上都进行了重大升级。本文将深入介绍HarmonyOS NEXT的工程结构，帮助开发者快速上手应用开发。

基本概念解析

1. 工程目录结构

HarmonyOS NEXT的工程采用模块化设计，典型工程目录结构如下：

MyApplication
├── .hvigor
├── .idea
├── AppScope
│   ├── resources
│   └── app.json5
├── entry
│   ├── src
│   │   ├── main
│   │   │   ├── ets
│   │   │   │   ├── entryability
│   │   │   │   ├── pages
│   │   │   │   └── Index.ets
│   │   │   ├── resources
│   │   │   └── module.json5
│   │   └── oh-package.json5
└── build-profile.json5

关键目录说明：

• AppScope：存放全局配置和资源
• entry：主模块，编译后生成HAP包
• ets：ArkTS源码目录
• resources：资源文件目录

2. 模块组成

HarmonyOS应用由多个模块组成，主要包括：

• HAP (Harmony Ability Package)：应用的基本部署单元
• HAR (Harmony Archive)：静态共享包
• HSP (Harmony Shared Package)：动态共享包

3. 资源管理

资源文件按照类型和用途分类存放：

resources
├── base
│   ├── element
│   │   ├── color.json
│   │   ├── string.json
│   │   └── ...
│   └── media
│       ├── icon.png
│       └── ...
└── rawfile
    └── data.txt

开发环境搭建

1. 安装DevEco Studio

推荐使用最新版DevEco Studio（5.0.4及以上版本），安装步骤：

1. 从官网下载安装包
2. 运行安装程序，选择默认配置
3. 首次启动时配置Node.js和HarmonyOS SDK路径

2. 工程创建

创建新工程的步骤：

1. 打开DevEco Studio，选择"Create Project"
2. 选择"Application"模板
3. 配置工程名称、包名和保存路径
4. 选择兼容的API版本（推荐5.0.0(12)及以上）
5. 点击"Finish"完成创建

ArkTS语言基础与ArkUI框架

1. ArkTS语言特性

ArkTS是HarmonyOS优选的主力开发语言，在TypeScript基础上扩展了：

• 声明式UI描述能力
• 多维状态管理机制
• 更严格的静态类型检查
• 优化的运行时性能

2. ArkUI框架概述

ArkUI是HarmonyOS的UI开发框架，提供：

• 声明式UI范式
• 丰富的组件系统
• 灵活的布局方式
• 强大的动画能力
• 高效的渲染管线

示例：天气应用首页

下面是一个完整的天气应用首页示例，展示了ArkTS和ArkUI的实际应用：

@Entry
@Component
struct WeatherPage {
  @State currentTemp: number = 26
  @State city: string = "北京"
  @State weatherCondition: string = "晴"
  @State forecastList: Array<ForecastItem> = [
    { day: '周一', temp: '26/18°C', icon: 'sunny' },
    { day: '周二', temp: '24/17°C', icon: 'cloudy' },
    { day: '周三', temp: '22/16°C', icon: 'rainy' }
  ]

  build() {
    Column() {
      // 当前天气信息
      Column() {
        Text(this.city)
          .fontSize(24)
          .fontWeight(FontWeight.Bold)
        
        Text(`${this.currentTemp}°C`)
          .fontSize(48)
          .margin({ top: 10 })
        
        Text(this.weatherCondition)
          .fontSize(18)
          .margin({ top: 5 })
      }
      .width('100%')
      .padding(20)
      .backgroundColor('#87CEEB')

      // 天气预报列表
      List({ space: 10 }) {
        ForEach(this.forecastList, (item: ForecastItem) => {
          ListItem() {
            Row() {
              Text(item.day)
                .fontSize(16)
                .layoutWeight(1)
              
              Image($r(`app.media.${item.icon}`))
                .width(30)
                .height(30)
              
              Text(item.temp)
                .fontSize(16)
                .layoutWeight(1)
                .textAlign(TextAlign.End)
            }
            .padding(15)
            .width('100%')
          }
        })
      }
      .width('100%')
      .layoutWeight(1)
    }
    .height('100%')
    .backgroundColor('#F5F5F5')
  }
}

interface ForecastItem {
  day: string
  temp: string
  icon: string
}

代码说明：

1. 使用@Entry和@Component装饰器定义页面组件
2. 使用@State装饰器管理组件状态
3. 采用声明式UI构建界面结构
4. 使用Column、Row、List等布局组件
5. 通过ForEach动态渲染天气预报列表

总结与后续学习建议

通过本文，我们了解了HarmonyOS NEXT工程的基本结构和开发流程。作为初学者，建议从以下几个方面继续深入学习：

1. ArkTS语言：掌握基础语法和高级特性
2. ArkUI框架：学习各种组件和布局的使用
3. 状态管理：理解不同场景下的状态管理方案
4. 模块化开发：学习HAR和HSP的使用
5. 性能优化：掌握应用性能分析和调优方法

HarmonyOS NEXT为开发者提供了强大的工具链和开发框架，通过系统学习和实践，开发者可以构建出高性能、跨设备的智能应用。