【HarmonyOS NEXT 】应用开发:ArkTS工程目录结构(Stage模型)
SDK:5.0.0
DevEco Studio:5.0.3
Node.js:18.20.1
一、目录结构
├─AppScope
├─app.json5 // 应用的全局配置信息
├─entry // 应用/服务模块,编译构建生成一个HAP。
├─src
├─main
├─ets // 用于存放ArkTS源码
├─entryability // 应用/服务的入口
├─pages // 应用/服务包含的页面
├─resources // 用于存放应用/服务模块所用到的资源文件。
├─base // 图形、多媒体、字符串、布局文件等
├─en_US // 设备设置美式英文时,优先匹配此目录下资源
├─zh_CN // 设备设置美式简体中文时,优先匹配此目录下资源
├─module.json5 // Stage模型模块配置文件
├─……
├─build-profile.json5 // 当前的模块信息、编译信息配置项
├─hvigor // 配置和管理项目的构建过程
├─hvigor-config.json5 // 指定hvigor的版本、构建依赖以及构建行为的配置参数
├─oh_modules // 用于存放三方库依赖信息,包含应用/服务所依赖的第三方库文件
├─build-profile.json5 // 应用级配置信息,包括签名、产品配置等
├─hvigorfile.ts // 应用级编译构建任务脚本
├─local.properties // 配置SDK目录的
├─oh-package.json5 // 描述全局配置
二、部分目录及文件介绍
1、目录:src > main > resources > base
资源目录 | 资源文件说明 |
---|---|
element | 包括字符串、整型数、颜色、样式等资源的json文件。每个资源均由json格式进行定义,例如: ● boolean.json:布尔型 ● color.json:颜色 ● float.json:浮点型 ● intarray.json:整型数组 ● integer.json:整型 ● pattern.json:样式 ● plural.json:复数形式 ● strarray.json:字符串数组 ● string.json:字符串值。 |
media | 多媒体文件,如图形、视频、音频等文件,支持的文件格式包括:.png、.gif、.mp3、.mp4等。 |
rawfile | 用于存储任意格式的原始资源文件。rawfile不会根据设备的状态去匹配不同的资源,需要指定文件路径和文件名进行引用。 |
2、限定符目录
目录1:src > main > resources > zh_CN
目录2:src > main > resources > en_US
目录3.……
可自行增加其他限定性目录,与base目录里的东西差不多,主要用于应用程序的国际化,可根据需求设置不同地区的语言(图片、文字等)
3、目录:src > main > resources > rawfile
自定义创建多及子目录存储各种文件,该目录打包时在应用程序中不进行编译。不对文件分配id,资源的引用是通过指定的文件路径和文件名。
4、 当前的模块信息、编译信息配置项
目录1:src > main > resources > module.json5
目录2:src > main > resources > base > element > string.json
目录3:src > main > resources > zh_CN > element > string.json
目录4:src > main > resources > en_US> element > string.json
……
(1)module.json5 会引用string.json中的配置项
(2)引用方式如:$string:EntryAbility_label
(3)依据设备语言调用不同的设置文件,默认调用base,英文调用en_US,中文调用zh_CN等