qq_32922545的博客

原创 童长老的开源之旅：为鸿蒙生态注入澎湃动力

每个库的诞生，都源于我对开发者痛点的观察与思考，用模块化设计降低技术门槛，看着更多人能快速上手鸿蒙应用开发，便是我最欣慰的事。在三方库中心仓，我的项目能得到众多开发者的青睐与推荐，离不开稳定的性能、详尽的文档和持续的维护。这背后，是我对开源精神的坚守 —— 不仅无偿分享技术成果，更乐于倾听用户反馈，通过持续迭代完善项目，和大家一起构建良性互动的开发社区。我用一行行代码搭建起技术共享的桥梁，盼着开源的力量能在鸿蒙生态的版图上持续生长，为这个年轻的操作系统注入源源不断的创新动能。

原创 harmony-utils之PermissionUtil，授权相关工具类

harmony-utils是一个功能丰富的HarmonyOS工具库，其中PermissionUtil提供了便捷的授权管理功能。该工具类包含多种授权操作方法：requestPermissionsEasy（申请授权，含二次申请）、checkPermissions（校验授权状态）、checkRequestPermissions（校验并申请授权）等。还支持特殊场景的全局开关设置弹框。安装方式为通过ohpm安装@pura/harmony-utils，需在UIAbility的onCreate方法中初始化。该工具库由童长

原创 HarmonyOS应用如何一键置灰

例如，在一些电影、电视剧的宣传 APP 中，为了营造出怀旧、复古或特定的剧情氛围，可能会将界面一键置灰，让用户仿佛置身于特定的时代背景中；值定义为灰度转换的比例，入参1.0则完全转为灰度图像，入参0.0则图像无变化，入参在0.0和1.0之间时，效果呈线性变化。说明：设置小于0.0的值时，按值为0.0处理，设置大于1.0的值时，按值为1.0处理。当 APP 进行维护、升级或出现故障需要暂停使用时，为了向用户明确提示当前 APP 的不可用状态，可能会将界面置灰，并显示相关的维护提示信息。

原创 HarmonyOS入门指南

原创 harmony-utils之PhotoHelper，相册相关工具类

摘要： harmony-utils是一款鸿蒙应用开发工具库，提供丰富的功能模块，其中picker_utils子库包含PhotoHelper等工具类。PhotoHelper支持相册图片/视频选择（单选/多选）、权限申请保存、弹窗授权保存、安全控件保存等功能，简化了媒体文件操作流程。通过简洁的API调用（如select()、save()、showAssetsCreationDialog()等），开发者可快速实现相册访问、文件保存等常见需求，提升开发效率。

原创 harmony-utils之PickerUtil，拍照、文件选择和保存,工具类

摘要： harmony-utils是专为HarmonyOS开发者设计的高效工具库，其中picker_utils子库提供文件操作相关功能。该库封装了相机调用、照片/文件选择与保存等常用功能，包括camera()拍照、selectPhoto()选照片、saveDocument()存文件等实用方法。通过简单API调用即可实现复杂系统交互，如PickerUtil.cameraEasy().then()即可完成拍照并获取结果。开发者只需全局初始化后，即可使用各类便捷方法简化开发流程。该库已在OpenHarmony三方

原创 harmony-utils之ScanUtil，码工具类(扫码、码图生成、图片识码)

harmony-utils是一款高效的鸿蒙工具库，提供了ScanUtil扫码工具类，包含扫码、生成码图、图片识码等功能。主要API包括：startScanForResult调用系统扫码界面，generateBarcode生成二维码图片，decode识别图片中的二维码，decodeImage处理图像数据识码，onPickerScanForResult从相册选择图片识码。该工具库简化了鸿蒙应用开发中的常见功能实现，支持Promise异步调用方式。开发者可通过ohpm安装，需在UIAbility中初始化后使用。项

原创 最受欢迎的三方库之SpinKit

