# 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访问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包资源。