鸿蒙开发:那些常用的资源管理方法

程序员一鸣
• 阅读 12

前言

本文基于Api13

在实际的开发中,我们经常会用到资源管理,比如常见的获取设备类型,获取屏幕方向,获取屏幕密度等等,除此之外,更多是获取资源已经配置好的内容,比如字符串,比如图片,比如数组资源,常见于指定类型不支持资源类型的参数。

正常情况下,我们在resources配置好的资源,是可以直接获取的,比如如下案例:

{
      "name": "test_string",
      "value": "一个简单的测试数据"
    }

那么,在代码中,我们可以直接通过$r()进行获取:

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

我们可以直接这样获取,那是因为,$r()返回的是Resource,而Text组件的内容正好也支持Resource。

$r()源码如下:

/**
 * global $r function
 *
 * @param { string } value
 * @param { any[] } params
 * @returns { Resource }
 * @syscap SystemCapability.ArkUI.ArkUI.Full
 * @crossplatform
 * @form
 * @atomicservice
 * @since 11
 */
declare function $r(value: string, ...params: any[]): Resource;

Text组件源码如下:

/**
    * Called when writing text.
    *
    * @param { string | Resource } content
    * @param { TextOptions } value
    * @returns { TextAttribute }
    * @syscap SystemCapability.ArkUI.ArkUI.Full
    * @crossplatform
    * @form
    * @atomicservice
    * @since 11
    */
   (content?: string | Resource, value?: TextOptions): TextAttribute;

那么问题来了,如果组件不支持Resource呢?显然这种情况下就不能直接使用$r()了;有的友友说了,不支持就不用呗,直接写死它不就行了,哎,直接写死,没有问题,对于自己写的,或者说没有规范的项目,你可以肆无忌惮,但是在规范严格的项目下,写死就会失去了代码复用,在日后更改文字的情况下,成本将会急剧上升,特别是那些国际化的项目,所以,一个统一资源输出的内容,可以有效地避免字符串硬编码,提高代码的可维护性、可读性和国际化能力。

针对不支持Resource类型参数的组件,我们就可以使用资源管理中方法来指定获取,还是上述的代码,我们就可以直接使用getStringSync来获取。

Text(getContext().resourceManager.getStringSync($r("app.string.test_string").id))

需要注意的是,能用$r()获取的就用,不能用的情况下再去使用资源管理,通过排查,绝大部分文本组件都支持$r(),只有一少部分不支持,如:跑马灯组件、搜索Search组件,富文本RichText组件等等。

资源管理除了字符串的获取,还有很多可以获取,比如数组,比如图片等等,所以对于一些常量的属性,我们都可以定义到资源中去,通过资源管理来进行指定的获取,下面就一起看下资源管理中那些常见的方法。

一、使用方式

通过上下文context,我们就可以直接拿到resourceManager,如果你是在UI组件中,可以如下直接获取:

let rManager = getContext().resourceManager

二、获取设备屏幕方向

判断屏幕方向,可以使用direction属性,有两个值分别是0和1,0是竖屏,1是横屏,也可以使用枚举值DIRECTION_VERTICAL和DIRECTION_HORIZONTAL表示,基本代码如下:

let rManager = getContext().resourceManager
    let direction = rManager.getConfigurationSync().direction
    if(direction == resourceManager.Direction.DIRECTION_VERTICAL){
      console.log("===竖屏")
    }else if(direction == resourceManager.Direction.DIRECTION_HORIZONTAL){
      console.log("===横屏")
    }

三、获取设备类型

获取设备类型,可以使用deviceType属性,有七个值可以选择。

鸿蒙开发:那些常用的资源管理方法

基本代码如下:

let rManager = getContext().resourceManager
    let deviceType = rManager.getConfigurationSync().deviceType
    if(deviceType == resourceManager.DeviceType.DEVICE_TYPE_PHONE){
      console.log("===手机")
    }else if(deviceType == resourceManager.DeviceType.DEVICE_TYPE_TABLET){
      console.log("===平板")
    }else if(deviceType == resourceManager.DeviceType.DEVICE_TYPE_CAR){
      console.log("===汽车")
    }else if(deviceType == resourceManager.DeviceType.DEVICE_TYPE_PC){
      console.log("===电脑")
    }else if(deviceType == resourceManager.DeviceType.DEVICE_TYPE_TV){
      console.log("===电视")
    }else if(deviceType == resourceManager.DeviceType.DEVICE_TYPE_WEARABLE){
      console.log("===穿戴")
    }else if(deviceType == resourceManager.DeviceType.DEVICE_TYPE_2IN1){
      console.log("===2IN1")
    }

四、获取设备屏幕密度

屏幕密度,通过screenDensity属性来获取,有6个类型可供选择,从小密度到超特大密度都有,基本代码如下:

let rManager = getContext().resourceManager
    let screenDensity = rManager.getConfigurationSync().screenDensity
    if(screenDensity == resourceManager.ScreenDensity.SCREEN_SDPI){
      console.log("===小规模的屏幕密度")
    }else if(screenDensity == resourceManager.ScreenDensity.SCREEN_MDPI){
      console.log("===中规模的屏幕密度")
    }else if(screenDensity == resourceManager.ScreenDensity.SCREEN_LDPI){
      console.log("===大规模的屏幕密度")
    }else if(screenDensity == resourceManager.ScreenDensity.SCREEN_XLDPI){
      console.log("===特大规模的屏幕密度")
    }else if(screenDensity == resourceManager.ScreenDensity.SCREEN_XXLDPI){
      console.log("===超大规模的屏幕密度")
    }else if(screenDensity == resourceManager.ScreenDensity.SCREEN_XXXLDPI){
      console.log("===超特大规模的屏幕密度")
    }

五、获取颜色模式

颜色模式,通过colorMode进行获取,有两个值,深色模式和浅色模式,也就是0和1代表,同样的,也可以通过枚举值进行判断,DARK和LIGHT来判断。

let rManager = getContext().resourceManager
    let colorMode = rManager.getConfigurationSync().colorMode
    if(colorMode == resourceManager.ColorMode.DARK){
      console.log("===深色模式")
    }else if(colorMode == resourceManager.ColorMode.LIGHT){
      console.log("===浅色模式")
    }

六、获取字符串资源

这个在前言中已经有过案例,可以通过getStringSync方法来获取,支持多种方式,比如只传递Resource,代码如下:

let rManager = getContext().resourceManager
let testString = rManager.getStringSync($r("app.string.test_string"))
console.log("==="+testString)

当然了,也支持获取指定资源ID对应的字符串,也就是和前言中一致,当然了也支持格式化参数。

格式化参数

定义格式化参数:

{
      "name": "test_string",
      "value": "一个简单的%d测试数据"
    }

代码调用如下:

let rManager = getContext().resourceManager
    let testString = rManager.getStringSync($r("app.string.test_string").id,100)
    console.log("==="+testString)

打印如下:

===一个简单的100测试数据

格式化字符串资源参数,支持参数类型:%d、%f、%s、%%、%数字$d、%数字$f、%数字$s。

通过定义name获取

上面的获取方式,需要$r()进行协助获取,还有一种比较简单的方式,直接通过定义的name来获取,那就是通过getStringByNameSync方法获取,同样也支持格式化参数。

let rManager = getContext().resourceManager
let testString = rManager.getStringByNameSync("test_string")
console.log("==="+testString)

通过getStringValue获取

我们也可以通过getStringValue方法来进行获取定义的资源,有两种方式分别是callback异步回调和Promise异步回调,同样也支持资源和资源id两种形式获取。

callback异步回调

let rManager = getContext().resourceManager
    rManager.getStringValue($r("app.string.test_string").id, (err,testString) => {
      console.log("===" + testString)
    })