SpinKit是一款适用于OpenHarmony/HarmonyOS的加载动画组件库，提供多种动画类型、可自定义大小和颜色。安装方式简单，通过ohpm即可完成。该库与其他Pura系列工具(harmony-utils、harmony-dialog)配合使用效果更佳。开发者可通过指定spinType选择不同动画效果，支持设置spinSize和spinColor参数。项目采用Apache 2.0开源协议，欢迎提交Issue和PR参与改进。更多详情可访问Gitee或GitHub项目主页。

原创 harmony-dialog 效果预览

harmony-dialog 是一款简单易用的 OpenHarmony 弹窗组件库，支持一行代码快速调用。它提供了16种常用弹窗类型，包括操作确认类（AlertDialog）、提示类（TipsDialog）、选择类（SelectDialog）、输入类（TextInputDialog/TextAreaDialog）、底部面板（BottomSheetDialog）、日期选择（DatePickerDialog）、加载指示器（LoadingDialog/LoadingProgress）以及Toast提示等。每种弹窗

原创 最受欢迎的三方库之harmony-dialog

harmony-dialog是一款简洁高效的OpenHarmony弹窗组件库，提供12种常见弹窗类型（如AlertDialog、BottomSheetDialog、LoadingDialog等），仅需一行代码即可调用。通过DialogHelper类提供22个API方法，支持弹窗显示/关闭/更新、动画效果和统一样式配置。特别针对子窗口场景提供了UIContext初始化方案，并支持丰富的自定义配置（圆角、蒙层、按钮样式等）。安装方式为ohpm i @pura/harmony-dialog，配套工具库包括harm

原创 最受欢迎的三方库之harmony-utils

摘要： harmony-utils 是一个专为HarmonyOS开发者设计的高效工具库，提供50+实用工具类（如APP、设备、屏幕、授权、文件等操作），体积仅130KB。该库从1.3.2版本起保证API稳定性，需在UIAbility的onCreate中初始化AppUtil.init()。包含AppUtil、DeviceUtil等核心模块，支持ohpm安装（@pura/harmony-utils）。配套子库picker_utils提供PickerUtil等专门功能。

原创 harmony-utils之SM4，SM4加解密

SM4是中国自主研发的商用对称加密算法，由国家密码管理局于2006年发布，2012年成为国家密码行业标准（GM/T 0002-2012）。该算法采用128位分组长度和128位密钥长度，通过32轮非线性迭代结构实现数据加密，安全强度与AES-128相当。其核心设计包含S盒替换、循环移位等操作，支持ECB、CBC等标准工作模式。作为中国密码体系（SM系列）的核心组件，SM4广泛应用于金融支付、电子政务、物联网等领域，满足国产密码合规要求。

原创 harmony-utils之SM3，SM3加解密

SM3是中国国家密码管理局2010年发布的商用密码杂凑算法标准（GM/T 0004-2012），输出256位固定长度哈希值，安全强度与SHA-256相当。该算法采用Merkle-Damgard结构设计，通过消息填充、分组扩展及32轮迭代压缩实现数据混淆，具备抗碰撞攻击和原像攻击能力。作为国产密码体系核心组件，SM3广泛应用于数字签名、电子认证、金融支付及物联网安全等领域，并已纳入ISO/IEC 10118-3国际标准。其高效性适配普通计算机与嵌入式设备，支撑了30余项国内密码行业标准的制定。

原创 harmony-utils之SM2，SM2加解密

SM2是由中国国家密码管理局于2010年发布的椭圆曲线公钥密码算法，属于我国商用密码体系的核心组成部分。该算法基于椭圆曲线密码学（ECC），采用256位密钥长度，在安全性上等同RSA-3072，但具有更高的运算效率和更低的计算资源消耗。作为非对称算法，SM2支持‌数字签名‌、‌密钥交换‌和‌公钥加密‌三大功能，其安全性依赖于椭圆曲线离散对数问题的难解性，可抵御暴力破解和量子计算威胁。

原创 harmony-utils之SHA，SHA工具类

