文档开发者中心
我的
|

HarmonyOS 5

使用三方库中的文件时,出现找不到资源错误该如何处理 #鸿蒙场景化案例#

【问题现象】

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

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

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

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

问题代码如下:

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

收起
自动换行
深色代码主题
复制
ohpm install @ohos/zxing

(2)检查工程级oh-package.json5文件,确定三方库已安装成功。

(3)在工程中使用@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'
}

(2)在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%')
  }
}

(3)效果如下图所示,图片已能正常显示。

【总结】

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

  • **单HAP包应用资源:**通过"$r"或"$rawfile"引用资源。
  • **跨HAP/HSP包应用资源:**通过createModuleContext(moduleName)接口创建同应用中不同module的上下文,获取resourceManager对象后,调用不同接口访问不同资源。例如:getContext().createModuleContext(moduleName).resourceManager.getStringByNameSync('app.string.XXX')。
  • **系统资源:**通过"$r('sys.type.resource_id')"的形式引用。
  • **三方库资源:**将三方库在对应模块目录中引入使用后,再通过"$r"引用资源。
点赞
收藏
回复
1
分享
举报
浏览358 发布于2024-11-22 06:15上海
全部评论
最多点赞
最新发布
最早发布
请问,如果第三方的 HAR 包内部通过 ResourceManager 获取包自身的资源,如果是同工程的其他 HAP 模块访问该 HAR 包,可以正常获取资源,可是如果是不同的工程导入了该 HAR 包,就会出现上下文错误的报错,这个如何解决?

1楼回复于2025-03-25 06:33 来自湖北
写回答
新增插入模板功能
一键使用模板,快速填写内容,轻松发帖~
知道了
  • 为了保障您的信息安全,请勿上传您的敏感个人信息(如您的密码等信息)和您的敏感资产信息(如关键源代码、签名私钥、调试安装包、业务日志等信息),且您需自行承担由此产生的信息泄露等安全风险。
  • 如您发布的内容为转载内容,请注明内容来源。

我要发帖子

了解社区公约,与您携手共创和谐专业的开发者社区。