HarmonyOS鸿蒙Next中this.context.resourceManager.getRawFileContentSync后面的路径怎么写？

【背景知识】

[@ohos.resourceManager (资源管理)](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/js-apis-resource-manager)提供资源获取能力。根据当前的Configuration配置，获取最匹配的应用资源或系统资源。resourceManager.getRawFileContentSync获取resources/rawfile目录下对应的rawfile文件内容，使用同步形式返回。

rawfile支持创建多层子目录，子目录名称可以自定义，文件夹内可以自由放置各类资源文件。目录中的资源文件会被直接打包进应用，不经过编译，也不会分配资源ID。通过指定文件路径和文件名访问。

Invalid relative path：根据参数相对路径, 找不到对应的资源。

【问题分析】

使用resourceManager.getRawFileContentSync获取resources/rawfile目录下对应的rawfile文件内容，且出现Invalid relative path报错，说明读rawfile目录下的文件出错。可能原因有：getRawFileContentSync参数路径填写错误或者rawfile目录下面的文件类型分析错误。

【解决方案】

对于rawfile目录下面的文件一般分为两类：

• 资源文件（例如string、color、plural等json文件，通过$rawfile访问，返回Resource类型对象，适用于界面控件绑定资源文件情形等，通常不涉及写操作）：需要注意的是，和其他资源目录下不同的是，需要通过指定文件路径和文件名来访问。
  • 单Hap/hsp包内访问：通过"$rawfile(‘filename’)“形式访问，其中，filename为rawfile目录下文件的相对路径，文件名需要包含后缀，路径开头不可以”/"开头。格式示例如下：

Image($rawfile('media/background.png'))

• 跨Hap/Hsp访问：（由于har包是随模块编译的，直接对应的模块中引用即可，不涉及跨包访问，这里不再赘述。）需要先在entry中oh-package.json5中添加moudle依赖；使用格式为 $rawfile(’[hsp].filename’) ,其中[hsp]为hsp模块名，filename仍为rawfile目录下文件的相对路径。格式示例如下：

$rawfile('[hsp].oneFile/twoFile/icon.png')

其他类型文件（例如，db文件、txt文件等等，原始文件形式保存）：需要用到资源管理模块resourceManager的常见接口：

• 文件内容小的文件，进行访问（以文本文件，举例说明）：

@Entry
@Component
struct Page {
  build() {
    Column() {
      Button("读取文件").onClick(()=>{
        // 获取文件内容
        // 确保在工程目录src/main/resources/rawfile里存在a.pdf文档
        let content: Uint8Array = this.context.resourceManager.getRawFileContentSync('a.pdf');
      })
    }
  }
}

• 文件内容大的文件，进行访问（以数据库db文件，举例说明）：
  1. 先通过getRawFd获取rawfile目录下的文件描述符fd；
  2. 然后，在应用沙箱里创建对应的沙箱文件，获取到对应的文件描述符fd；
  3. 将rawfile目录下的文件通过buffer的方式拷贝到沙箱文件下；
  4. 最后，在应用沙箱下访问对应文件。 详细代码请查看代码示例。

【常见FAQ】

Q：官网对于getRawFd接口官网API说明是访问Hap包目录的下的文件（getContext().resourceManager.getRawFd(‘rawfilepath’)可获取Rawfile所在hap包的descriptor信息），那么如何在entry下获取hsp的rawfile资源？ A：本知识其实已经提到了，对于跨hap/hsp的模块需要createModuleContext接口，先获取对应模块的context，再使用该context调用getRawFdSync获取文件句柄。

import { UIAbility, application, common } from '@kit.AbilityKit';
import { BusinessError } from '@kit.BasicServicesKit';

@Entry
@Component
struct Index {
  build() {
    Row() {
      Column() {
        Button("hello")
          .onClick(async () => {
            let moduleContext: common.Context;
            let context = getContext(this) as common.Context
            application.createModuleContext(context, 'library').then((data: Context) => {
              moduleContext = data;
              let fd = moduleContext.resourceManager.getRawFdSync('startIcon.png')
            }).catch((error: BusinessError) => {
              let code: number = (error as BusinessError).code;
              let message: string = (error as BusinessError).message;
              console.error(`createModuleContext failed, error.code: ${code}, error.message: ${message}`);
            })
        })
      }
    }
  }
}

更多FAQ请查看如何读写rawfile目录下的文件。