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组件

分类
已于2023-3-22 16:16:19修改
1
收藏 1
回复
举报
回复
    相关推荐