鸿蒙系统(HarmonyOS)理论基础合集(四):资源文件

resources目录
应用的资源文件(字符串、图片、音频等)统一存放于resources目录下。
resource目录包括两大类目录,一类是base目录与限定词目录,另一类为rawfile目录
recources
|—base //默认存在的目录
| |—element
| | |—string.json
| |—media
| | |—icon.png
|—en_GB-vertical-car-mdpi //限定词目录示例,需要开发者自行创建
| |—element
| | |—string.json
| |—media
| | |—icon.png
|—rawfile //默认存在的目录

base目录与限定词目录
按照两级目录形式来组织,目录命名必须符合规范,以便根据设备状态去匹配相应目录下的资源文件。

一级子目录为base目录和限定词目录
· base目录是默认存在的目录。当应用的resources资源目录中没有与设备状态匹配的限定词目录时,会自动引用该目录中的资源文件。
· 限定词目录需要开发者自行创建。目录名称由一个或多个表征应用场景或设备特征的限定词组合而成。
二级子目录为资源目录,用于存放字符串、颜色、布尔值等基础元素,以及媒体、动画、布局等资源文件。

rawfile目录
支持创建多层子目录,目录名称可以自定义,文件夹内可以自由放置各类资源文件。
rawfile目录的文件不会根据设备状态去匹配不同的资源。

限定词目录
限定词目录可以由一个或多个表征应用场景或设备特征的限定词组合而成,包括移动国家码和移动
网络码、语言、文字、国家或地区、横竖屏、设备类型、颜色模式和屏幕密度等维度,限定词之间通过下划线()或者中划线(-)连接。
限定词目录的命名要求
·限定词的组合顺序:移动国家码_移动网络码_语言_文字_国家或地区_横竖屏_设备类型_深色模式
屏幕密度。开发者可以根据应用的使用场景和设备特征,选择其中的一类或几类限定词组成目录名称。
·限定词的连接方式:语言、文字、国家或地区之间采用下划线(
)连接,移动国家码和移动网络码
之间也采用下划线(
)连接,除此之外的其他限定词之间均采用中划线(-)连接。例如:zh_Hant_CN、zh_CN-car-ldpi
限定词目录与设备状态的匹配规则
·在为设备匹配对应的资源文件时,限定词目录匹配的优先级从高到低依次为:移动国家码和移动网络码>区域(语言_文字_国家或地区)>横竖屏>设备类型>颜色模式>屏幕密度。
·如果限定词目录中包含移动国家码和移动网络码、语言、文字、横竖屏、设备类型、颜色模式限定词,则对应限定词的取值必须与当前的设备状态完全一致,该目录才能够参与设备的资源匹配。例如,限定词目录“zh-CN-car-ldpi”不能参与“en_US”设备的资源匹配。

资源组目录
base目录与限定词目录下面可以创建资源组目录(包括element、media、animation、layout、graphic、profile),用于存放特定类型的资源文件。

为Element资源文件添加注释或特殊标识
Element目录下的不同种类元素的资源均采用JSON文件表示,资源的名称“name”和取值“value”
是每一条资源的必备字段
·如果需要为某一条资源备注信息,以便于资源的理解和使用,可以通过comment字段
添加注释。
·如果value字段中的部分文本不需要被翻译人员处理,也不会被显示在应用界面上,可以
通过特殊结构来标识无需翻译的内容。

猜你喜欢

转载自blog.csdn.net/zdj_Develop/article/details/117669645