harmonyos-dev

HarmonyOS 开发

根据仓库证据和当前官方文档实现 HarmonyOS 工作。相比大范围推测性重写，优先采用经过验证的小改动。

工作流

1. 了解项目背景

对于现有仓库，先检查再提问：

• 阅读仓库说明以及与请求相关的文件。
• 定位 build-profile.json5、oh-package.json5、module.json5、app.json5 和模块级配置。
• 推导编译／兼容／目标 SDK、Stage 或 FA 模型、设备类型、状态管理代际、Kit、权限和构建命令。
• 搜索相近实现，除非任务需要更改，否则保留既有架构。

对于全新项目请求，只询问会实质影响结果的决策：目标设备、最低兼容 API、应用或原子化服务，以及所需的系统能力。不要擅自设定默认 API 版本或设备类型。

2. 核实与版本相关的事实

按以下顺序查阅来源：

1. 仓库的 SDK 配置、生成的类型、编译器诊断信息和已安装的 SDK。
2. 当前 Huawei API 参考文档，用于核实签名、可用性、权限、SysCap、错误和弃用情况。
3. 当前 Huawei 开发指南、发行说明、最佳实践和官方示例。
4. 本技能中的本地参考文件，作为导航和审查清单。

本地参考资料只是快照，不是权威来源。在依赖任何 API 名称、签名、装饰器约束、权限、可用级别或生命周期行为之前，都要重新核实。如果无法查阅官方资料，应说明哪些内容仍未核实，并避免将推断表述为事实。

需要外部研究时，使用可用的文档或浏览工具，并将技术论断限定为 Huawei 官方来源。无需指定某个特定工具，例如 Context7。

3. 设计最小且完整的改动

• 说明会影响实现的兼容性和设备假设。
• 除非进行明确迁移，否则在组件边界内保持 V1 和 V2 状态管理模式一致。
• 选择 Kit API 前，检查 API 级别、设备、SysCap、权限和应用形态限制。
• 规划订阅、计时器、网络句柄、ResultSet 对象、文件、控制器及其他资源的所有权和清理方式。
• 保留错误语义。根据 API 契约处理 BusinessError 和被拒绝的 Promise；不要默默吞掉失败。
• 优先使用资源和自适应布局，避免硬编码字符串、颜色、尺寸以及仅适用于单一设备的假设。

仅加载相关参考资料：

• 状态和响应性：references/state-management.md
• ArkUI 和设备适配：references/ui-components.md
• Preferences、RDB 和文件：references/data-persistence.md
• HTTP、WebSocket、套接字和传输：references/network.md
• 权限声明和运行时授权：references/permissions.md
• 以测量为依据的性能优化：references/performance.md

4. 按仓库风格实现

• 修改现有扩展点，而非在缺乏依据时创建并行抽象。
• 明确 ArkTS 类型，并确保其符合项目的编译器规则。
• 复用项目的日志、错误处理、依赖注入、导航、资源和测试约定。
• 对于 API 迁移，将机械式兼容性修改与行为变更分开。
• 不要更改无关代码或生成的产物。

5. 验证

先运行最相关的最小范围检查，再根据情况运行更广泛的检查：

• 编译或构建受影响的模块。
• 运行相关的单元测试、集成测试、UI 测试或 Hvigor 测试。
• 检查诊断信息，确认 API 兼容性和 ArkTS 约束。
• 对于 UI 工作，验证范围内受影响的设备类别、屏幕方向、主题、字体缩放，以及空状态、错误状态和加载状态。
• 对于生命周期工作，在可行的情况下，测试创建、进入后台、返回前台、导航离开和销毁流程。

如果所需的环境、SDK、设备、账号或服务不可用，请明确说明具体未验证的范围。切勿将未运行的检查描述为已通过。

源码与回复政策

对于重要的、受版本影响的声明，或用户要求提供来源时，请引用华为官方文档。将引用放在其所支持的声明旁边。不要添加装饰性引文，也不要声称本地示例是官方要求。

对于实现类任务，请在结尾说明：

• 更改内容及其位置。
• 兼容性假设。
• 已运行的验证及其结果。
• 尚未验证的项目或风险。

对于仅要求解释的请求，请直接回答；除非用户提出要求，否则不要修改代码库。