【HarmonyOS实战开发】基于原生的跨模块资源访问

场景一、访问模块内资源

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

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

对于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'))

2.使用变量获取资源

@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{(}^{\prime }[hsp].oneFile/twoFile/icon.pn{g}^{\prime })”，使用"$r"和"$rawfile"跨包访问HSP包资源无法提供编译时的资源校验，需要开发者自行保证使用资源存在于对应包中。

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

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

2. 导出需要使用的资源

导出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导出资源。

3.引用资源

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

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包的资源导出引用

1.新建模块，选择static library。

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

3.build出har包。

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

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

5.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)拼接的方式加载资源（包括变量拼接的形式），跨模块的场景也适用。

写在最后

有很多小伙伴不知道学习哪些鸿蒙开发技术？不知道需要重点掌握哪些鸿蒙应用开发知识点？而且学习时频繁踩坑，最终浪费大量时间。所以有一份实用的鸿蒙（HarmonyOS NEXT）文档用来跟着学习是非常有必要的。

希望这一份鸿蒙学习文档能够给大家带来帮助，有需要的小伙伴自行领取，限时开源，先到先得~无套路领取！！

如果你是一名有经验的资深Android移动开发、Java开发、前端开发、对鸿蒙感兴趣以及转行人员，可以直接领取这份资料

请点击→纯血版全套鸿蒙HarmonyOS学习文档

鸿蒙（HarmonyOS NEXT）5.0最新学习路线

路线图适合人群：

IT开发人员：想要拓展职业边界
零基础小白：鸿蒙爱好者，希望从0到1学习，增加一项技能。
技术提升/进阶跳槽：发展瓶颈期，提升职场竞争力，快速掌握鸿蒙技术

获取以上完整版高清学习路线，请点击→纯血版全套鸿蒙HarmonyOS学习文档

《鸿蒙 (HarmonyOS)开发入门教学视频》

《鸿蒙生态应用开发V3.0白皮书》

《鸿蒙 (OpenHarmony)开发基础到实战手册》

OpenHarmony北向、南向开发环境搭建

《鸿蒙开发基础》

●ArkTS语言
●安装DevEco Studio
●运用你的第一个ArkTS应用
●ArkUI声明式UI开发
.……

《鸿蒙开发进阶》

●Stage模型入门
●网络管理
●数据管理
●电话服务
●分布式应用开发
●通知与窗口管理
●多媒体技术
●安全技能
●任务管理
●WebGL
●国际化开发
●应用测试
●DFX面向未来设计
●鸿蒙系统移植和裁剪定制
……

《鸿蒙进阶实战》

●ArkTS实践
●UIAbility应用
●网络案例
……

获取以上完整鸿蒙HarmonyOS学习文档，请点击→纯血版全套鸿蒙HarmonyOS学习文档