场景一、访问模块内资源
通过" r " 或 " r"或" 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 " 或 " r"或" 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“下面第一个目录开始写,如“ r a w f i l e ( ′ [ h s p ] . o n e F i l e / t w o F i l e / i c o n . p n g ′ ) ”,使用 " rawfile('[hsp].oneFile/twoFile/icon.png')”,使用" rawfile(′[hsp].oneFile/twoFile/icon.png′)”,使用"r"和"$rawfile"跨包访问HSP包资源无法提供编译时的资源校验,需要开发者自行保证使用资源存在于对应包中。
场景三、HSP包的资源导出引用
1.创建HSP,新建模块,选择shared library。
- 导出需要使用的资源
导出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 NEXT)5.0最新学习路线
路线图适合人群:
IT开发人员:想要拓展职业边界
零基础小白:鸿蒙爱好者,希望从0到1学习,增加一项技能。
技术提升/进阶跳槽:发展瓶颈期,提升职场竞争力,快速掌握鸿蒙技术
获取以上完整版高清学习路线,请点击→纯血版全套鸿蒙HarmonyOS学习文档
《鸿蒙 (HarmonyOS)开发入门教学视频》
《鸿蒙生态应用开发V3.0白皮书》
《鸿蒙 (OpenHarmony)开发基础到实战手册》
OpenHarmony北向、南向开发环境搭建
《鸿蒙开发基础》
●ArkTS语言
●安装DevEco Studio
●运用你的第一个ArkTS应用
●ArkUI声明式UI开发
.……
《鸿蒙开发进阶》
●Stage模型入门
●网络管理
●数据管理
●电话服务
●分布式应用开发
●通知与窗口管理
●多媒体技术
●安全技能
●任务管理
●WebGL
●国际化开发
●应用测试
●DFX面向未来设计
●鸿蒙系统移植和裁剪定制
……
《鸿蒙进阶实战》
●ArkTS实践
●UIAbility应用
●网络案例
……