开发说明

API参考主要用于开发者查阅应用开发相关的各类API说明。为了方便开发者使用API文档，对文档描述中的常用字段进行说明。

版本说明

API参考采用两种方式标记组件或接口开始支持的版本号：

应用模型说明

随着系统的演进发展，先后提供了两种应用模型，FA模型和Stage模型。

权限说明

默认情况下，应用只能访问有限的系统资源。但某些情况下，应用为了扩展功能的诉求，需要访问额外的系统或其他应用的数据（包括用户个人数据）、功能。具体可参考应用权限管控概述。

当调用接口访问这些资源时，需要申请对应的权限。申请方式可参考访问控制开发指导。

服务卡片能力说明

将应用/元服务的重要信息或操作前置到服务卡片（简称“卡片”），可达到服务直达、减少跳转层级的体验效果。

对于支持在ArkTS服务卡片中使用的接口，将会添加“卡片能力”的标记： 从API version x开始，该接口支持在ArkTS卡片中使用。

废弃接口说明

废弃接口会使用上标“deprecated”标注，表示该接口不再推荐使用。

废弃接口均会标注废弃起始版本，从废弃版本起的5个API level仍可以兼容使用，但不推荐此行为。

示例代码语言说明

HarmonyOS支持使用JS和TS两种开发语言。

元服务是HarmonyOS提供的一种轻量应用程序形态，具备服务直达、跨设备等特征。

元服务可独立上架、分发、运行，独立实现业务闭环，可大幅提升信息与服务的获取效率。

元服务基于HarmonyOS SDK（只能使用“元服务API集”）开发，支持运行在1+8+N设备上，供用户在合适的场景、合适的设备上便捷使用。

支持在元服务中使用的接口，将会添加“元服务API”的标记： 从API version x开始，该接口支持在元服务中使用。