Promise异步回调

let testString=await rManager.getStringValue($r("app.string.test_string"))
console.log("===" + testString)

通过getStringByName获取

也是有两种获取方式,callback异步回调和Promise异步回调,同样也支持资源和资源id两种形式获取,简单举例如下。

let rManager = getContext().resourceManager
let testString=await rManager.getStringByName("test_string")
console.log("===" + testString)

七、获取字符串数组资源

鸿蒙开发:那些常用的资源管理方法

有四个方法可以获取,分别是getStringArrayValue,getStringArrayByName,getStringArrayValueSync

,getStringArrayValueSync。

getStringArrayValue

getStringArrayValue支持资源和id形式,同样,分别也有两种获取方式callback异步回调和Promise异步回调。

callback异步回调

let rManager = getContext().resourceManager
   rManager.getStringArrayValue($r("app.strarray.test"),(err,data)=>{
      console.log("===" + data)
    })

Promise异步回调

let data= await rManager.getStringArrayValue($r("app.strarray.test"))
console.log("===" + data)

以上的方式,均支持id的形式,这里就不赘述了。

getStringArrayByName

getStringArrayByName支持资源和id形式,同样,分别也有两种获取方式callback异步回调和Promise异步回调。

callback异步回调

let rManager = getContext().resourceManager
    rManager.getStringArrayByName("test", (err, data) => {
      console.log("===" + data)
    })

Promise异步回调

let rManager = getContext().resourceManager
let data= await rManager.getStringArrayByName("test")
console.log("===" + data)

getStringArrayValueSync和getStringArrayValueSync都是同步的方式,同时支持id和资源的形式,基本使用方式如出一辙,就不过多赘述了。

八、获取number资源

number和字符串类似,无非就是方法名字不一样,提供了有两种获取方式,getNumber和getNumberByName,都是用于获取指定资源ID对应的integer数值或者float数值。

鸿蒙开发:那些常用的资源管理方法

getNumber

支持Resource和资源ID两种方式。

let rManager = getContext().resourceManager
let integer_1 = rManager.getNumber($r("app.integer.integer_1"))
console.log("==="+integer_1)

getNumberByName

只支持一种方式,也就是通过定义的name获取。

let rManager = getContext().resourceManager
let integer_1 = rManager.getNumberByName("integer_1")
console.log("==="+integer_1)

九、获取boolean资源

用法和number基本一致。

getBoolean

let rManager = getContext().resourceManager
let boolean_1 = rManager.getBoolean($r("app.boolean.boolean_1"))
console.log("===" + boolean_1)

getBooleanByName

let rManager = getContext().resourceManager
    let boolean_1 = rManager.getBooleanByName("boolean_1")
    console.log("===" + boolean_1)

十、其他资源获取

只要是定义在resources里资源,我们都可以进行获取,比如颜色,音视频,图片等等,都可以通过resourceManager来获取,比如颜色通过getColor、getColorSync、getColorByName、getColorByNameSync来获取,内容太多了,以后有时间再介绍吧。

相关总结

熟练的使用资源管理,可以极大的提高我们的开发效率,不仅仅在一些组件中使用到,更多的是在一些三方的sdk中,由于定义的类型单一,为了项目的可维护,资源管理的使用也是非常的常见的。

点赞
收藏
评论区
推荐文章
凝雪探世界 凝雪探世界
4年前
超详细的 JS 数组方法
数组是js中最常用到的数据集合,其内置的方法有很多,熟练掌握这些方法,可以有效的提高我们的工作效率,同时对我们的代码质量也是有很大影响。一、创建数组1.使用数组字面量表示法var arr4  ;   //创建一个空数组var arr5  20;   // 创建一个包含1项数据为20的数组var arr
Wesley13 Wesley13
3年前
Jar包进行反编译,修改后重新打包
  在学习和开发JAVA项目中,我们经常会用到第三方提供的一些jar。使用这些第三方工具包,可以提高我们开发的效率,缩短开发的时间。有的第三方工具,提供具体的使用说明和源代码,有时有的却不提供源代码,使用说明也不是很具体,这对我们使用就非常不方便。  有道是,知其然才知其所以然。有时候,我们必须读取jar里的打包的类。而有时还有可能要
