基于原生的跨模块资源访问

2024年 5月 9日 65.7k 0

基于原生的跨模块资源访问-1

想了解更多关于开源的内容,请访问:

51CTO 鸿蒙开发者社区

https://ost.51cto.com

场景一、访问模块内资源

通过"$r"或"$rawfile"引用资源

对于“color”、“float”、“string”、“plural”、“media”、“profile”等类型的资源,通过"$r('app.type.name')"形式引用。其中,app为resources目录中定义的资源;type为资源类型或资源的存放位置;name为资源名,开发者定义资源时确定。

基于原生的跨模块资源访问-2

对于rawfile目录资源,通过"$rawfile('filename')"形式引用。

使用$r进行string资源引用。

Text($r("app.string.mystring"))

在rawfile下的资源可以通过$rawfile+文件名访问。

Image($rawfile("img.jpg"))

场景二、跨HAP/HSP包应用资源

bundle相同,跨module访问

方式一:通过createModuleContext(moduleName)接口创建同应用中不同module的上下文,获取resourceManager对象后,调用不同接口访问不同资源。

getContext(this).createModuleContext(moduleName).resourceManager.getStringByNameSync('app.string.XXX')

方式二:通过"$r"或"$rawfile"引用资源(api12支持的能力)。 1.[hsp].type.name获取资源。其中,hsp为hsp模块名,type为资源类型,name为资源名称。

Text($r('[hsp].string.test_string')) 
  .fontSize($r('[hsp].float.font_size')) 
  .fontColor($r('[hsp].color.font_color')) 
Image($rawfile('[hsp].oneFile/twoFile/icon.png'))

使用变量获取资源。

@Entry 
@Component 
struct Index { 
  text: string = '[hsp].string.test_string'; 
  fontSize: string = '[hsp].float.font_size'; 
  fontColor: string = '[hsp].color.font_color'; 
  image: string = '[hsp].media.string'; 
  rawfile: string = '[hsp].icon.png'; 
   
  build() { 
    Row() { 
      Text($r(this.text)) 
        .fontSize($r(this.fontSize)) 
        .fontColor($r(this.fontColor)) 
       
      Image($r(this.image)) 
       
      Image($rawfile(this.rawfile)) 
    } 
  } 
}

说明:hsp包名必须写在[]内,”rawfile“下有多层目录,需要从”rawfile“下面第一个目录开始写,如“$rawfile('[hsp].oneFile/twoFile/icon.png')”,使用"$r"和"$rawfile"跨包访问HSP包资源无法提供编译时的资源校验,需要开发者自行保证使用资源存在于对应包中。

场景三、HSP包的资源导出引用

创建HSP,新建模块,选择shared library。

基于原生的跨模块资源访问-3

基于原生的跨模块资源访问-4

导出需要使用的资源。

导出ResManager1,以便其他模块获取到hsp中的resource资源。

export class ResManager1{ 
  static getPic(): Resource{ 
    return $r('app.media.11'); 
  } 
  static getDesc(): Resource{ 
    return $r('app.string.shared_desc1'); 
  } 
}

在模块下的index.ets导出资源。

基于原生的跨模块资源访问-5

引用资源。

在引用方模块的oh-package.json5下添加依赖,执行install。

基于原生的跨模块资源访问-6

Import加载并使用。

import {ResManager1}from 'hsp' 
@Entry 
@Component 
struct Index { 
  @State message: string = 'Hello World'; 
   
  build() { 
    Row() { 
      Column() { 
        Text(ResManager1.getDesc()) 
          .fontSize(50) 
          .fontWeight(FontWeight.Bold) 
      } 
      .width('100%') 
    } 
    .height('100%') 
  } 
}

场景四、HAR包的资源导出引用

新建模块,选择static library。

基于原生的跨模块资源访问-7

export使用的资源,并在模块下的index.ets导出。

基于原生的跨模块资源访问-8

build出har包。

基于原生的跨模块资源访问-9

Build完成后会在模块下生成.har文件。

引用har包,在引用方oh-package.json5下添加依赖,依赖需要到.har文件,执行install。

基于原生的跨模块资源访问-10

import 后调用har中的资源。

import {ResManager}from 'har' 
@Entry 
@Component 
struct Index { 
  @State message: string = 'Hello World'; 
   
  build() { 
    Row() { 
      Column() { 
        Image(ResManager.getPic()).width(50) 
          .fontSize(50) 
          .fontWeight(FontWeight.Bold) 
      } 
      .width('100%') 
    } 
    .height('100%') 
  } 
}

其他常见问题:

Q:依赖的多个模块使用过相同资源后,以哪一个模块的资源为准?

A:如果依赖的多个HAR之间有资源冲突,会按照依赖顺序进行覆盖(依赖顺序在前的优先级较高)。

Q:是否可以通过循环变量加载资源?

A:当前支持通过$r("app.string.name" + 1)拼接的方式加载资源(包括变量拼接的形式),跨模块的场景也适用。

想了解更多关于开源的内容,请访问:

51CTO 鸿蒙开发者社区

https://ost.51cto.com

相关文章

JavaScript2024新功能:Object.groupBy、正则表达式v标志
PHP trim 函数对多字节字符的使用和限制
新函数 json_validate() 、randomizer 类扩展…20 个PHP 8.3 新特性全面解析
使用HTMX为WordPress增效:如何在不使用复杂框架的情况下增强平台功能
为React 19做准备:WordPress 6.6用户指南
如何删除WordPress中的所有评论

发布评论