写点什么

harmony-utils 之 ResUtil,资源相关工具类

  • 2025-06-26
    安徽
  • 本文字数:2772 字

    阅读完需:约 9 分钟

harmony-utils 之 ResUtil,资源相关工具类

harmony-utils 简介与说明



harmony-utils 一款功能丰富且极易上手的 HarmonyOS 工具库,借助众多实用工具类,致力于助力开发者迅速构建鸿蒙应用。其封装的工具涵盖了 APP、设备、屏幕、授权、通知、线程间通信、弹框、吐司、生物认证、用户首选项、拍照、相册、扫码、文件、日志,异常捕获、字符、字符串、数字、集合、日期、随机、base64、加密、解密、JSON 等一系列的功能和操作,能够满足各种不同的开发需求。


picker_utils 是 harmony-utils 拆分出来的一个子库,包含 PickerUtil、PhotoHelper、ScanUtil。


下载安装


ohpm i @pura/harmony-utils


ohpm i @pura/picker_utils


  //全局初始化方法,在UIAbility的onCreate方法中初始化 AppUtil.init()a  onCreate(want: Want, launchParam: AbilityConstant.LaunchParam): void {    AppUtil.init(this.context);  }
复制代码

API 方法与使用


getResourceManager 获取提供访问应用资源的能力
let resourceManager = ResUtil.getResourceManager();
复制代码
getBoolean 获取指定资源对应的布尔结果
let b1 = ResUtil.getBoolean($r('app.boolean.bl_debug'));let b2 = ResUtil.getBoolean($r('app.boolean.bl_debug').id);
复制代码
getBooleanByName 获取指定资源名称对应的布尔结果
 let b4 = ResUtil.getBooleanByName('bl_agree');
