Resource

提供获取应用资源或系统资源信息的接口。应用资源及系统资源的介绍及使用方法可参考资源分类与访问。

说明：

本模块首批接口从API version 7开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。

$r

$r(value: string, ...params: any[]): Resource

获取应用资源或系统资源的信息。$r会在编译期由工具链转换为Resource对象。通过$r访问应用资源或系统资源，可参考资源分类与访问。

卡片能力： 从API version 9开始，该接口支持在ArkTS卡片中使用。

原子化服务API： 从API version 11开始，该接口支持在原子化服务中使用。

系统能力： SystemCapability.ArkUI.ArkUI.Full

参数：

参数名	类型	必填	说明
value	string	是	资源标识符，访问格式为`belonging.type.name`。 belonging：表示该资源为系统资源、应用资源或HSP包资源，可选值为sys、app或[hsp_name]。 type：资源类型，可选值为boolean，color，float，intarray，integer，pattern，plural，strarray，string或media。 name：资源名称，应用资源名称定义在工程resources目录下，系统资源名称获取可参考资源分类与访问。
...params	any[]	否	开发者传入的剩余参数。

返回值：

类型	说明
Resource	资源相关信息，包括应用包名、应用模块名、资源id等。

示例：

@Entry
@Component
struct Page {
  build() {
    Row() {
      Column() {
        Text($r('app.string.app_name'))
      }
      .width('100%')
    }
    .height('100%')
  }
}

访问HSP包的资源示例可参考访问跨HAP/HSP包资源。

$rawfile

$rawfile(value: string): Resource

获取工程rawfile目录下的资源信息。$rawfile会在编译期由工具链转换为Resource对象。通过$rawfile访问应用资源或系统资源，可参考资源分类与访问。

卡片能力： 从API version 9开始，该接口支持在ArkTS卡片中使用。

原子化服务API： 从API version 11开始，该接口支持在原子化服务中使用。

系统能力： SystemCapability.ArkUI.ArkUI.Full

参数：

参数名	类型	必填	说明
value	string	是	rawfile目录下的相对路径。文件名需要包含后缀，路径开头不可以"/"开头。

返回值：

类型	说明
Resource	资源相关信息，包括应用包名、应用模块名、资源id等。

// src/main/resources/rawfile目录下添加startIcon.png。

@Entry
@Component
struct Page {
  build() {
    Row() {
      Column() {
        Image($rawfile("startIcon.png"))
      }
      .width('100%')
    }
    .height('100%')
  }
}

访问HSP包资源示例可参考访问跨HAP/HSP包资源。