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

HarmonyOS应用开发的工程目录结构

news 来源：原创 2025/8/29 4:28:46

AppScope > app.json5 应用级的配置信息

AppScope > resources 这个目录下的base>element用于存放全局使用的基本元素，如字符串、颜色和布尔值。base>media目录则存储媒体、动画和布局等资源文件。如果模块下的resources的有同样的资源，那么就会优先使用模块下的资源，否则就使用这里的资源。

hvigor：这个目录与android工程的gradle目录很像，行使的功能也类似。

oh_modules 这个目录用来存放第三方库依赖信息

build-profile.json5 这个文件位于根目录，它放置应用级配置信息，包括签名配置和产品配置，它的作用于android工程中的根目录下的build.gradle差不多。

hvigorfile.ts 应用的编译脚本

local.properties 这个与android工程的那个差不多

hvigorw：这个与android工程的gradlew的作用相似。hvigorw.bat是对应在windows中使用的脚本。

entry 这个目录与android工程的app目录是同等作用，就是这个应用的入口，所以在鸿蒙干脆它的目录名也起成了入口（entry）。我们的写的应用的代码都是放在这个目录中，打包时，就会将这里的代码编译，生成HAP，即HarmonyOS Ability package鸿蒙能力包，对就android的apk（application package）包。

entry目录下的子目录及其作用
build-profile.json5这个是编译配置文件，它包含了当前模块的信息和编译配置选项等等，就像android工程中每个module（模块）下都有一个build.gradle来管理当前模块的编译。Note：在鸿蒙应用工程的根目录也有一个这样的文件，那个是应用级的，全局的，这个是当前模块的局部的，android工程中的build.gradle也是一样，有一个应用级的，也有一个当前模块的。

hvigorfile.ts 这是一个模块级的编译脚本，在鸿蒙应用工程根目录也一个，那个是应用级的。在android工程倒是没有这样独立出来的编译脚本，它的编译脚本都放在了对应的build.gradle脚本中。

src > main > module.json5 这个文件描述了应用的全局配置信息，这个目录下的这份文件相当于android中app模块下的AndroidManifest.xml。

src > main > ets 放ArkTS源代码的地方，鸿蒙应用可以使用官方的开发语言ArkTS来开发。

src > main > ets > entryability 这个目录就是用来放所那些应用或服务的入口的，其实就是那些继承了UIAbility类的类文件。相当于android应用中的activity类

src > main > ets > pages 这个目录是专门用来放页面的，因为ArkTS采用了声明式UI，和android的Compose和iOS的SwiftUI都同样的产品。鸿蒙在这个目录里定义好页面，然后在src > main > ets > entryability 对应的ability加载出来。

src > main > resources 这个目录相当于android工程的res目录，用来放置应用用到的资源文件，如图片、多媒体、文字等，国际化也是在这里定义的。资源目录分为base基目录、qualifiers限定符目录和rawfile目录。

base 目录是默认提供的。在这个目录下，element子目录存放了诸如文字、颜色、布尔值等。media 和 profile 子目录存放了诸如多媒体、动画、布局等。编译时，这些资源文件都会被编译成二进制文件，并分配相应的ID。

这些资源因为是配置在entry中，所以也是在entry中来使用，使用的方法也很简单，它们是基于资源类型和资源名来引用，如在entry模块下的module.json5引用它们。如element>string.json有这样的配置：

{"string": [{"name": "EntryAbility_label","value": "label"}]
}

引用这个资源方式就是$string:EntryAbility_label,下面是entry模块下module.json5 对一些资源的引用：

qualifiers限定符目录，en_US和zh_CN是默认的两个限定符目录，我们可以根据我们的需要来增加其它的限定符目录。这些限定符目录其实存放的也是和base目录里的东西差不多，比如动画可以用一套，那么就直接用base基本目录里的就好，文字需要分开显示英语、简体中文、繁体中文，那么就需要在限定符目录里增加对应的文字资源，应用国际化就是这样一个好例子。英文、简体、繁体等文字、图片等资源都是不一样的，需要根据用户的选择来适配，那么等于我们有三份文字或图片来适配。图片有时也需要的，例如，图片上有一句话是产品做宣传用的，那么这张图片就应该有三张。下面是文字的例子：

其实上面讲的base目录和限定符目录，和android工程中的values ， values-en-rUS，values-zh-rCN是一样。

rawfile目录与android工程的raw目录是一样的。我们可以创建具有自定义名称的多级子目录来存储各种资源文件。 rawfile目录中的资源文件直接打包到应用程序中而不进行编译，并且不会为资源文件分配id。这里的资源的引用是通过指定的文件路径和文件名来引用。

相关文章：