HarmonyOS API：系统能力SystemCapability使用说明和列表

joytrian

发布于 2023-3-22 16:16

浏览

1收藏

版本：v3.1 Beta

系统能力SystemCapability使用说明

系统能力与 API

SysCap，全称SystemCapability，即系统能力，指操作系统中每一个相对独立的特性，如包管理、公共事件、通知等，都是系统能力之一。每个系统能力对应多个API，随着目标设备是否支持该系统能力共同存在或消失，也会随着DevEco Studio一起提供给开发者做联想。

HarmonyOS API：系统能力SystemCapability使用说明和列表-鸿蒙开发者社区

开发者可以在系统能力SystemCapability列表中查询HarmonyOS的能力集。

设备与支持能力集

每个设备根据其硬件能力，对应不同的支持能力集。3.1 Developer Preview版本仅支持远程模拟器的手机设备，设备的支持能力集由HarmonyOS系统定义。

HarmonyOS API：系统能力SystemCapability使用说明和列表-鸿蒙开发者社区

设备与SDK能力的对应

SDK向DevEco Studio提供全量API，DevEco Studio识别开发者项目中选择的设备形态，找到该设备的支持能力集，筛选支持能力集包含的API并提供API联想。

HarmonyOS API：系统能力SystemCapability使用说明和列表-鸿蒙开发者社区

使用SysCap开发应用

判断API是否可以使用

方法1：HarmonyOS定义了API canIUse帮助开发者来判断该设备是否支持某个特定的SysCap。

if (canIUse("SystemCapability.ArkUI.ArkUI.Full")) {
    console.log("该设备支持SystemCapability.ArkUI.ArkUI.Full");
} else {
    console.log("该设备不支持SystemCapability.ArkUI.ArkUI.Full");
}

方法2：开发者可通过import的方式将模块导入，若当前设备不支持该模块，import的结果为undefined，开发者在使用API时，需要判断其是否存在。

import geolocation from '@ohos.geolocation';

if (geolocation) {
    geolocation.getCurrentLocation((location) => {
        console.log(location.latitude, location.longitude);
    });
} else {
    console.log('该设备不支持位置信息');
}

除此之外，开发者可以通过API参考文档查询API接口所属的SysCap。

系统能力SystemCapability列表

SysCap，全称SystemCapability，即系统能力，指操作系统中每一个相对独立的特性。

开发者使用某个接口进行开发前，建议先阅读系统能力使用说明，了解Syscap的定义和使用指导。

说明

当前列表枚举出3.1 Beta版本中支持的系统能力。开发者可以在SDK中通过phone.json文件查询。

