鸿蒙开发：那些常用的资源管理方法-阿里云开发者社区

前言

本文基于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来获取，内容太多了，以后有时间再介绍吧。

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

前言

一、使用方式

二、获取设备屏幕方向

三、获取设备类型

四、获取设备屏幕密度

五、获取颜色模式

六、获取字符串资源

格式化参数

通过定义name获取

通过getStringValue获取

通过getStringByName获取

七、获取字符串数组资源

getStringArrayValue

getStringArrayByName

八、获取number资源

getNumber

getNumberByName

九、获取boolean资源

getBoolean

getBooleanByName

十、其他资源获取

相关总结

热门文章

最新文章

相关课程

相关电子书

探索云世界

热门

云计算

大数据

云原生

人工智能

数据库

开发与运维

活动广场

任务中心

训练营

直播

乘风者计划

下载

镜像站

技术资料

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

前言

一、使用方式

二、获取设备屏幕方向

三、获取设备类型

四、获取设备屏幕密度

五、获取颜色模式

六、获取字符串资源

格式化参数

通过定义name获取

通过getStringValue获取

通过getStringByName获取

七、获取字符串数组资源

getStringArrayValue

getStringArrayByName

八、获取number资源

getNumber

getNumberByName

九、获取boolean资源

getBoolean

getBooleanByName

十、其他资源获取

相关总结

热门文章

最新文章

相关课程

相关电子书