1# 资源分类与访问 2 3应用开发过程中，经常需要用到颜色、字体、间距、图标等资源，在不同的设备或配置中，这些资源的值可能不同。 4 5- 应用资源：借助资源文件能力，开发者在应用中自定义资源，自行管理这些资源在不同的设备或配置中的表现。 6 7- 系统资源：开发者可以在[应用UX设计关于资源的介绍](https://gitee.com/openharmony/docs/blob/master/zh-cn/design/ux-design/design-resources.md)，获取支持的色彩、字体等系统资源ID及其在不同配置下的取值；在[主题图标库](https://developer.huawei.com/consumer/cn/design/harmonyos-symbol/)获取支持的系统图标资源。 8 9## 资源分类 10 11应用开发中使用的各类资源文件，需要放入特定子目录中存储管理。资源目录的示例如下所示，base目录、限定词目录、rawfile目录、resfile目录称为资源目录，element、media、profile称为资源组目录。 12 13> **说明** 14> 15> stage模型多工程情况下，共有的资源文件放到AppScope下的resources目录。 16 17资源目录示例： 18``` 19resources 20|---base 21| |---element 22| | |---string.json 23| |---media 24| | |---icon.png 25| |---profile 26| | |---test_profile.json 27|---en_US // 默认存在的目录，设备语言环境是美式英文时，优先匹配此目录下资源 28| |---element 29| | |---string.json 30| |---media 31| | |---icon.png 32| |---profile 33| | |---test_profile.json 34|---zh_CN // 默认存在的目录，设备语言环境是简体中文时，优先匹配此目录下资源 35| |---element 36| | |---string.json 37| |---media 38| | |---icon.png 39| |---profile 40| | |---test_profile.json 41|---en_GB-vertical-car-mdpi // 自定义限定词目录示例，由开发者创建 42| |---element 43| | |---string.json 44| |---media 45| | |---icon.png 46| |---profile 47| | |---test_profile.json 48|---rawfile // 其他类型文件，原始文件形式保存，不会被集成到resources.index文件中。文件名可自定义。 49|---resfile // 其他类型文件，原始文件形式保存，不会被集成到resources.index文件中。文件名可自定义。 50``` 51### 资源目录 52 53#### base目录 54 55base目录是默认存在的目录，二级子目录element用于存放字符串、颜色、布尔值等基础元素，media、profile存放媒体、动画、布局等资源文件。<br/> 56目录中的资源文件会被编译成二进制文件，并赋予资源文件ID。通过指定资源类型（type）和资源名称（name）访问。 57 58#### 限定词目录 59 60en_US和zh_CN是默认存在的两个限定词目录，其余限定词目录需要开发者根据开发需要自行创建。二级子目录element、media、profile用于存放字符串、颜色、布尔值等基础元素，以及媒体、动画、布局等资源文件。<br/>同样，目录中的资源文件会被编译成二进制文件，并赋予资源文件ID。通过指定资源类型（type）和资源名称（name）来访问。 61 62**限定词目录的命名要求** 63 64限定词目录可以由一个或多个表征应用场景或设备特征的限定词组合而成，包括移动国家码和移动网络码、语言、文字、国家或地区、横竖屏、设备类型、颜色模式和屏幕密度等维度，限定词之间通过下划线（\_）或者中划线（\-）连接。开发者在创建限定词目录时，需要遵守限定词目录的命名规则。 65 66- 限定词的组合顺序：\_移动国家码_移动网络码-语言_文字_国家或地区-横竖屏-设备类型-颜色模式-屏幕密度_。开发者可以根据应用的使用场景和设备特征，选择其中的一类或几类限定词组成目录名称。 67 68- 限定词的连接方式：语言、文字、国家或地区之间采用下划线（\_）连接，移动国家码和移动网络码之间也采用下划线（\_）连接，除此之外的其他限定词之间均采用中划线（-）连接。例如：**zh_Hant_CN**、**zh_CN-car-ldpi**。 69 70- 限定词的取值范围：每类限定词的取值必须符合限定词取值要求表中的条件，如表2。否则，将无法匹配目录中的资源文件。 71 72表2 限定词取值要求 73 74| 限定词类型 | 含义与取值说明 | 75| ----------- | ---------------------------------------- | 76| 移动国家码和移动网络码 | 移动国家码（MCC）和移动网络码（MNC）的值取自设备注册的网络。<br/>MCC可与MNC合并使用，使用下划线（_）连接，也可以单独使用。例如：mcc460表示中国，mcc460_mnc00表示中国_中国移动。<br/>详细取值范围，请查阅[**ITU-T E.212**](https://www.itu.int/rec/T-REC-E.212)（国际电联相关标准）。 | 77| 语言 | 表示设备使用的语言类型，由2~3个小写字母组成。例如：zh表示中文，en表示英语，mai表示迈蒂利语。<br/>详细取值范围，请查阅[**ISO 639**](https://www.iso.org/iso-639-language-code)（ISO制定的语言编码标准）。 | 78| 文字 | 表示设备使用的文字类型，由1个大写字母（首字母）和3个小写字母组成。例如：Hans表示简体中文，Hant表示繁体中文。<br/>详细取值范围，请查阅[**ISO 15924**](https://www.iso.org/standard/81905.html)（ISO制定的文字编码标准）。 | 79| 国家或地区 | 表示用户所在的国家或地区，由2~3个大写字母或者3个数字组成。例如：CN表示中国，GB表示英国。<br/>详细取值范围，请查阅[**ISO 3166-1**](https://www.iso.org/iso-3166-country-codes.html)（ISO制定的国家和地区编码标准）。 | 80| 横竖屏 | 表示设备的屏幕方向，取值如下：<br/>- vertical：竖屏<br/>- horizontal：横屏 | 81| 设备类型 | <!--RP1-->表示设备的类型，取值如下：<br/>- car：车机<br/>- tablet：平板<br/>- tv：智慧屏<br/>- wearable：智能穿戴<!--RP1End--> | 82| 颜色模式 | 表示设备的颜色模式，取值如下：<br/>- dark：深色模式<br/>- light：浅色模式 | 83| 屏幕密度 | 表示设备的屏幕密度（单位为dpi），取值如下：<br/>- sdpi：表示小规模的屏幕密度（Small-scale Dots Per Inch），适用于dpi取值为(0, 120]的设备。<br/>- mdpi：表示中规模的屏幕密度（Medium-scale Dots Per Inch），适用于dpi取值为(120, 160]的设备。<br/>- ldpi：表示大规模的屏幕密度（Large-scale Dots Per Inch），适用于dpi取值为(160, 240]的设备。<br/>- xldpi：表示特大规模的屏幕密度（Extra Large-scale Dots Per Inch），适用于dpi取值为(240, 320]的设备。<br/>- xxldpi：表示超大规模的屏幕密度（Extra Extra Large-scale Dots Per Inch），适用于dpi取值为(320, 480]的设备。<br/>- xxxldpi：表示超特大规模的屏幕密度（Extra Extra Extra Large-scale Dots Per Inch），适用于dpi取值为(480, 640]的设备。 | 84 85#### rawfile目录 86 87支持创建多层子目录，子目录名称可以自定义，文件夹内可以自由放置各类资源文件。<br/>目录中的资源文件会被直接打包进应用，不经过编译，也不会被赋予资源文件ID。通过指定文件路径和文件名访问。 88 89#### resfile目录 90 91支持创建多层子目录，子目录名称可以自定义，文件夹内可以自由放置各类资源文件。<br/>目录中的资源文件会被直接打包进应用，不经过编译，也不会被赋予资源文件ID。应用安装后，resfile资源会被解压到应用沙箱路径，通过Context属性[resourceDir](../reference/apis-ability-kit/js-apis-inner-application-context.md#属性)获取到resfile资源目录后，可通过文件路径访问。 92 93### 资源组目录 94 95资源组目录包括element、media、profile三种类型的资源文件，用于存放特定类型资源。 96 97 表3 资源组目录说明 98 99| 目录类型 | 说明 | 资源文件 | 100| --------- | ---------------------------------------- | ---------------------------------------- | 101| element | 表示元素资源，以下每一类数据都采用相应的JSON文件来表征（目录下仅支持文件类型）。<br/>- boolean，布尔型<br/>- color，颜色<br/>- float，浮点型，范围是-2^128-2^128<br/>- intarray，整型数组<br/>- integer，整型，范围是-2^31-2^31-1<!--Del--><br/>- pattern，样式（仅支持系统应用使用）<!--DelEnd--><br/>- plural，复数形式<br/>- strarray，字符串数组<br/>- string，字符串，[格式化字符串请参考API文档](../reference/apis-localization-kit/js-apis-resource-manager.md#getstringsync10)<!--Del--><br/>- theme，主题（仅支持系统应用使用）<!--DelEnd-->| element目录中的文件名称建议与下面的文件名保持一致。每个文件中只能包含同一类型的数据。<br/>- boolean.json<br/>- color.json<br/>- float.json<br/>- intarray.json<br/>- integer.json<!--Del--><br/>- pattern.json<!--DelEnd--><br/>- plural.json<br/>- strarray.json<br/>- string.json | 102| media | 表示媒体资源，包括图片、音频、视频等非文本格式的文件（目录下只支持文件类型）。<br/>图片和音视频的类型说明见表4和表5。 | 文件名可自定义，例如：icon.png。 | 103| profile | 表示自定义配置文件，其文件内容可[通过包管理接口](../reference/apis-ability-kit/js-apis-bundleManager.md#bundlemanagergetprofilebyability)获取（目录下只支持json文件类型）。 | 文件名可自定义，例如：test_profile.json。 | 104 105**媒体资源类型说明** 106 107表4 图片资源类型说明 108 109| 格式 | 文件后缀名 | 110| ---- | ----- | 111| JPEG | .jpg | 112| PNG | .png | 113| GIF | .gif | 114| SVG | .svg | 115| WEBP | .webp | 116| BMP | .bmp | 117 118表5 音视频资源类型说明 119 120| 格式 | 支持的文件类型 | 121| ------------------------------------ | --------------- | 122| H.264 AVC |.3gp | 123| Baseline Profile (BP) | .mp4 | 124 125**资源文件示例** 126 127color.json文件的内容如下： 128 129```json 130{ 131 "color": [ 132 { 133 "name": "color_hello", 134 "value": "#ffff0000" 135 }, 136 { 137 "name": "color_world", 138 "value": "#ff0000ff" 139 } 140 ] 141} 142``` 143 144float.json文件的内容如下： 145 146```json 147{ 148 "float":[ 149 { 150 "name":"font_hello", 151 "value":"28.0fp" 152 }, 153 { 154 "name":"font_world", 155 "value":"20.0fp" 156 } 157 ] 158} 159``` 160 161string.json文件的内容如下： 162 163```json 164{ 165 "string":[ 166 { 167 "name":"string_hello", 168 "value":"Hello" 169 }, 170 { 171 "name":"string_world", 172 "value":"World" 173 }, 174 { 175 "name":"message_arrive", 176 "value":"We will arrive at %1$s." 177 }, 178 { 179 "name":"message_notification", 180 "value":"Hello, %1$s!,You have %2$d new messages." 181 } 182 ] 183} 184``` 185 186plural.json文件的内容如下： 187 188```json 189{ 190 "plural":[ 191 { 192 "name":"eat_apple", 193 "value":[ 194 { 195 "quantity":"one", 196 "value":"%d apple" 197 }, 198 { 199 "quantity":"other", 200 "value":"%d apples" 201 } 202 ] 203 } 204 ] 205} 206``` 207 208## 创建资源目录和资源文件 209 210在resources目录下，可按照限定词目录命名规则，以及资源组目录支持的文件类型和说明，创建资源目录和资源组目录，添加特定类型资源。DevEco Studio支持同时创建资源目录和资源文件，也支持单独创建资源目录或资源文件。 211 212### 创建资源目录和资源文件 213 214在resources目录右键菜单选择“New > Resource File”，可同时创建资源目录和资源文件，文件默认创建在base目录的对应资源组。如果选择了限定词，则会按照命名规范自动生成限定词和资源组目录，并将文件创建在限定词目录中。 215 216图中File name为需要创建的文件名。Resource type为资源组类型，默认是element。Root Element为资源类型。Avaliable qualifiers为供选择的限定词目录，通过右边的小箭头可添加或者删除。<br/>创建的目录名自动生成，格式固定为“限定词.资源组”，例如：创建一个限定词为dark的element目录，自动生成的目录名称为“dark.element”。 217 218  219 220### 创建资源目录 221 222在resources目录右键菜单选择“New > Resource Directory”，可创建资源目录，默认创建的是base目录。如果选择了限定词，则会按照命名规范自动生成限定词和资源组目录。确定限定词后，选择资源组类型，当前资源组类型支持Element、Media、Profile三种，创建后生成资源目录。 223 224  225 226### 创建资源文件 227 228在资源目录（element、media、profile）的右键菜单选择“New > XXX Resource File”，即可创建对应资源组目录的资源文件。例如，在element目录下可新建Element Resource File。 229 230  231 232## 资源可翻译特性 233 234### 功能介绍 235 236资源需要翻译时，可使用attr属性标记字符串翻译范围和翻译状态。attr属性不参与资源编译，只标记字符串是否翻译。 237 238未配置attr属性，默认需要翻译。 239``` 240"attr": { 241 "translatable": false|true 242 "priority": "code|translate|LT|customer" 243} 244``` 245**attr支持属性** 246 247| 名称 | 类型 | 说明 | 248| --------- | ----------------------- | ---- | 249| translatable | boolean | 标记字符串是否需要翻译。 <br> true：需要翻译。 <br> false：不需要翻译。| 250| priority | string | 标记字符串翻译状态。<br>code：未翻译。<br>translate：翻译未验证。<br>LT：翻译已验证。<br>customer：用户定制字符串。 | 251 252### 使用约束 253可翻译特性使能范围：base目录下string、strarray、plural类型资源。 254``` 255resources 256|---base 257| |---element 258| | |---string.json 259| | |---strarray.json 260| | |---plural.json 261``` 262### 示例 263string资源配置attr属性示例如下： 264 265```json 266{ 267 "string": [ 268 { 269 "name": "string1", 270 "value": "1", 271 "attr": { 272 "translatable": false 273 } 274 }, 275 { 276 "name": "string2", 277 "value": "Hello world!", 278 "attr": { 279 "translatable": true, 280 "priority": "LT" 281 } 282 } 283 ] 284} 285``` 286 287## 资源访问 288 289### 单HAP包应用资源 290 291 - 通过```"$r"```或```"$rawfile"```访问资源。<br/>对于“color”、“float”、“string”、“plural”、“media”、“profile”等类型的资源，通过```"$r('app.type.name')"```形式访问。其中，app为resources目录中定义的资源；type为资源类型或资源的存放位置；name为资源名，开发者定义资源时确定。<br/>对于string.json中使用多个占位符的情况，通过```$r('app.string.label','aaa','bbb',444)```形式访问。<br/>对于rawfile目录资源，通过```"$rawfile('filename')"```形式访问。其中，filename为rawfile目录下文件的相对路径，文件名需要包含后缀，路径开头不可以"/"开头。 292 293 > **说明：** 294 > 295 > rawfile的native的访问方式请参考[Rawfile开发指导](../napi/rawfile-guidelines.md)。 296 297 [资源组目录](#资源组目录)下的“资源文件示例”显示了.json文件内容，包含color.json文件、string.json文件和plural.json文件，访问应用资源时需先了解.json文件的使用规范。<br/>资源的具体使用方法如下： 298 299 ```ts 300 //通过$r('app.type.name')访问 301 Text($r('app.string.string_hello')) 302 .fontColor($r('app.color.ohos_id_color_emphasize')) 303 .fontSize($r('app.float.ohos_id_text_size_headline1')) 304 .fontFamily($r('app.string.ohos_id_text_font_family_medium')) 305 .backgroundColor($r('app.color.ohos_id_color_palette_aux1')) 306 307 Image($r('app.media.ohos_app_icon')) 308 .border({ 309 color: $r('app.color.ohos_id_color_palette_aux1'), 310 radius: $r('app.float.ohos_id_corner_radius_button'), width: 2 311 }) 312 .margin({ 313 top: $r('app.float.ohos_id_elements_margin_horizontal_m'), 314 bottom: $r('app.float.ohos_id_elements_margin_horizontal_l') 315 }) 316 .height(200) 317 .width(300) 318 319 //对占位符，通过$r('app.string.label','aaa','bbb',444)访问 320 Text($r('app.string.message_notification','LiHua',2)) 321 ``` 322 323- 通过本应用上下文获取ResourceManager后，调用不同[资源管理接口](../reference/apis-localization-kit/js-apis-resource-manager.md)访问不同资源。<br/>例如：getContext().resourceManager.getStringByNameSync('test') 可获取字符串资源；getContext().resourceManager.getRawFd('rawfilepath') 可获取Rawfile所在hap包的descriptor信息，访问rawfile文件时需{fd, offset, length}一起使用。 324 325### 跨HAP/HSP包应用资源 326 327<!--Del--> 328#### bundle不同，跨bundle访问（仅支持系统应用使用） 329 330- 通过[createBundleContext(context, bundleName)](../reference/apis-ability-kit/js-apis-app-ability-application-sys.md#applicationcreatebundlecontext12)接口创建对应HAP/HSP包的上下文，获取resourceManager对象后，调用不同[资源管理接口](../reference/apis-localization-kit/js-apis-resource-manager.md)访问不同资源。 331<!--DelEnd--> 332 333#### bundle相同，跨module访问 334 335- 通过[createModuleContext(context, moduleName)](../reference/apis-ability-kit/js-apis-app-ability-application.md#applicationcreatemodulecontext12)接口创建同应用中不同module的上下文，获取resourceManager对象后，调用不同[资源管理接口](../reference/apis-localization-kit/js-apis-resource-manager.md)访问不同资源。 336 337- 通过```"$r"```或```"$rawfile"```访问资源。具体操作如下： 338 339 1.在entry的oh-package.json5文件中添加依赖。如```"dependencies": {"library":"file":../library}``` 340  341 342 2.这里是列表文本[hsp].type.name获取资源。其中，hsp为hsp模块名，type为资源类型，name为资源名称，示例如下： 343 344 ```ts 345 Text($r('[hsp].string.test_string')) 346 .fontSize($r('[hsp].float.font_size')) 347 .fontColor($r('[hsp].color.font_color')) 348 Image($rawfile('[hsp].icon.png')) 349 ``` 350 3.使用变量获取资源。示例如下： 351 352 ```ts 353 @Entry 354 @Component 355 struct Index { 356 text: string = '[hsp].string.test_string'; 357 fontSize: string = '[hsp].float.font_size'; 358 fontColor: string = '[hsp].color.font_color'; 359 image: string = '[hsp].media.string'; 360 rawfile: string = '[hsp].icon.png'; 361 362 build() { 363 Row() { 364 Text($r(this.text)) 365 .fontSize($r(this.fontSize)) 366 .fontColor($r(this.fontColor)) 367 368 Image($r(this.image)) 369 370 Image($rawfile(this.rawfile)) 371 } 372 } 373 } 374 ``` 375 > **说明** 376 > 377 > hsp包名必须写在[]内，rawfile下有多层目录，需要从rawfile下面第一个目录开始写，如```"$rawfile('[hsp].oneFile/twoFile/icon.png')"```，使用```"$r"```和```"$rawfile"```跨包访问HSP包资源无法提供编译时的资源校验，需要开发者自行保证使用资源存在于对应包中。 378 379### 系统资源 380 381开发者可以在[应用UX设计关于资源的介绍](https://gitee.com/openharmony/docs/blob/master/zh-cn/design/ux-design/design-resources.md)，获取支持的色彩、字体等系统资源ID及其在不同配置下的取值；在[主题图标库](https://developer.huawei.com/consumer/cn/design/harmonyos-symbol/)获取支持的图标资源，获取到图标资源后可通过[SymbolGlyph](../reference/apis-arkui/arkui-ts/ts-basic-components-symbolGlyph.md)对图标颜色等进一步设置。 382 383对于系统资源，可以通过```“$r('sys.type.resource_name')”```的形式访问。其中，sys表示系统资源；type为资源类型，取值包括“color”、“float”、“string”、“media”、“symbol”；resource_name为资源名称。 384 385> **说明：** 386> 387> - 仅声明式开发范式支持使用系统资源。 388> 389> - 对于系统预置应用，建议使用系统资源；对于三方应用，可以根据需要选择使用系统资源或自定义应用资源。 390> 391> - 界面加载的系统资源字体进行显示时，可以在配置中system/etc/fontconfig.json文件查看。默认字体为HarmonyOS Sans。 392 393```ts 394Text('Hello') 395 .fontColor($r('sys.color.ohos_id_color_emphasize')) 396 .fontSize($r('sys.float.ohos_id_text_size_headline1')) 397 .fontFamily($r('sys.string.ohos_id_text_font_family_medium')) 398 .backgroundColor($r('sys.color.ohos_id_color_palette_aux1')) 399 400Image($r('sys.media.ohos_app_icon')) 401 .border({ 402 color: $r('sys.color.ohos_id_color_palette_aux1'), 403 radius: $r('sys.float.ohos_id_corner_radius_button'), width: 2 404 }) 405 .margin({ 406 top: $r('sys.float.ohos_id_elements_margin_horizontal_m'), 407 bottom: $r('sys.float.ohos_id_elements_margin_horizontal_l') 408 }) 409 .height(200) 410 .width(300) 411``` 412 413## 资源匹配 414 415应用使用某资源时，系统会根据当前设备状态优先从相匹配的限定词目录中寻找该资源。只有当resources目录中没有与设备状态匹配的限定词目录，或者在限定词目录中找不到该资源时，才会去base目录中查找。rawfile是原始文件目录，不会根据设备状态去匹配不同的资源。 416 417### 限定词目录与设备状态的匹配规则 418 419- 在为设备匹配对应的资源文件时，限定词目录匹配的优先级从高到低依次为：移动国家码和移动网络码 > 区域（可选组合：语言、语言_文字、语言_国家或地区、语言_文字_国家或地区）> 横竖屏 > 设备类型 > 颜色模式 > 屏幕密度。 420 421- 如果限定词目录中包含移动国家码和移动网络码、语言、文字、横竖屏、设备类型、颜色模式限定词，则对应限定词的取值必须与当前的设备状态完全一致，该目录才能够参与设备的资源匹配。例如，限定词目录“zh_CN-car-ldpi”不能参与“en_US”设备的资源匹配。 422 423- 如果存在多个屏幕密度限定词目录，则优先向上匹配最接近的屏幕密度限定词目录，否则向下匹配最为接近的屏幕密度限定词目录。例如，假设存在限定词目录“xldpi”和“xxldpi”，设备屏幕密度为“xxldpi”，则会匹配“xxldpi”限定词目录。 424 425应用界面加载资源规则，更多请参考国际化和本地化文档。 426 427### 获取指定配置的资源 428 429#### 基本概念 430 431开发者可以在工程的resource目录下添加限定词目录，满足多语言、深浅色模式等不同类型的系统设置。然而，在获取资源时，由于限定词目录匹配规则，只能筛选出最匹配的资源，无法获取其它目录资源。 432 433应用如果有获取指定配置的资源的诉求，可以通过以下方法进行获取。 434 435#### 接口说明 436 437| 接口名 | 描述 | 438| ------------------------------------------------------------ | ------------------------------------------------------------ | 439| [getOverrideResourceManager](../reference/apis-localization-kit/js-apis-resource-manager.md#getoverrideresourcemanager12)(configuration?: [Configuration](../reference/apis-localization-kit/js-apis-resource-manager.md#configuration)) : [ResourceManager](../reference/apis-localization-kit/js-apis-resource-manager.md#resourcemanager) | 获取可以加载指定配置的资源的资源管理对象，使用同步方式返回。 | 440| [getOverrideConfiguration](../reference/apis-localization-kit/js-apis-resource-manager.md#getoverrideconfiguration12)() : [Configuration](../reference/apis-localization-kit/js-apis-resource-manager.md#configuration) | 获取指定的配置，使用同步方式返回 | 441| [updateOverrideConfiguration](../reference/apis-localization-kit/js-apis-resource-manager.md#updateoverrideconfiguration12)(configuration: [Configuration](../reference/apis-localization-kit/js-apis-resource-manager.md#configuration)) : void | 更新指定的配置 | 442 443#### 示例 444 445以获取非当前系统语言的资源为例，说明如何获取指定配置的资源，假设工程中中文、英文、德文的资源目录定义了如下同名资源： 446 447- entry/src/main/resources/zh_CN/element/string.json 448 449```json 450{ 451 "string": [ 452 { 453 "name": "greetings", 454 "value": "你好，世界" 455 } 456 ] 457} 458``` 459 460- entry/src/main/resources/en_US/element/string.json 461 462```json 463{ 464 "string": [ 465 { 466 "name": "greetings", 467 "value": "Hello, world" 468 } 469 ] 470} 471``` 472 473- entry/src/main/resources/de_DE/element/string.json 474 475```json 476{ 477 "string": [ 478 { 479 "name": "greetings", 480 "value": "Hallo, Welt" 481 } 482 ] 483} 484``` 485 486在Index.ets中，分别获取三种语言的资源并显示在文本框中，运行设备当前系统语言为中文，entry/src/main/ets/pages/Index.ets的代码如下： 487 488```ts 489@Entry 490@Component 491struct Index { 492 @State englishString: string = "" 493 @State germanString: string = "" 494 495 getString(): string { 496 let resMgr = getContext().resourceManager 497 let resId = $r('app.string.greetings').id 498 499 //获取符合当前系统语言地区、颜色模式、分辨率等配置的资源 500 let currentLanguageString = resMgr.getStringSync(resId) 501 502 //获取符合当前系统颜色模式、分辨率等配置的英文资源 503 let overrideConfig = resMgr.getOverrideConfiguration() 504 overrideConfig.locale = "en_US" //指定资源的语言为英语，地区为美国 505 let overrideResMgr = resMgr.getOverrideResourceManager(overrideConfig) 506 this.englishString = overrideResMgr.getStringSync(resId) 507 508 //获取符合当前系统颜色模式、分辨率等配置的德文资源 509 overrideConfig.locale = "de_DE" //指定资源的语言为德语，地区为德国 510 overrideResMgr.updateOverrideConfiguration(overrideConfig) //等效于resMgr.updateOverrideConfiguration(overrideConfig) 511 this.germanString = overrideResMgr.getStringSync(resId) 512 513 return currentLanguageString 514 } 515 516 build() { 517 Row() { 518 Column() { 519 Text(this.getString()) 520 .fontSize(50) 521 .fontWeight(FontWeight.Bold) 522 Text(this.englishString) 523 .fontSize(50) 524 .fontWeight(FontWeight.Bold) 525 Text(this.germanString) 526 .fontSize(50) 527 .fontWeight(FontWeight.Bold) 528 } 529 .width('100%') 530 } 531 .height('100%') 532 } 533} 534``` 535 536### overlay机制 537 538overlay是一种资源替换机制，针对不同品牌、产品的显示风格，开发者可以在不重新打包业务逻辑hap的情况下，通过配置和使用overlay资源包，实现应用界面风格变换。overlay资源包只包含资源文件、资源索引文件和配置文件。 539 540- 动态overlay使用方式 541 5421、对应的overlay资源包需要放在对应应用安装路径下，通过hdc install的方式安装。如应用com.example.overlay的安装路径：data/app/el1/bundle/public/com.example.overlay/。 543 5442、应用通过[addResource(path)](../reference/apis-localization-kit/js-apis-resource-manager.md#addresource10)，实现资源覆盖；通过[removeResource(path)](../reference/apis-localization-kit/js-apis-resource-manager.md#removeresource10)，实现overlay删除。overlay资源路径需经过元能力的getContext().bundleCodeDir获取此应用对应的沙箱根目录，由应用的沙箱根目录+overlay资源包名称组成。如：let path = getContext().bundleCodeDir + "overlay资源包名称"，其对应沙箱路径为：/data/storage/el1/bundle/overlay资源包名称。 545 546- 静态overlay配置方式 547 548包内overlay资源包中的配置文件app.json5中支持的字段： 549```{ 550 "app":{ 551 "bundleName": "com.example.myapplication.overlay", 552 "vendor" : "example", 553 "versionCode": "1000000", 554 "versionName": "1.0.0.1", 555 "icon": "$media:app_icon", 556 "label": "$string:app_name", 557 } 558} 559``` 560包内overlay资源包中的配置文件module.json5中支持的字段： 561```{ 562 "module":{ 563 "name": "entry_overlay_module_name", 564 "type": "shared", 565 "description": "$string:entry_overlay_desc", 566 "deviceTypes": [ 567 "default", 568 "tablet", 569 ], 570 "deliverywithInstall": true, 571 572 "targetModuleName": "entry_module_name", 573 "targetPriority": 1, 574 } 575} 576``` 577包间overlay资源包中的配置文件app.json5中支持的字段，仅对系统应用开放： 578```{ 579 "app":{ 580 "bundleName": "com.example.myapplication.overlay", 581 "vendor" : "example", 582 "versionCode": "1000000", 583 "versionName": "1.0.0.1", 584 "icon": "$media:app_icon", 585 "label": "$string:app_name", 586 "targetBundleName": "com.example.myapplication", 587 "targetPariority": 1, 588 } 589} 590``` 591包间overlay资源包中的配置文件module.json5中支持的字段，仅对系统应用开放： 592```{ 593 "module":{ 594 "name": "entry_overlay_module_name", 595 "type": "shared", 596 "description": "$string:entry_overlay_desc", 597 "deviceTypes": [ 598 "default", 599 "tablet", 600 ], 601 "deliverywithInstall": true, 602 603 "targetModuleName": "entry_module_name", 604 "targetPriority": 1, 605 } 606} 607``` 608<!--DelEnd--> 609 610> **说明：** 611> - targetBundleName: 字符串类型，指定要overlay的bundleName。 612> 613> - targetModuleName: 字符串类型，指定要overlay的应用中的目标module。 614> 615> - targetPriority： 整数类型，指定overlay优先级。 616> 617> - 不支持Ability、ExtensionAbility、Permission等其他字段的配置。 618> 619> - overlay不支持json类型的图片配置。 620 621在IDE中创建应用工程时，module的配置文件module.json5中包含targetModuleName和targetPriority字段时，该module将会在安装阶段被识别为overlay特征的module。overlay特征的module一般是为设备上存在的非overlay特征的module提供覆盖的资源文件，以便于targetModuleName指向的module在运行阶段可以使用overlay资源文件展示不同的颜色，标签，主题等等。 622 623该功能默认使能，其使能及去使能请参考[包管理接口](../reference/apis-ability-kit/js-apis-overlay.md)。 624 625## 相关实例 626 627针对访问应用资源，有以下相关实例可供参考： 628 629- [资源管理（ArkTS）（API10）](https://gitee.com/openharmony/applications_app_samples/tree/OpenHarmony-5.0.1-Release/code/BasicFeature/Resource/ResourceManager)