复制代码
getNumber 获取指定资源对应的 integer 数值或者 float 数值
let num1 = ResUtil.getNumber($r('app.integer.count'));let num2 = ResUtil.getNumber($r('app.integer.age').id);
复制代码
getNumberByName 获取指定资源名称对应的 integer 数值或者 float 数值
let num3 = ResUtil.getNumberByName('count');
复制代码
getStringValue 获取指定资源对应的字符串
let str3 = await ResUtil.getStringValue($r('app.string.app_name'));
复制代码
getStringSync 获取指定资源名称对应的字符串
let str1 = ResUtil.getStringSync($r('app.string.str_desc'));let str2 = ResUtil.getStringSync($r('app.string.module_desc').id);
复制代码
getStringByName 获取指定资源名称对应的字符串
let str5 = ResUtil.getStringByNameSync('module_desc');let str6 = await ResUtil.getStringByName('app_name');
复制代码
getStringArrayValue 获取指定资源对应的字符串数组
let strArray1 = ResUtil.getStringArrayValueSync($r('app.strarray.font_size'));let strArray2 = await ResUtil.getStringArrayValue($r('app.strarray.font_size').id);
复制代码
getStringArrayByName 获取指定资源名称对应的字符串数组
let strArray3 = ResUtil.getStringArrayByNameSync("font_size");let strArray4 = await ResUtil.getStringArrayByName("font_size");
复制代码
getPluralStringValue 根据指定数量获取指定 resource 对象表示的单复数字符串
let str1 = ResUtil.getPluralStringValueSync($r('app.plural.eat_apple'), 1);let str2 = await ResUtil.getPluralStringValue($r('app.plural.eat_apple'), 2);
复制代码
getPluralStringByName 根据指定数量获取指定资源名称表示的单复数字符串
let str3 = ResUtil.getPluralStringByNameSync("eat_apple", 11);let str4 = await ResUtil.getPluralStringByName("eat_apple", 0);
复制代码
getColor 获取指定资源对应的颜色值(十进制)
let color1 = ResUtil.getColorSync($r('app.color.color_main'));let color2 = await ResUtil.getColor($r('app.color.color_99'));
复制代码
getColorByName 获取指定资源名称对应的颜色值(十进制)
let color3 = ResUtil.getColorByNameSync("color_main");let color4 = await ResUtil.getColorByName("color_99");
复制代码
getMediaContent 获取指定资源对应的默认或指定的屏幕密度媒体文件内容
let uint8Array1 = ResUtil.getMediaContentSync($r('app.media.test_as1'));let uint8Array2 = await ResUtil.getMediaContent($r('app.media.test_as4'));
复制代码
getMediaByName 获取指定资源名称对应的默认或指定的屏幕密度媒体文件内容
let uint8Array3 = ResUtil.getMediaByNameSync("test_as2");let uint8Array4 = await ResUtil.getMediaByName("test_as5");
复制代码
getMediaContentBase64 获取指定资源 ID 对应的默认或指定的屏幕密度图片资源 Base64 编码
let str1 = ResUtil.getMediaContentBase64Sync($r('app.media.test_as1'));let str2 = await ResUtil.getMediaContentBase64($r('app.media.test_as4'));
复制代码
getMediaBase64ByName 获取指定资源名称对应的默认或指定的屏幕密度图片资源 Base64 编码
let str3 = ResUtil.getMediaBase64ByNameSync("test_as2");let str4 = await ResUtil.getMediaBase64ByName("test_as5");
复制代码
getRawFileContent 获取 resources/rawfile 目录下对应的 rawfile 文件内容
let uint8Array1 = ResUtil.getRawFileContentSync('demo/demo.txt');let uint8Array2 = await ResUtil.getRawFileContent('data_utils.json');
复制代码
getRawFileContentStr 获取 resources/rawfile 目录下对应的 rawfile 文件内容(字符串)
let str3 = ResUtil.getRawFileContentStrSync("demo/demo.txt");let str4 = await ResUtil.getRawFileContentStr("demo/test.txt");
复制代码
getRawFileList 获取 resources/rawfile 目录下文件夹及文件列表(若文件夹中无文件,则不返回;若文件夹中有文件,则返回文件夹及文件列表)
let list1 = ResUtil.getRawFileListSync('demo');let list2 = await ResUtil.getRawFileList("");
复制代码
getRawFd 用户获取 resources/rawfile 目录下对应 rawfile 文件所在 hap 的 descriptor 信息
 let rawFileDescriptor = await ResUtil.getRawFd("test.txt");
复制代码
closeRawFd 用户关闭 resources/rawfile 目录下 rawfile 文件所在 hap 的 descriptor 信息
ResUtil.closeRawFd("test.txt");
复制代码
addResource 应用运行时,加载指定的资源路径,实现资源覆盖
let path = AppUtil.getContext().bundleCodeDir + "/library-default-signed.hsp";ResUtil.addResource(path);
复制代码
removeResource 用户运行时,移除指定的资源路径,还原被覆盖前的资源
let path = AppUtil.getContext().bundleCodeDir + "/library-default-signed.hsp";ResUtil.removeResource(path);
复制代码
isRawDir 用户判断指定路径是否是 rawfile 下的目录(true:表示是 rawfile 下的目录,false:表示不是 rawfile 下的目录)
let isRawDir = ResUtil.isRawDir("demo");let isRawDir2 = ResUtil.isRawDir("test.txt");
复制代码
getConfiguration 获取设备的 Configuration
 let configuration = ResUtil.getConfigurationSync();
复制代码
getDeviceCapability 获取设备的 DeviceCapability
let deviceCapability = ResUtil.getDeviceCapabilitySync();
复制代码

创作不易,请给童长老点赞👍



https://github.com/787107497/harmony-utils


https://gitee.com/tongyuyan/harmony-utils


OpenHarmony三方库


童长老CSDN博客

用户头像

还未添加个人签名 2025-05-14 加入

还未添加个人简介

评论

发布
暂无评论
harmony-utils之ResUtil,资源相关工具类_HarmonyOS_桃花镇童长老_InfoQ写作社区