SysCap (系统能力)
系统能力(SystemCapability,简称SysCap),指操作系统中每一个相对独立的特性。不同的设备对应不同的系统能力集,每个系统能力对应一个或多个API。开发者可根据系统能力来判断是否可以使用某接口。
说明:
本模块首批接口从API version 8开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
canIUse
canIUse(syscap: string): boolean
查询系统是否具备某个系统能力。
系统能力: SystemCapability.ArkUI.ArkUI.Full
参数:
参数名 | 类型 | 必填 | 说明 |
---|---|---|---|
syscap | string | 是 | 待查询的系统能力名称。 |
返回值:
类型 | 说明 |
---|---|
boolean | 系统能力查询结果,true表示系统具备该能力,false表示系统不具备。 |
示例:
import geoLocationManager from '@ohos.geoLocationManager'
import { BusinessError } from '@ohos.base';
const isLocationAvailable = canIUse('SystemCapability.Location.Location.Core');
if (isLocationAvailable) {
geoLocationManager.getCurrentLocation((err: BusinessError, location: geoLocationManager.Location) => {
if (err) {
console.log('err=' + JSON.stringify(err));
}
if (location) {
console.log('location=' + JSON.stringify(location));
}
});
} else {
console.log('Location not by this device.');
}