一、前言

最近在写状态管理相关的代码，发现 HarmonyOS 的 UIUtils 这个工具类还挺实用的。怎么说呢，它主要解决一些状态管理框架在使用过程中遇到的边界问题。比如代理对象、V1/V2 混用、数据绑定这些场景。

今天顺手整理一下它的几个主要功能，方便以后查。其实，

该系列依旧会带着大家，了解，开阔一些不怎么热门的API。也可能是偷偷被更新的API，也可以是好玩的，藏在官方文档的边边角角~当然也会有一些API，之前是我们辛辛苦苦的手撸代码，现在有一个API能帮我们快速实现的，希望大家能找宝藏。

如果您有任何疑问、对文章写的不满意、发现错误、想吐槽或者有更好的想法，欢迎在评论、私信或邮件中提出。非常🙏

二、UIUtil

状态管理框架在背后做了很多工作，比如给对象加代理、自动追踪变化、触发 UI 更新等等。但有时候需要绕过这些机制，或者在不同版本的状态管理之间做转换。这时候 UIUtils 就派上用场了。

它提供的功能不算多，但每个都挺有针对性的。

三、getTarget：拿到原始对象

这个功能解决什么问题呢？当你把一个普通对象赋值给 @State 或者 @Local 这样的状态变量时框架会把它包装成代理对象。有时候你需要拿到原始对象做比较，或者传给某些不接受代理对象的 API。这时候就需要 getTarget。

class NonObservedClass { name: string = 'Tom';}let nonObservedClass: NonObservedClass = new NonObservedClass;@Entry@Componentstruct Index { @State someClass: NonObservedClass = nonObservedClass;build { Column { // 直接比较是 false，因为 this.someClass 是代理对象 Text // false // 用 getTarget 拿到原始对象。就能比较了 Text === nonObservedClass: ${UIUtils.getTarget === nonObservedClass}`) // true } }}

实际开发中，这种场景其实不算特别常见，但遇到的时候确实能处理问题。比如你要把状态对象序列化，或者传给第三方库，可能就需要先拿到原始对象。

V2 状态管理的限制

在 V2 状态管理中，getTarget 有个限制。按理说，状态管理 V2 装饰器会为装饰的变量生成 getter 和 setter 方法。同时为原有变量名添加 __ob_ 前缀。出于性能考虑，getTarget 接口不会对 V2 装饰器生成的前缀处理一下。

说白了如果你向 getTarget 传入 @ObservedV2 装饰的类对象实例。返回的对象依旧为对象本身，且被 @Trace 装饰的属性名仍有 __ob_ 前缀。

这个前缀不影响对象属性的 getter 和 setter 方法使用。但如果你需要序列化，可能会遇到问题。比如的观点是，