Provides APIs for querying whether a single system capability (SystemCapability) is supported. Developers can query at runtime whether a device supports a specific system capability to implement differentiated feature adaptation. Typical use cases include adapting features to different device models, controlling feature degradation switches, and branching conditional features. This API is lightweight and efficient, helping developers avoid crashes caused by calling APIs that the device does not support, and improving application compatibility and stability across different devices.
File to include: <syscap_ndk.h>
System capability: SystemCapability.Startup.SystemInfo
Since: 8
Library: libdeviceinfo_ndk.z.so
Related module: SyscapNdk
| Name | Description |
|---|---|
| bool canIUse() (const char *cap) | Returns whether the specified system capability is supported. The value true indicates that it is supported, and false indicates that it is not. The cap parameter specifies the system capability name in the format "SystemCapability.xxx.xxx". A system capability (SystemCapability, or SysCap for short) refers to each relatively independent feature in the operating system. Different devices correspond to different system capability sets, and each system capability corresponds to one or more APIs. Developers can determine whether the corresponding API can be used based on the system capability. Since: 8 |
bool canIUse (const char * cap)
Description
Queries whether a specified system capability is supported. A system capability (SystemCapability, SysCap for short) refers to each relatively independent feature in an operating system. Different devices correspond to different system capability sets, and each system capability corresponds to one or more APIs. Developers can determine whether an API can be used based on the system capability.
Since: 8
Parameters
| Name | Description |
|---|---|
| const char * cap | Name of the system capability to query. |
Returns
| Type | Description |
|---|---|
| bool | Query result of the system capability. The value true indicates that the system has the capability, and false indicates that it does not. |