SHA（Secure Hash Algorithm）是由美国国家标准技术研究院（NIST）发布的密码散列函数家族，用于生成数据的唯一性摘要。其核心版本包括：SHA-1：160位摘要，曾广泛用于SSL/TLS和文件校验，但因碰撞漏洞（2017年实际攻击案例）已被淘汰。SHA-2：（含SHA-256/384/512）：采用分块压缩结构，抗碰撞性强，现为区块链（如比特币）和数字证书的主流选择。SHA-3：基于海绵结构的新一代算法，设计上区别于SHA-2，具备抗量子计算潜力。

原创 harmony-utils之MD5，MD5工具类

MD5（Message-Digest Algorithm 5）是由Ronald Rivest于1991年设计的密码散列函数，可将任意长度数据生成128位（16字节）的固定长度哈希值。其核心通过‌填充-分块-循环压缩‌流程实现：先对输入补位至512位倍数，再分块进行4轮非线性运算（每轮16次操作），最终输出唯一性摘要。该算法曾广泛用于文件完整性校验（如软件包校验）、密码存储及数字证书签名。

原创 harmony-utils之RSA，RSA加解密

RSA是1977年提出的非对称加密算法，基于大数分解难题设计，密钥分为公钥(e,n)和私钥(d,n)，其中n为两质数乘积，d是e的模逆元。加密时将明文m通过c=m^e mod n生成密文，解密则用m=c^d mod n。其安全性依赖分解大数n的计算复杂度，常用于HTTPS密钥传输、数字签名等场景。但因计算效率低，不适合加密大量数据，且1024位密钥已可被量子计算威胁，现推荐2048位以上密钥，是公钥加密体系的开创性算法。

原创 harmony-utils之DES，DES加解密

本文介绍了harmony-utils工具库中的DES加密功能。harmony-utils是鸿蒙应用开发的实用工具库，提供加解密、文件操作等丰富功能。DES作为经典对称加密算法，采用56位密钥和Feistel结构，但存在安全缺陷。文章详细演示了如何使用该库实现DES加解密：包括生成密钥、ECB/CBC模式加密解密等核心操作，支持同步/异步调用方式。示例代码展示了从字符串到DataBlob的转换、密钥处理等关键步骤，帮助开发者快速集成DES加密功能到鸿蒙应用中。

原创 harmony-utils之ECDSA，ECDSA工具类

ECDSA（椭圆曲线数字签名算法）是基于椭圆曲线密码学的数字签名方案，核心通过椭圆曲线离散对数问题的难解性保障安全。其原理为：选定椭圆曲线参数后，生成私钥 (d) 与公钥 (Q = d times G)（(G) 为曲线基点）；签名时结合消息哈希值与随机数计算签名对 ((r, s))，验证时通过公钥与签名还原点坐标并比对。

原创 harmony-utils之AES，AES加解密

AES（高级加密标准）是 NIST 于 2001 年发布的对称分组加密算法，用以替代 DES。它支持 128/192/256 位密钥，对应 10/12/14 轮加密，分组长度固定为 128 位。算法通过密钥扩展生成多轮子密钥，加密流程含字节替换、行移位、列混淆（末轮省略）和轮密钥加等操作，利用 S 盒非线性变换与矩阵运算实现混淆扩散，抵御差分分析等攻击。其优势在于对称加密效率高、密钥灵活性强，且硬件友好（如 AES - NI 指令集加速），广泛应用于 HTTPS、硬盘加密等场景，是当前主流安全加密标准。

原创 harmony-utils之Base64Util，Base64工具类

Base64是一种基于64个可打印字符（A-Z、a-z、0-9、+、/，部分场景以-、_替代）的二进制编码方案，核心功能是将非文本数据转化为文本形式传输，有效规避字符集差异导致的传输错误。作为非加密技术，Base64凭借文本化传输的天然优势，成为数据处理与跨系统交互的基础工具，在“二进制转文本”场景中具有不可替代性。其核心价值在于构建数据转换的桥梁——尽管编码后数据体积会增加约33%，却能完美兼容跨系统、跨协议的传输需求。

原创 harmony-utils之WindowUtil，窗口相关工具类

