HarmonyOS API:系统能力SystemCapability使用说明和列表
版本:v3.1 Beta
系统能力SystemCapability使用说明
系统能力与 API
SysCap,全称SystemCapability,即系统能力,指操作系统中每一个相对独立的特性,如包管理、公共事件、通知等,都是系统能力之一。每个系统能力对应多个API,随着目标设备是否支持该系统能力共同存在或消失,也会随着DevEco Studio一起提供给开发者做联想。
开发者可以在系统能力SystemCapability列表中查询HarmonyOS的能力集。
设备与支持能力集
每个设备根据其硬件能力,对应不同的支持能力集。3.1 Developer Preview版本仅支持远程模拟器的手机设备,设备的支持能力集由HarmonyOS系统定义。
设备与SDK能力的对应
SDK向DevEco Studio提供全量API,DevEco Studio识别开发者项目中选择的设备形态,找到该设备的支持能力集,筛选支持能力集包含的API并提供API联想。
使用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组件