SystemCapability.ArkUI.ArkUI.Full：ArkUI标准系统
SystemCapability.ArkUI.ArkUI.Lite：ArkUI小型系统
SystemCapability.BundleManager.BundleFramework：包管理服务框架
SystemCapability.BundleManager.BundleFramework.Core：包管理核心业务，包含包信息查询、安装卸载的核心能力
SystemCapability.BundleManager.BundleFramework.DefaultApp：包管理提供的默认应用管理特性
SystemCapability.BundleManager.Zlib：Zlib压缩、解压缩工具
SystemCapability.Graphic.Graphic2D.ColorManager.Core：广色域管理
SystemCapability.WindowManager.WindowManager.Core：窗口管理
SystemCapability.Notification.CommonEvent：公共事件
SystemCapability.Notification.Notification：通知
SystemCapability.Notification.ReminderAgent：后台代理提醒
SystemCapability.Notification.Emitter：事件处理服务
SystemCapability.Communication.IPC.Core：进程间通信
SystemCapability.Communication.NetManager.Core：网络管理基础服务
SystemCapability.Communication.NetStack：基础网络协议栈能力
SystemCapability.Communication.WiFi.Core：WIFI基础能力
SystemCapability.Communication.WiFi.STA：WIFI STA能力
SystemCapability.Location.Location.Core：位置服务基础能力
SystemCapability.Location.Location.Geocoder：地理编码能力
SystemCapability.Location.Location.Geofence：地理围栏能力
SystemCapability.Location.Location.Gnss：GNSS硬件相关能力
SystemCapability.Location.Location.Lite：位置服务轻设备能力
SystemCapability.PowerManager.ThermalManager：温控服务
SystemCapability.PowerManager.PowerManager.Core：系统电源管理服务核心能力
SystemCapability.PowerManager.BatteryManager.Core：电池服务核心能力
SystemCapability.Multimedia.Media.Core：媒体基础能力
SystemCapability.Multimedia.Media.AudioPlayer：媒体音频播放引擎能力
SystemCapability.Multimedia.Media.AudioRecorder：媒体音频播录制引擎能力
SystemCapability.Multimedia.Media.VideoPlayer：媒体视频播放引擎能力
SystemCapability.Multimedia.Audio.Core：音频基础能力
SystemCapability.Multimedia.Audio.Renderer：音频输出能力
SystemCapability.Multimedia.Audio.Capturer：音频输入能力
SystemCapability.Multimedia.Audio.Device：音频设备管理能力
SystemCapability.Multimedia.Audio.Volume：音频音量管理能力
SystemCapability.Multimedia.Audio.Communication：音频通信能力
SystemCapability.Multimedia.Image.Core：图片基础能力
SystemCapability.Multimedia.Image.ImageSource：图片源解码解析能力
SystemCapability.Multimedia.Image.ImagePacker：图片打包能力
SystemCapability.Multimedia.Image.ImageReceiver：图片接收能力
SystemCapability.Multimedia.Image.ImageCreator：图像创建能力
SystemCapability.Multimedia.MediaLibrary.Core：媒体库基础能力
SystemCapability.Telephony.CoreService：蜂窝核心服务
SystemCapability.Telephony.CellularData：蜂窝数据服务
SystemCapability.Telephony.SmsMms：短彩信服务
SystemCapability.Telephony.StateRegistry：蜂窝网络状态注册服务
SystemCapability.Global.I18n：国际化
SystemCapability.Global.ResourceManager：资源管理
SystemCapability.ResourceSchedule.BackgroundTaskManager.ContinuousTask：长时任务管理
SystemCapability.Utils.Lang：TS/JS语言基础库
SystemCapability.HiviewDFX.HiLog：流水日志
SystemCapability.HiviewDFX.HiTrace：分布式追踪
SystemCapability.HiviewDFX.Hiview.FaultLogger：事件打点
SystemCapability.HiviewDFX.HiChecker：检测模式
SystemCapability.HiviewDFX.HiAppEvent：应用事件打点
SystemCapability.HiviewDFX.HiProfiler.HiDebug：调试调优
SystemCapability.Security.Cert：加解密算法库框架-证书能力
SystemCapability.Security.CryptoFramework：加解密算法库框架-加解密基础能力
SystemCapability.Security.Huks：设备密钥管理
SystemCapability.Security.AccessToken：访问控制
SystemCapability.Account.OsAccount：帐号
SystemCapability.Account.AppAccount：应用帐号
SystemCapability.UserIAM.UserAuth.Core：统一用户认证
SystemCapability.MiscServices.InputMethodFramework：输入法框架
SystemCapability.MiscServices.Time：时间时区定时
SystemCapability.MiscServices.Upload：上传服务
SystemCapability.MiscServices.Download：下载服务
SystemCapability.FileManagement.File.FileIO：基础文件IO接口
SystemCapability.FileManagement.UserFileService：用户文件访问服务
SystemCapability.USB.USBManager：usb服务
SystemCapability.Sensors.Sensor：传感器服务订阅
SystemCapability.Sensors.MiscDevice：小器件-振感
SystemCapability.Startup.SystemInfo：系统基本信息
SystemCapability.DistributedDataManager.RelationalStore.Core：关系型数据库核心能力
SystemCapability.DistributedDataManager.KVStore.Core：Key-Value型数据库核心能力
SystemCapability.DistributedDataManager.KVStore.DistributedKVStore：分布式Key-Value型数据库
SystemCapability.DistributedDataManager.DataObject.DistributedObject：分布式对象
SystemCapability.DistributedDataManager.Preferences.Core：偏好型数据存储核心能力
SystemCapability.DistributedDataManager.DataShare.Core：跨进程数据共享，基础能力
SystemCapability.Ability.AbilityBase：组件运行基础数据定义，主要包括组件通信数据的载体want、系统配置定义等
SystemCapability.Ability.AbilityRuntime.Core：组件运行核心基础功能模块，包括应用初始化、无界面组件运行等
SystemCapability.Ability.AbilityRuntime.FAModel：FA模型
SystemCapability.Ability.AbilityRuntime.AbilityCore：通用组件（有界面）
SystemCapability.Ability.AbilityRuntime.Mission：任务管理
SystemCapability.Ability.Form：卡片管理
SystemCapability.Ability.DistributedAbilityManager：分布式流转管理（continuationManager）接口定义，支持打开互联面板、更新流转状态
SystemCapability.Applications.Contacts：联系人
SystemCapability.Applications.settings.Core：设置API
SystemCapability.Web.Webview.Core：webview组件