鸿蒙HarmonyOS应用开发之资源文件【鸿蒙专题16】

鸿蒙HarmonyOS应用开发之资源文件

作者：坚果

公众号："大前端之旅"

华为云享专家，InfoQ签约作者，阿里云专家博主，51CTO博客首席体验官，开源项目GVA成员之一，专注于大前端技术的分享，包括Flutter,小程序,安卓，VUE，JavaScript。

resources目录

应用的资源文件（字符串、图片、音频等）统一存放于resources目录下，便于开发者使用和维护。resources目录包括两大类目录，一类为base目录与限定词目录，另一类为rawfile目录，

resources
|---base  // 默认存在的目录
|   |---element
|   |   |---string.json
|   |---media
|   |   |---icon.png
|---en_GB-vertical-car-mdpi // 限定词目录示例，需要开发者自行创建   
|   |---element
|   |   |---string.json
|   |---media
|   |   |---icon.png
|---rawfile  // 默认存在的目录

资源组目录说明

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

资源文件的引用方法

base目录与限定词目录中的资源文件：通过指定资源类型（type）和资源名称（name）来引用。

• Java文件引用资源文件的格式：ResourceTable.type_name。特别地，如果引用的是系统资源，则采用：

  ohos.global.systemres.ResourceTable.type_name

  示例一：在Java文件中，引用string.json

  文件中类型为“String”、名称为“app_name”的资源。

  ohos.global.resource.ResourceManager resManager = this.getResourceManager();
  String result = resManager.getElement(ResourceTable.String_app_name).getString();

  示例二：在Java文件中，引用color.json

  文件中类型为“Color”、名称为“red”的资源。

  ohos.global.resource.ResourceManager resManager = this.getResourceManager();
  String result = resManager.getElement(ResourceTable.String_app_name).getString();

• XML文件引用资源文件的格式：$type:name特别地，如果引用的是系统资源，则采用：

  $ohos:type:name在XML文件中，引用string.json文件中类型为“String”、名称为“app_name”的资源，

  <?xml version="1.0" encoding="utf-8"?>
  <DirectionalLayout xmlns:ohos="http://schemas.huawei.com/res/ohos"
      ohos:width="match_parent"
      ohos:height="match_parent"
      ohos:orientation="vertical">
      <Text ohos:text="$string:app_name"/>
  </DirectionalLayout>

rawfile目录中的资源文件：通过指定文件路径和文件名称来引用。

在Java文件中，引用一个路径为“resources/rawfile/”、名称为“example.js”的资源文件，示例如下：

ohos.global.resource.ResourceManager resManager = this.getResourceManager();
ohos.global.resource.RawFileEntry rawFileEntry = resManager.getRawFileEntry("resources/rawfile/example.js"); 

系统资源文件

目前支持的部分系统资源文件

希望这些对你的鸿蒙开发之路有帮助。