[TOC] ## 概述 - 应用开发过程中，经常需要用到颜色、字体、间距、图片等资源，在不同的设备或配置中，这些资源的值可能不同。 - resources目录包括三大类目录，一类为base目录，一类为限定词目录，还有一类为rawfile目录 - 可通过 `DevEco Studio` 新建资源目录或资源文件 **样式:** ``` resources |---base | |---element | | |---string.json | |---media | | |---icon.png | |---profile | | |---test_profile.json |---en_US // 默认存在的目录，设备语言环境是美式英文时，优先匹配此目录下资源 | |---element | | |---string.json | |---media | | |---icon.png | |---profile | | |---test_profile.json |---zh_CN // 默认存在的目录，设备语言环境是简体中文时，优先匹配此目录下资源 | | ... |---rawfile // 其他类型文件，原始文件形式保存，不会被集成到resources.index文件中。文件名可自定义。 ``` **限定词目录** * 限定词的组合顺序：\_移动国家码\_移动网络码-语言\_文字\_国家或地区-横竖屏-设备类型-颜色模式-屏幕密度\_。开发者可以根据应用的使用场景和设备特征，选择其中的一类或几类限定词组成目录名称。 * 限定词的连接方式：语言、文字、国家或地区之间采用下划线（\_）连接，移动国家码和移动网络码之间也采用下划线（\_）连接，除此之外的其他限定词之间均采用中划线（-）连接。例如：**zh\_Hant\_CN**、**zh\_CN-car-ldpi**。 * 限定词的取值范围：每类限定词的取值必须符合限定词取值要求表中的条件，否则，将无法匹配目录中的资源文件。 具体说明请查看文档:https://developer.harmonyos.com/cn/docs/documentation/doc-guides-V3/resource-categories-and-access-0000001544463977-V3 ## 目录详情 ### element ``` element目录中的文件名称建议与下面的文件名保持一致。每个文件中只能包含同一类型的数据。 - boolean.json - color.json - float.json - intarray.json - integer.json - pattern.json - plural.json - strarray.json - string.json ``` ### media 表示媒体资源，包括图片、音频、视频等非文本格式的文件（目录下只支持文件类型） 文件名可自定义，例如：icon.png。 图片资源 ``` .jpg .png .gif .svg .webp .bmp ``` 视频资源 ``` .mp4 .webm .mkv ``` ### profile 表示自定义配置文件，其文件内容可通过包管理接口获取（目录下只支持文件类型）。 文件名可自定义，例如：test_profile.json。 ### 使用资源 ``` Text($r('app.string.string_hello')) // 引用string.json资源。Text中$r的第一个参数指定string资源，第二个参数用于替换string.json文件中的%s。 Text($r('app.string.message_arrive', "five of the clock")) // 应用资源 Image($rawfile('test.png')) // rawfile$r引用rawfile目录下图片 ```