用途:在编辑或新建 .ets 文件、讨论 ArkTS/ArkUI/HarmonyOS NEXT 组件写法、生命周期、状态管理、样式布局、事件处理、错误处理与测试,或要求按最佳实践编写、审查、重构 ArkTS 代码时,作为规范依据。
主要能力:统一状态管理版本,优先用 V2 实现 ViewModel,常用装饰器包括 @Local、@Param、@Event、@ObservedV2、@Trace;统一组件装饰器与状态管理用法(@Entry、@Component、@State、@Prop、@Link、@Provide/@Consume 等按数据流语义选用);规范生命周期,在 aboutToAppear/aboutToDisappear/onPageShow/onPageHide 中初始化与清理资源;统一样式布局链式调用顺序(尺寸→布局→背景→边框→文本→对齐→交互)与 vp/fp/百分比单位;约束事件处理,用箭头函数与私有方法封装复杂逻辑;强化类型与空值安全,禁止隐式 any/unknown,用 interface/泛型约束数据结构,对可空字段用可选链或显式判空;性能优化涵盖对象缓存与对象池、LazyForEach+IDataSource、@Reusable、@Builder、状态拆分、TaskPool/Worker 异步、内存与资源释放、动态 import 与骨架屏、包体积分析;规范错误处理与 hilog 日志、@ohos/hypium 单元测试及提交前代码审查清单。
使用方式:代理生成或修改 ArkTS 代码时对照规范自动修正装饰器、生命周期清理与样式顺序,优先输出符合规范的示例,对不规范示例先指出问题再给推荐写法,并可引用对应规范章节。涉及语法结构或依赖改动后应触发 auto run 构建,推荐执行 ohpm install 与 hvigorw assembleHap --mode module -p product=default -p buildMode=debug --no-daemon,确保 ArkTSCheck 与打包通过。日志须用 Logger 工具类封装,首个参数固定为 "SportHealthMap",禁止直接使用 console。
适用场景:ArkTS 页面/组件/模块的生成、审查与重构,状态管理与性能优化,类型安全整改。
限制:资料未提供具体版本兼容范围、安装方式与收费信息;部分规范(如 TextInput 占位符替代方案)依赖当前 HarmonyOS 版本支持情况。