管理中心
我的

您当前正在浏览HarmonyOS最新文档,覆盖已发布的所有API版本,可在API参考中筛选您使用的API版本。详细的版本配套关系请参考版本说明。

指南与API参考API参考公共基础能力C API头文件syscap_ndk.h

syscap_ndk.h

Phone12+PC/2in113+Tablet12+TV19+Wearable18+

概述

查询单个系统能力(SystemCapability)是否被支持的API。开发者可在运行时查询设备是否支持特定系统能力,实现差异化功能适配。典型使用场景包括:针对不同设备型号适配功能、特性降级开关控制、条件功能分支判断等。该API具有轻量级、高效的特点,能帮助开发者避免因调用设备不支持的API而导致的崩溃问题,提高应用在不同设备上的兼容性和稳定性。

引用文件: <syscap_ndk.h>

系统能力: SystemCapability.Startup.SystemInfo

起始版本: 8

库: libdeviceinfo_ndk.z.so

相关模块: syscapndk

汇总

函数

展开
名称 描述
bool canIUse (const char *cap)

返回指定的系统能力是否被支持。返回true表示支持,返回false表示不支持。cap参数为系统能力名称,格式为"SystemCapability.xxx.xxx"。

系统能力(SystemCapability,简称 SysCap),指操作系统中每一个相对独立的特性。不同的设备对应不同的系统能力集,每个系统能力对应一个或多个API。开发者可根据系统能力来判断是否可以使用对应的API。

起始版本: 8

函数说明

canIUse()

Phone12+PC/2in113+Tablet12+TV19+Wearable18+
bool canIUse (const char * cap)

描述:

查询指定的系统能力是否被支持。 系统能力(SystemCapability,简称SysCap),指操作系统中每一个相对独立的特性。不同的设备对应不同的系统能力集,每个系统能力对应一个或多个API。开发者可根据系统能力来判断是否可以使用某接口。

起始版本: 8

参数:

展开
参数项 描述
const char * cap 待查询的系统能力名称。

返回:

展开
类型 说明
bool 系统能力查询结果,true表示系统具备该能力,false表示系统不具备。