HarmonyOS鸿蒙Next中使用三方库中的文件时，出现找不到资源错误该如何处理

【问题现象】

导入一个三方库，库里有资源文件。单独的三方库能正常运行，但是被导入工程后，引用资源文件失败。

预期效果： 导入三方库后，能成功使用三方库中的资源文件。

实际效果： 导入三方库后，使用库中资源文件报错。

本文将以导入@ohos/zxing": '2.1.0'中的scan_back图片为例。

问题代码如下：

1. 工程内终端上安装@ohos/zxing。

ohpm install @ohos/zxing

1. 检查工程级oh-package.json5文件，确定三方库已安装成功。

1. 在工程中使用@ohos/zxing的scan_back图片资源，发现资源报未知资源错误。

@Entry
@Component
struct Index {
  build() {
    Column() {
      Image($r("app.media.scan_back")).width(100).height(100).backgroundColor(Color.Black)
    }
    .height('100%')
    .width('100%')
  }
}

【背景知识】

• 添加依赖项：应用/服务支持通过包管理工具ohpm来安装、共享、分发代码，管理项目的依赖关系。
• 三方库的使用：常用的三方库可以分为UI、动画、网络、图片、多媒体、数据存储、安全、工具等；使用方式请见链接。

【定位思路】

对于不同资源，有不同的导入方式，当前资源为三方库资源，因此得从三方库的导入方式来排查问题：

• 模块内引用： 模块只会查找自己模块内的资源，因此导入三方库的位置应该放入模块的oh-package.json5文件中，不需要放在工程级oh-package.json5文件中。
• 工程内引用： 在工程级别目录下导入三方库，若需要对应模块能使用该库，则需在三方库中暴露对应资源，再在模块中import使用。

【解决方案】

按照定位思路进行排查，确定是模块内三方库导入问题，下文将给出模块内三方库引用方式。

1. 在 entry的oh-package.json引入@ohos/zxing。注意不要进行全局引入： ohpm install @ohos/zxing。

"dependencies": {
  "@ohos/zxing": '2.1.0'
}

1. 在entry模块的Index.ets文件中直接引入图片Image($r("app.media.scan_back"))。

@Entry
@Component
struct Index {
  build() {
    Column() {
      Image($r("app.media.scan_back")).width(100).height(100).backgroundColor(Color.Black)
    }
    .height('100%')
    .width('100%')
  }
}

1. 效果如下图所示，图片已能正常显示。

【总结】

导入资源通常有下面几种方式：

• 单HAP包应用资源： 通过$r或$rawfile引用资源。
• 跨HAP/HSP包应用资源： 通过createModuleContext(moduleName)接口创建同应用中不同module的上下文，获取resourceManager对象后，调用不同接口访问不同资源。例如：getContext().createModuleContext(moduleName).resourceManager.getStringByNameSync('app.string.XXX')。
• 系统资源： 通过$r('sys.type.resource_id')的形式引用。
• 三方库资源： 将三方库在对应模块目录中引入使用后，再通过$r引用资源。