Harmony-utils窗口工具类WindowUtil简介 WindowUtil是harmony-utils工具库中用于管理窗口属性的工具类，提供了丰富的窗口控制功能。该工具类支持设置窗口方向（LANDSCAPE/PORTRAIT）、隐私模式（禁止截屏录屏）、沉浸式布局、系统栏属性、屏幕常亮、亮度调节、焦点控制和触摸控制等。开发者可以轻松调用这些API实现对窗口的各种定制化需求，如setWindowPrivacyMode()设置隐私模式、setWindowBrightness()调节屏幕亮度等。Windo

原创 harmony-utils之WantUtil，Want工具类

摘要：harmony-utils是一款功能丰富的HarmonyOS工具库，其中WantUtil工具类提供了多种系统跳转功能，包括跳转系统设置页面、应用设置、通知设置、网络设置等，还支持拉起浏览器、应用市场、文件管理器等操作。该工具库安装简单，在UIAbility中初始化后即可使用，能显著提升开发效率。开源地址和文档链接已提供，建议开发者收藏使用。

原创 harmony-utils之TypeUtil，类型检查工具类

harmony-utils是一个为鸿蒙应用开发提供丰富工具类的库，包含TypeUtil等众多实用工具。TypeUtil提供了多种类型检查方法，如判断Boolean、Number、String、Object、Array、Resource等类型，以及Map、Set、Date、Promise等特殊类型。该库还包含其他实用工具如设备管理、UI交互、文件操作等模块，可通过ohpm安装。开发者需要在UIAbility中初始化后使用。项目已开源，支持OpenHarmony生态建设。

原创 harmony-utils之ToastUtil，吐司工具类

摘要：harmony-utils是鸿蒙应用开发的实用工具库，其中ToastUtil提供吐司提示功能。支持设置默认样式（对齐方式、背景色等），提供showToast（默认2秒）、showShort（1.5秒）和showLong（10秒）三种显示时长方法，可自定义样式参数。该工具库还包含其他丰富功能，安装简单，初始化后在UIAbility中配置即可使用。开发者可通过GitHub、Gitee或OpenHarmony三方库平台获取。

原创 harmony-utils之TempUtil，温度转换工具类

摘要：harmony-utils是一款为HarmonyOS开发者设计的工具库，提供丰富的实用功能，其中TempUtil是温度转换工具类。它支持摄氏度、华氏度和开尔文之间的相互转换，包括C2F、F2C、C2K、K2C、F2K和K2F等方法。开发者可通过简单调用实现温度单位转换，如TempUtil.C2F(27.5)将摄氏度转为华氏度。该工具库安装简便，是鸿蒙应用开发的有力辅助工具。

原创 harmony-utils之StrUtil，字符串工具类

harmony-utils是一款功能丰富的HarmonyOS工具库，其中StrUtil字符串工具类提供了多种实用方法。包括字符串空值判断（isNull/isNotNull）、空白符处理（trim/trimAll）、字符串替换（replace/replaceAll）、大小写转换（toLower/toUpper）、格式转换（strToBase64/base64ToStr）等操作。此外还支持字符串与Uint8Array、ArrayBuffer等数据结构的相互转换。该工具类简单易用，能有效提升鸿蒙应用开发效率，可通

原创 harmony-utils之SnapshotUtil，截图相关工具类

摘要：harmony-utils是一个功能丰富的HarmonyOS工具库，其中的SnapshotUtil提供截图相关功能。该工具类支持通过组件ID获取截图、后台渲染自定义组件生成截图、窗口截图以及系统截屏事件监听等操作。开发者可通过ohpm安装该库，并在UIAbility中初始化后使用其多样化功能。SnapshotUtil提供了get/createFromBuilder/snapshot等API方法，支持异步回调与同步操作，适用于多种截图场景需求。

原创 harmony-utils之ResUtil，资源相关工具类

摘要 harmony-utils是一款专为鸿蒙应用开发者设计的工具库，提供资源管理、UI组件、设备交互等实用功能。核心子库picker_utils包含Picker、拍照和扫码工具。本文重点介绍了ResUtil工具类，它提供了丰富的资源操作方法：获取资源管理器、读取布尔/数值/字符串/颜色值、处理复数形式字符串、获取媒体文件内容和Base64编码、管理rawfile文件等。这些API既支持同步也支持异步调用，简化了鸿蒙应用的资源管理流程。开发者可通过ohpm安装使用，并在UIAbility中初始化。

