• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1# Configuring System Capabilities
2The SystemCapability (SysCap) module provides a set of APIs for developers to implement system capabilities.
3##  Configuring System Capabilities for a Component
4When adding a component, you need to enable or disable specific system capabilities for it in the **bundle.json** file in the component directory.
5
6The following is an example:
7
8```json
9  "component": {
10        "name": "wifi",
11        "subsystem": "communication",
12        "syscap": [
13            "SystemCapability.Communication.WiFi.STA = true",
14            "SystemCapability.Communication.WiFi.AP = true",
15            "SystemCapability.Communication.WiFi.P2P = false",
16            "SystemCapability.Communication.WiFi.Core = false",
17            "SystemCapability.Communication.WiFi.HotspotExt"
18          ]
19        ],
20        ...
21  }
22
23```
24Add the keyword **syscap** under **component** to configure system capabilities. If no value is assigned for a system capability, the default value **true** will be used. The value **true** means to enable the system capability, and the value **false** means the opposite.
25
26In this example, Wi-Fi STA, AP, and HotspotExt are enabled, and P2P and Core are disabled.
27## Configuring System Capabilities for a Product
28When building a product, you may need to enable or disable specific system capabilities for it in **vendor/{company}/{product}/config.json**. If you do not configure system capabilities here, the system capabilities configured for the component will be used.
29
30To configure system capabilities for a product, add the keyword **syscap** to the product **config.json** file and configure the system capabilities. The system capabilities configured for a product take precedence over the system capabilities configured for a component. If a system capability is set to **false** for the component and to **true** for the product, the system capability is enabled.
31
32The following is an example:
33
34```json
35{
36      "subsystem": "communication",
37      "components": [
38        ...
39        {
40          "component": "wifi",
41          "features": [],
42          "syscap": [
43            "SystemCapability.Communication.WiFi.AP = false",
44            "SystemCapability.Communication.WiFi.P2P = true",
45            "SystemCapability.Communication.WiFi.HotspotExt = false"
46          ]
47        },
48        ...
49```
50In this example, Wi-Fi AP and HotspotExt are disabled and P2P is enabled for the product. Considering the system capability configuration example for the component, STA and P2P are enabled and AP, Core, and HotspotExt are disabled.
51## Configuration Tips
52If a product does not have feature difference, you only need to configure system capabilities for components. If a product has feature difference, you can enable or disable specific system capabilities in the product configuration file.
53