Easter79 Easter79
3年前
Twitter的分布式自增ID算法snowflake (Java版)
概述分布式系统中,有一些需要使用全局唯一ID的场景,这种时候为了防止ID冲突可以使用36位的UUID,但是UUID有一些缺点,首先他相对比较长,另外UUID一般是无序的。有些时候我们希望能使用一种简单一些的ID,并且希望ID能够按照时间有序生成。而twitter的snowflake解决了这种需求,最初Twitter把存储系统从MySQL迁移
Stella981 Stella981
3年前
Kubernetes 的资源管理
作者:KimWuestkamp翻译:Bach(https://www.oschina.net/action/GoToLink?urlhttps%3A%2F%2Fmp.weixin.qq.com%2Fs%2FNnutG4dDnm2zWY5MDiSGpQ)(才云)校对:bot(https://www.oschina.net
GeorgeGcs GeorgeGcs
13小时前
【HarmonyOS 5】使用openCustomDialog如何禁止手势关闭的方案
鸿蒙开发能力HarmonyOSSDK应用服务鸿蒙金融类应用(金融理财一、前言在HarmonyOS中使用openCustomDialog自定义弹框时,我们会遇到实现禁止手势关闭弹框的业务场景。虽然在HarmonyOSNext中,自定义Dialog默认可能继承
GeorgeGcs GeorgeGcs
12小时前
【HarmonyOS 5】VisionKit人脸活体检测详解
鸿蒙开发能力HarmonyOSSDK应用服务鸿蒙金融类应用(金融理财一、VisionKit人脸活体检测是什么?VisionKit是HamronyOS提供的场景化视觉服务工具包。华为将常见的解决方案,通常需要三方应用使用SDK进行集成。华为以Kit的形式集成
GeorgeGcs GeorgeGcs
12小时前
【HarmonyOS 5】鸿蒙用户头像编辑功能实践
鸿蒙开发能力HarmonyOSSDK应用服务鸿蒙金融类应用(金融理财一、前言1、应用背景在鸿蒙化开发过程中,我们发现最基本常见的功能用户头像的编辑,实现方式和Android与IOS有极大的不同。在实际开发和调研的过程中,我们发现并总结了鸿蒙隐私处理与业内A
飞龙AI 飞龙AI
1个月前
DevEcoStudio 中使用模拟器时如何过滤日志
DevEcoStudio中使用模拟器时如何过滤日志鸿蒙核心技术鸿蒙开发者工具DevEcoStudio在HilogSettingsFilter设置Logmessage:A03d00/JSAPP当你看到不断更新的日志时,你会不会崩溃因为Nofilters模式下
布局王 布局王
22小时前
Uniapp开发鸿蒙应用时如何运行和调试项目
经过前几天的分享,大家应该应该对uniapp开发鸿蒙应用的开发语法有了一定的了解,可以进行一些简单的应用开发,今天分享一下在使用uniapp开发鸿蒙应用时怎么运行到鸿蒙设备,并且在开发中怎么调试程序。运行Uniapp项目支持运行到鸿蒙真机和模拟器,不过在这
GeorgeGcs GeorgeGcs
13小时前
【HarmonyOS 5】鸿蒙组件&模板服务详解 - 助力高效开发的利器
鸿蒙开发能力HarmonyOSSDK应用服务鸿蒙金融类应用(金融理财一、前言在移动应用开发领域,效率与质量始终是开发者追求的核心目标。鸿蒙系统作为新兴的操作系统,为开发者提供了丰富且强大的开发资源,其中鸿蒙组件&模板服务更是成为开发者快速构建高质量应用的得