原创 harmony-utils之RegexUtil，正则工具类

harmony-utils是一款功能丰富的HarmonyOS工具库，提供多种实用工具类帮助开发者快速构建鸿蒙应用。其中RandomUtil工具类包含多种随机生成方法，如生成随机布尔值、整数、汉字、字符串、颜色、UUID等，支持指定范围和格式。该库可通过ohpm安装，需要在UIAbility中初始化使用。作者提供了GitHub、Gitee和OpenHarmony三方库地址，鼓励开发者使用并给予支持。

原创 harmony-utils之RandomUtil，随机工具类

harmony-utils是一款功能丰富的HarmonyOS工具库，提供多种实用工具类帮助开发者快速构建鸿蒙应用。其中RandomUtil工具类包含多种随机生成方法，如生成随机布尔值、整数、汉字、字符串、颜色、UUID等，支持指定范围和格式。该库可通过ohpm安装，需要在UIAbility中初始化使用。作者提供了GitHub、Gitee和OpenHarmony三方库地址，鼓励开发者使用并给予支持。

原创 harmony-utils之PreferencesUtil，首选项工具类

harmony-utils是一款为HarmonyOS开发者提供的多功能工具库，其中PreferencesUtil模块封装了用户首选项操作。该工具类提供了初始化、数据存取（支持同步/异步）、类型转换、数据监听等完整功能，包括put/get系列方法、订阅变更、精确监听等特性。使用时需先初始化并指定存储实例名称，支持键值对存储、类型安全访问和批量操作。该库简化了鸿蒙应用开发中的数据持久化处理，可显著提升开发效率。开发者可通过OHPM安装使用，更多功能可参考GitHub或Gitee项目仓库。

原创 harmony-utils之NumberUtil，Number工具类

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

原创 harmony-utils之PreviewUtil，文件预览工具类

harmony-utils是一款鸿蒙应用开发工具库，其中PermissionUtil模块提供完善的权限管理功能。该模块包含requestPermissionsEasy（申请授权并二次确认）、checkPermissions（校验授权状态）、requestPermissionOnSetting（二次申请授权）等多个方法，支持相机、定位等常见权限的申请与管理。通过简洁的API调用即可实现权限检测、申请和用户引导流程。该工具库已发布在OpenHarmony三方库平台，安装便捷，可大幅提升鸿蒙应用开发效率。

原创 harmony-utils之PasteboardUtil，剪贴板工具类

harmony-utils是OpenHarmony/HarmonyOS开发工具库，提供丰富实用工具类。其中PasteboardUtil剪贴板工具类封装了系统剪贴板操作，支持读写纯文本、HTML、URI、Want对象和PixelMap图像数据，包含权限申请、数据判断、内容清空等功能。开发者可通过简单API快速实现剪贴板操作，如setDataText()设置文本、getDataEasy()智能获取内容等。该工具库简化了鸿蒙应用开发流程，提升开发效率，适用于各类应用场景。开源地址和文档详见GitHub/Gitee

原创 harmony-utils之ObjectUtil，对象工具类

harmony-utils是一款为HarmonyOS开发者提供的多功能工具库，包含ObjectUtil等实用工具类。ObjectUtil提供对象处理相关方法：获取对象hash值、类名和方法名；判断对象类型和空值；实现浅拷贝、深拷贝和对象合并；处理Record类型数据；动态获取/设置对象属性值等。该工具库还涵盖设备、UI、文件、加密等开发常用功能，通过简单安装即可快速集成到鸿蒙应用中，帮助开发者提升效率。项目已在GitHub、Gitee和OpenHarmony三方库平台开源。

原创 harmony-utils之NotificationUtil，通知工具类

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

原创 harmony-utils之NetworkUtil，网络相关工具类

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

原创 harmony-utils之LRUCacheUtil，LRUCache缓存工具类

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

原创 harmony-utils之LogUtil，日志工具类

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