HarmonyOS组件开发规范文档之理解与总结
结合之前的项目整改总结和HarmonyOS开发规范要求,被采纳为团队标准开发范式的组件开发规范文档主要包含以下核心内容,这些规范在华为UX团队A级验收中体现出显著价值:
一、组件工程化规范
-
模块化架构设计
- 工程分层:明确区分业务逻辑层(entry目录)与组件封装层(Library目录),组件需独立编译为可复用的har包,实现"一次开发,多场景复用"
- 包名规范:采用
com.samples.特性名
格式,确保全局唯一性(如com.samples.filemanager
) - 目录结构:组件库内按功能划分
components
(UI控件)、feature
(业务逻辑)、utils
(工具类)等子模块
-
代码质量管控
- 函数长度限制:单一函数不超过80行,条件嵌套不超过4层,强制提取复用函数
- 日志标准化:使用Hilog接口封装Logger类,统一日志前缀格式(如
[Sample_Clock]