优化网站排名的方法,最简单网站开发软件,西安市市政建设网站,关键词分为哪几类目录
1 自定义组件混用场景指导
1.1 概述
1.2 状态管理装饰器总览
状态管理V1的装饰器
状态管理V2的装饰器
状态管理装饰器支持的数据类型总览
1.3 限制条件
1.3.1 V1和V2的装饰器不允许混用
1.V1的自定义组件中不可以使用V2的装饰器
2.V2的自定义组件…目录
1 自定义组件混用场景指导
1.1 概述
1.2 状态管理装饰器总览
状态管理V1的装饰器
状态管理V2的装饰器
状态管理装饰器支持的数据类型总览
1.3 限制条件
1.3.1 V1和V2的装饰器不允许混用
1.V1的自定义组件中不可以使用V2的装饰器
2.V2的自定义组件中不可以使用V1的装饰器
3. 多个装饰器不允许装饰同一个变量Watch、Once、Require除外
2 混用场景介绍
2.1 V1和V2类相关装饰器混用
1. V1的自定义组件中使用被ObservedV2装饰的类对象
2. V2的自定义组件中使用被Observed装饰的类对象
2.2 不存在变量传递时V1和V2的自定义组件混用
1. V1中使用V2的自定义组件
2. V2中使用V1的自定义组件
2.3 存在变量传递时V1和V2的自定义组件数据混用
1. V1-V2V1的普通变量传递给V2的自定义组件
2. V1-V2V1的状态变量传递给V2的自定义组件
3. V2-V1V2的普通变量传递给V1的自定义组件
4. V2-V1V2的状态变量传递给V1的自定义组件
2.4 混用场景总结
3 V1-V2迁移指导
3.1 概述
3.2 V1V2使用指引
3.3 迁移指南的目的
3.4 V1V2能力对比及迁移简表
3.5 各装饰器迁移示例
State-Local
Link - Param/Event
Prop - Param
ObjectLink/Observed/Track - ObservedV2/Trace
Provide/Consume - Provider/Consumer
Watch - Monitor
Computed
LocalStorage-全局ObservedV2/Trace
AppStorage-AppStorageV2
Environment-调用Ability接口直接获取系统环境变量
PersistentStorage-PersistenceV2 1 自定义组件混用场景指导
1.1 概述
状态管理V1与V2的混用规则可以概括为 V1的自定义组件中不可以使用V2的装饰器否则编译报错。 组件间不存在变量传递时V1的自定义组件中可以使用V2的自定义组件包括import第三方ComponentV2装饰的自定义组件。 组件间存在变量传递时V1的变量传递给V2的自定义组件有如下限制 V1中未被装饰器装饰的变量后称普通变量V2只能使用Param接收。V1中被装饰器装饰的变量后称状态变量V2存在只能通过Param装饰器接收且仅限于boolean、number、enum、string、undefined、null这些简单类型数据。 V2的自定义组件中不可以使用V1的装饰器否则编译报错。 组件间不存在变量传递时V2自定义组件可以使用V1的自定义组件包括import第三方Component装饰的自定义组件。 组件间存在变量传递时V2的变量传递给V1的自定义组件有如下限制 V2中未被装饰器装饰的变量后称普通变量若V1使用装饰器装饰接收的数据只能通过State、Prop、Provide。V2中被装饰器装饰的变量后称状态变量若V1使用装饰器装饰接收的数据不支持内置类型数据Array、Set、Map、Date。
1.2 状态管理装饰器总览
状态管理V1的装饰器
装饰器类别装饰器组件内装饰器State、Prop、Link、ObjectLink、Provide、Consume、StorageProp、StorageLink、LocalStorageProp、LocalStorageLink、Watch类相关装饰器Observed、Track
状态管理V2的装饰器
装饰器类别装饰器组件内装饰器Local、Param、Provider、Consumer、Once、Event、Monitor、Computed类相关装饰器ObservedV2、Trace、Type
状态管理装饰器支持的数据类型总览
状态管理能够支持的数据类型有
数据类型关键字简单类型数据boolean、number、enum、string、null、undefinedfunction类型function(仅V2的Event、Monitor、Computed支持)Object类型ObjectClass类型Class内置类型Array、Map、Set、Date
1.3 限制条件
1.3.1 V1和V2的装饰器不允许混用
1.V1的自定义组件中不可以使用V2的装饰器 V2的组件内装饰器不允许在V1的自定义组件中使用编译会报错。
Local、Param、EventProvider、Consumer、Monitor、Computed和示例代码中的装饰器表现一致。
2.V2的自定义组件中不可以使用V1的装饰器 V1的组件内装饰器不允许在V2的自定义组件中使用编译会报错。
ObjectLink、Provide、Consume、StorageProp、StorageLink、LocalStorageProp、LocalStorageLink和示例的装饰器表现一致。
3. 多个装饰器不允许装饰同一个变量Watch、Once、Require除外
除了Watch、Once、Require这些能力扩展装饰器可以配合其他装饰器使用外其他装饰器不允许装饰同一个变量。
2 混用场景介绍
2.1 V1和V2类相关装饰器混用
1. V1的自定义组件中使用被ObservedV2装饰的类对象 ObservedV2的使用需要遵循如下规则 ObservedV2只能装饰ClassTrace、Type只能装饰类属性且只能在ObservedV2中使用。Track不可以在ObservedV2中使用。对于被ObservedV2装饰的Class不可以直接被V1的装饰器装饰否则编译时报错。示例中开发者去掉报错的装饰器即可正常运行被Trace装饰的类属性变化时可以观察到变化否则不可以观测到变化。 2. V2的自定义组件中使用被Observed装饰的类对象
不建议开发者在V2中使用Observed装饰的Class因为Observed和Track仅能对类属性做区分无观测能力使用Observed和ObjectLink拆分嵌套数据才能够观测深层次数据但ObjectLink无法在V2的自定义组件中使用。
开发者在对V1的代码向V2迁移时Observed装饰的Class不建议在ComponentV2中使用无观测能力如果一定要使用则遵循以下规则 Observed只能装饰Class,且Trace不可以在Observed中使用。Observed和Track无任何观测能力只能用于防止Class中一个类属性改变而导致整个Class的刷新。继承自Observed的Class被V2装饰器装饰,V2的组件内装饰器无类属性观测能力所以使用Observed会无法观测到类属性变化。示例中开发者去掉报错的装饰器即可正常运行由于无观测能力所以不建议V2中使用Observed。 2.2 不存在变量传递时V1和V2的自定义组件混用
1. V1中使用V2的自定义组件 V1中使用V2的自定义组件当不存在变量传递时无影响若涉及变量传递请见下一节V1和V2的数据混用。
2. V2中使用V1的自定义组件 2中使用V1的自定义组件当不存在变量传递时无影响若涉及变量传递请见下一节V1和V2的数据混用。
2.3 存在变量传递时V1和V2的自定义组件数据混用
1. V1-V2V1的普通变量传递给V2的自定义组件 当V1的普通变量传递给V2的自定义组件时有如下限制 V2的自定义组件必须通过Param接收数据。接收数据的观测能力为Param能力对于接收的Class需要通过ObservedV2和Trace才能观察变化。 2. V1-V2V1的状态变量传递给V2的自定义组件 当V1的状态变量给V2的自定义组件时有如下规则 仅支持简单类型变量其余类型数据会在编译时报错。 示例中使用了State装饰器Prop、Link、ObjectLink、Provide、Consume、StorageProp、StorageLink、LocalStorageProp、LocalStorageLink行为和State保持一致。 3. V2-V1V2的普通变量传递给V1的自定义组件 当V2的普通变量传递给V1自定义组件时 V1可以不使用装饰器接收数据接收过来的变量在V1组定义组件内也会是普通变量。 V1若使用装饰器接收数据仅可通过State、Prop、Provide接收。 4. V2-V1V2的状态变量传递给V1的自定义组件 V2的状态变量传递给V1的自定义组件存在如下限制 V1可以不使用装饰器接收数据接收过来的变量在V1组定义组件内也会是普通变量。 V1若使用装饰器接收数据仅可通过State、Prop、Provide接收。 V1若使用装饰器接收数据不支持内置类型的数据。 2.4 混用场景总结
通过对V1和V2的混用场景详细梳理可以看到当V2的代码混用V1的代码时即V1的组件或者类数据向V2进行传递大部分V1的能力在V2都是被禁止的。而V1的代码去混用V2代码时即V2的组件或者类数据向V1传递做了部分功能开放例如ObservedV2和Trace这也是对V1嵌套类数据的观测能提供的最大的帮助。所以在代码开发时不鼓励开发者使用V1和V2进行混用开发但是对于代码迁移上可以让V1的开发者逐步将代码向V2进行迁移从而稳步替换V1的功能代码并且十分不鼓励开发者在V2的代码架构上混用V1的代码。
3 V1-V2迁移指导
3.1 概述
ArkUI状态管理的主要职责是负责将可观察数据的变化自动同步到UI界面实现数据驱动的UI刷新使开发者能更加够专注于UI界面的实现和设计。
在状态管理框架的演进过程中先后推出了状态管理V1和V2两个版本。V1强调组件层级的状态管理而V2则增强了对数据对象的深度观察与管理能力不再局限于组件层级。通过V2开发者能够更灵活地控制数据和状态实现更高效的UI刷新。具体V1和V2的区别可以参见状态管理概述。
3.2 V1V2使用指引 V2是V1的增强版本为开发者提供更多功能和灵活性。对于新开发的应用建议直接使用V2版本范式来进行开发。对于已经使用V1的应用如果V1的功能和性能已能满足需求则不必立即切换到V2。如果开发者在开发过程中受限于V1不能深度观察等特性则建议开发者尽早规划向V2的迁移以便未来实现平滑过渡和改进。对于需要在现阶段混用V1和V2的场景请参阅混用文档。编译器、工具链、IDE对某些不推荐的误用和混用场景会进行校验虽然开发者可能可以通过特殊手段绕过这些校验但还是强烈建议开发者遵循混用文档的指导避免因双重代理等问题给应用带来不确定性。 3.3 迁移指南的目的
对希望将现有V1应用迁移到V2的开发者提供系统化的模板和指导帮助完成V1到V2的迁移。对希望逐步将V1应用过渡到V2的开发者提供参考结合本迁移文档与混用文档可以帮助开发者实现逐步改造。尚未开始开发应用但已熟悉V1状态管理规则的开发者可以参考本迁移文档及V2各个装饰器和接口的文档开始使用V2进行应用开发。
3.4 V1V2能力对比及迁移简表
V1装饰器名V2装饰器名说明ObservedObservedV2 表明当前对象为可观察对象。但两者能力并不相同。 Observed可观察第一层的属性需要搭配ObjectLink使用才能生效。 ObservedV2本身无观察能力仅代表当前class可被观察如果要观察其属性需要搭配Trace使用。 TrackTrace V1装饰器Track为精确观察不使用则无法做到类属性的精准观察。 V2Trace装饰的属性可以被精确跟踪观察。 ComponentComponentV2 Component为搭配V1状态变量使用的自定义组件装饰器。 ComponentV2为搭配V2状态变量使用的自定义组件装饰器。 State 无外部初始化Local 外部初始化一次ParamOnce State和Local类似都是数据源的概念在不需要外部传入初始化时可直接迁移。如果需要外部传入初始化则可以迁移为ParamOnce详情见State-Local。PropParamProp和Param类似都是自定义组件参数的概念。当输入参数为复杂类型时Prop为深拷贝Param为引用。LinkParamEventLink是框架自己封装实现的双向同步对于V2开发者可以通过ParamEvent自己实现双向同步。ObjectLinkParam直接兼容ObjectLink需要被Observed装饰的class的实例初始化Param没有此限制。ProvideProvider兼容。ConsumeConsumer兼容。WatchMonitor Watch用于监听V1状态变量的变化具有监听状态变量本身和其第一层属性变化的能力。状态变量可观察到的变化会触发其Watch监听事件。 Monitor用于监听V2状态变量的变化搭配Trace使用可有深层监听的能力。状态变量在一次事件中多次变化时仅会以最终的结果判断是否触发Monitor监听事件。 LocalStorage全局ObservedV2Trace兼容。AppStorageAppStorageV2兼容。Environment调用Ability接口获取系统环境变量Environment获取环境变量能力和AppStorage耦合。在V2中可直接调用Ability接口获取系统环境变量。PersistentStoragePersistenceV2PersistentStorage持久化能力和AppStorage耦合PersistenceV2持久化能力可独立使用。
3.5 各装饰器迁移示例
State-Local
迁移规则
在V1中State装饰器用于装饰组件内部的状态变量在V2中提供了Local作为其替代能力但两者在观察能力和初始化规则上存在明显差异。针对不同的使用场景迁移策略如下 简单类型对于简单类型的变量可以直接将State替换为Local。复杂类型V1中的State可以观察复杂对象的第一层属性变化而V2中的Local只能观察对象自身的变化。如果需要追踪对象内部的属性变化可以结合使用ObservedV2和Trace。外部初始化V1中State支持从外部传递初始值但在V2中Local禁止外部初始化。若需要从外部传递初始值可以使用Param和Once装饰器来实现类似的效果。 Link - Param/Event
迁移规则
在V1中Link允许父组件和子组件之间进行双向数据绑定。迁移到V2时可以用Param和Event模拟双向同步。Param实现父到子的单向传递子组件再通过Event回调函数触发父组件的状态更新。
Prop - Param
迁移规则
在V1中Prop装饰器用于从父组件传递参数给子组件这些参数在子组件中可以被直接修改。在V2中Param取代了Prop的作用但Param是只读的子组件不能直接修改参数的值。因此根据场景的不同有几种迁移策略 简单类型对于简单类型的参数可以直接将Prop替换Param。复杂类型如果传递的是复杂对象且需要严格的单向数据绑定可以对对象进行深拷贝防止子组件修改父组件的数据。子组件修改变量如果子组件需要修改传入的参数可以使用Once来允许子组件对在本地修改该变量。但需要注意如果使用了Once则代表当前子组件只会被初始化一次后续并没有父组件到子组件的同步能力。 复杂类型的单向数据传递
在V2中传递复杂类型时如果希望实现严格的单向数据绑定防止子组件修改父组件的数据需要在使用Param传递复杂对象时进行深拷贝以避免传递对象的引用。
子组件修改变量
在V1中子组件可以修改Prop的变量然而在V2中Param是只读的。如果子组件需要修改传入的值可以使用Param和Once允许子组件在本地修改。
ObjectLink/Observed/Track - ObservedV2/Trace
迁移规则
在V1中Observed与ObjectLink装饰器用于观察类对象及其嵌套属性的变化但V1只能直接观察对象的第一层属性。对于嵌套对象的属性必须通过自定义组件和ObjectLink实现观察。此外V1中提供了Track装饰器来实现对属性级别变化的精确控制。
在V2中ObservedV2与Trace结合使用可以高效地实现类对象及其嵌套属性的深度观察省去了对自定义组件的依赖简化了开发流程。同时Trace装饰器还具备精确更新的能力替代了V1中的Track从而实现更高效的UI刷新控制。根据不同的场景有以下迁移策略 嵌套对象的属性观察V1中需要通过自定义组件和ObjectLink观察嵌套属性V2中则可以使用ObservedV2和Trace直接观察嵌套对象简化了代码结构。类属性的精确更新V1中的Track可以用V2中的Trace取代Trace可以同时观察和精确更新属性变化使代码更简洁高效。 嵌套对象属性观察方法
在V1中无法直接观察嵌套对象的属性变化只能观察到第一层属性的变化。必须通过创建自定义组件并使用ObjectLink来实现对嵌套属性的观察。V2中使用ObservedV2和Trace可以直接对嵌套对象的属性进行深度观察减少复杂度。
类属性变化观测
在V1中Observed用于观察类实例及其属性的变化Track则用于对属性级别的变化优化使得只有被Track装饰的属性触发UI更新。在V2中Trace结合了观察和更新属性级别变化的能力搭配ObservedV2实现高效的UI更新。
Provide/Consume - Provider/Consumer
迁移规则
V1的Provide/Consume和V2Provider/Consumer定位和作用大体类似基本可以实现丝滑替换但是有以下细微差距开发者可根据自己代码实现来参考是否需要调整
在V1中Provide和Consume用于父子组件之间的数据共享可以通过alias别名或属性名匹配同时Consume必须依赖父组件的Provide不允许本地初始化。而V2中Provider和Consumer增强了这些特性使数据共享更加灵活。根据不同的场景有以下迁移策略 V1中Provide/Consume在没有指定alias的情况下可以直接使用。V2中Provider/Consumer是标准装饰器且参数可选所以不管有无指定alias后面需要必须跟随“()”。alias和属性名匹配规则V1中Provide和Consume可以通过alias或属性名匹配V2中alias是唯一的匹配key指定alias后只能通过alias匹配。本地初始化支持V1中Consume不允许本地初始化必须依赖父组件V2中Consumer支持本地初始化当找不到对应的Provider时使用本地默认值。从父组件初始化V1中Provide可以直接从父组件初始化V2中Provider不支持外部初始化需用Param和Once接受初始值并赋给 Provider。重载支持V1中Provide默认不支持重载需设置 allowOverrideV2中Provider默认支持重载Consumer会向上查找最近的Provider。 Watch - Monitor
迁移规则
在V1中Watch用于监听状态变量的变化并在变量变化时触发指定回调函数。在V2中Monitor替代了Watch可以更灵活地监听变量的变化并获取变量变化前后的值。具体的迁移策略如下 单变量监听对于简单的场景可以直接用Monitor替换Watch效果一致。多变量监听V1的Watch无法获取变化前的值。在V2中Monitor支持同时监听多个变量并可以访问变量变化前后的状态。 Computed
迁移规则
V1中并没有提供计算属性的概念所以对于UI中的冗余计算并没有办法可以减少重复计算。V2针对该场景提供了Computed装饰器可以帮助开发者减少重复计算。
LocalStorage-全局ObservedV2/Trace
迁移规则
LocalStorage的目的是为了实现页面间的状态变量共享。之所以提供这个能力是因为V1状态变量和View层耦合无法由开发者自主地实现页面间状态变量的共享。
对于状态管理V2状态变量的观察能力内嵌到数据本身不再和View层耦合所以对于状态管理V2不再需要类似LocalStorage的能力可以使用全局ObservedV2/Trace由开发者自己import和export自己实现状态变量的页面间共享。
AppStorage-AppStorageV2
上一小节中对于全局的ObserveV2/Trace的改造并不适合跨Ability的数据共享该场景可以使用AppStorageV2来替换。
Environment-调用Ability接口直接获取系统环境变量
V1中开发者可以通过Environment来获取环境变量但Environment获取的结果无法直接使用需要配合AppStorage才能得到对应环境变量的值。
PersistentStorage-PersistenceV2
V1中PersistentStorage提供了持久化UI数据的能力而V2则提供了更加方便使用的PersistenceV2接口来替代它。 PersistentStorage持久化的触发时机依赖AppStorage的观察能力且与AppStorage耦合开发者无法自主选择写入或读取持久化数据的时机。PersistentStorage使用序列化和反序列化并没有传入类型所以在持久化后会丢失其类型且对象的属性方法不能持久化。 对于PersistenceV2 与PersistenceV2关联的ObservedV2对象其Trace属性的变化会触发整个关联对象的自动持久化。开发者也可以调用PersistenceV2.save和PersistenceV2.connect接口来手动触发持久化写入和读取。
