HarmonyOS NEXT 的 ArkTS 语言在 TypeScript 基础上引入了更严格的静态类型检查规则，目的是提升代码的可维护性和运行时安全性。许多从 TypeScript 或其他语言转向 ArkTS 的开发者，在初期经常会遇到一系列"看似矛盾"的编译错误。本文基于一个设备信息卡片应用的真实开发过程，系统梳理了四类高频编译错误的原因、修复方法和预防措施。每一类错误都配有错误代码与正确代码

HarmonyOS 应用卡片运行在桌面进程中，无法直接调用应用内的导航和状态管理。router 事件：点击卡片后打开应用页面，适合"查看详情"场景call 事件：通过 callee 机制回调主进程方法，适合"刷新数据"场景本文结合设备信息卡片案例，详细讲解这两种事件的使用方法和最佳实践。知识点内容call 事件卡片 → callee → 数据刷新 → updateFormrouter 事件卡片 →

HarmonyOS 应用卡片支持多种数据更新方式，开发者可根据业务需求选择合适的更新策略。知识点内容定时更新配置 +回调主动更新call 刷新→callee.on→updateForm数据媒介Preferences 持久化存储自动更新订阅系统事件批量更新维护 formId 列表，遍历调用 updateForm理解卡片更新与数据交互机制，是开发高质量动态应用卡片的关键。合理的更新策略能平衡数据实时性

是 HarmonyOS 应用卡片中用于触发交互事件的全局函数。由于卡片运行在桌面进程中（非应用进程），无法直接使用普通的导航和事件机制。提供了一套专门的事件通道，让卡片可以与宿主应用进行通信。知识点内容函数call 事件调用 UIAbility 中 callee 注册的方法router 事件跳转打开应用页面message 事件发送消息到 FormExtensionAbilitycallee 注册c

是 HarmonyOS 应用卡片的核心扩展能力，属于。它作为卡片的服务端运行环境，负责管理卡片的完整生命周期，包括创建、更新、销毁等操作。知识点内容核心类（继承自Kit创建卡片返回更新卡片销毁卡片数据传递配置文件是 HarmonyOS 应用卡片开发的核心基础设施，掌握其生命周期和回调方法，是实现动态卡片数据交互的关键。

是 HarmonyOS 提供的存储空间统计模块，属于，用于查询设备的总存储空间、可用空间和已用空间。支持同步和异步两种调用方式，适用于存储信息展示、空间清理提醒等场景。知识点内容模块导入获取总容量(字节)获取可用容量(字节)单位换算字节 ÷ (1024³) = GB异步版本权限要求基础属性无需额外权限UI 展示结合Gauge组件实现环形图掌握模块后，配合和deviceInfo，即可构建完整的设备信

是 HarmonyOS 基础服务模块，属于，用于获取当前设备的硬件与系统信息。所有属性均为同步只读，无需申请权限，开发者可以直接在页面或卡片中读取设备信息。知识点内容模块导入获取品牌获取产品名获取设备类型获取系统版本权限要求无需额外权限数据传递通过 Preferences + FormExtensionAbility 传递到卡片是开发设备信息类应用的基础模块，结合同步读取和持久化存储，可以方便地在

是 HarmonyOS 提供的基础服务模块，属于，用于获取设备电池的实时状态信息。开发者可以通过该模块读取电池电量、充电状态、电池健康度等关键数据，广泛应用于设备信息展示、省电优化、应用卡片等场景。知识点内容模块导入获取电量（0~100）充电状态实时更新订阅公共事件权限要求无需额外权限卡片场景通过 Preferences + FormExtensionAbility 传递数据掌握模块后，开发者可以

配置参数 → 创建实例 → 注册 readData 回调 → start() 开始录制→ [录制中...] → stop() 停止 → release() 释放资源掌握 AudioCapturer 的使用，是实现语音识别、实时音频处理等高级功能的前提。结合 Core Speech Kit 的模块，可以构建完整的语音转文字功能。

语音识别（ASR）和语音合成（TTS）。ASR：通过模块，将 PCM 音频转换为文字，适用于聊天转文字、语音搜索等场景TTS：通过模块，将文字转换为语音播报，适用于朗读、语音通知等场景两者结合使用，可以构建完整的语音交互闭环，为应用赋予"听"和"说"的双重能力。