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

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。这里的资源的引用是通过指定的文件路径和文件名来引用。

相关推荐
代码改善世界1 小时前
鸿蒙电脑能被远程控制吗?ToDesk鸿蒙双向远控能力解析
华为·电脑·harmonyos
OH_TPC7 小时前
ImageKnifePro 源码解读(四):降采样策略族——按显示尺寸改衣服,不按原尺寸硬塞
harmonyos
民办二本的神7 小时前
AI 助手升级后聊天记录又丢了(二):数据一直都在,丢的是"看见"
harmonyos
huang_xiaoen1 天前
鸿蒙手机远程控制电脑哪个好用?2026鸿蒙远控软件横测推荐
华为·harmonyos·远程工作·远程工具·远程办公
爱写Bug的浮游2 天前
初识仓颉:5 分钟看懂核心语法
harmonyos·编程语言
羽落•无痕(苏晗默)2 天前
华为数通IA——14、网络服务与应用:TCP/UDP 传输层协议与 FTP、Telnet、SSH 实践
网络·网络协议·tcp/ip·网络安全·华为·udp·信息与通信
程序猿追3 天前
鸿蒙 PC 的 Ionic 工单有两个错误,按下生成后光标该去哪儿
华为·harmonyos
KevinChaos3 天前
随手备忘录手记 04|HarmonyOS 7.0新特性实验:物品图鉴的加载逻辑
华为·harmonyos
Sirius_Ji3 天前
从硬解基座到字幕与滤镜链:ffmpeg-for-HarmonyOS v0.3.2
harmonyos
用户86194177207413 天前
uni-app 鸿蒙端提现点不动?我用 UTS 插件补上了微信"确认收款"
微信·harmonyos