如何按需配置部件的系統(tǒng)能力

SysCap（SystemCapability，系統(tǒng)能力）是部件向開發(fā)者提供的接口的集合。
開發(fā)前請熟悉鴻蒙開發(fā)指導文檔：[gitee.com/li-shizhen-skin/harmony-os/blob/master/README.md]

部件配置系統(tǒng)能力

部件配置系統(tǒng)能力是為了方便某個特定部件是否要打開或關閉特定的系統(tǒng)能力。

部件配置系統(tǒng)能力的位置在部件目錄下的bundle.json，配置示例如下所示：

"component": {
        "name": "wifi",
        "subsystem": "communication",
        "syscap": [
            "SystemCapability.Communication.WiFi.STA = true",
            "SystemCapability.Communication.WiFi.AP = true",
            "SystemCapability.Communication.WiFi.P2P = false",
            "SystemCapability.Communication.WiFi.Core = false",
            "SystemCapability.Communication.WiFi.HotspotExt"
          ]
        ],
        ...
  }

在component下加入關鍵字syscap，對內(nèi)部配置相應的系統(tǒng)能力。系統(tǒng)能力若無賦值，則默認為true，若有賦值，則按實際值為準。若值為true，則表示該部件默認開啟此系統(tǒng)能力，若值為false，則表明該部件默認關閉此系統(tǒng)能力。

以上配置表明，WIFI的STA、AP、和HotspotExt三個系統(tǒng)能力是打開的，而P2P和Core是關閉的。

產(chǎn)品配置系統(tǒng)能力

產(chǎn)品配置系統(tǒng)能力是為了方便某個特定產(chǎn)品是否要打開或關閉特定的系統(tǒng)能力，若無配置，則以部件側的配置為準，產(chǎn)品配置系統(tǒng)能力的位置在vender/{company}/{product}/config.json。

如果要對產(chǎn)品的系統(tǒng)能力進行精細化配置，可在產(chǎn)品配置中加入syscap關鍵字，并對要配置的系統(tǒng)能力賦值。產(chǎn)品側的配置優(yōu)先級大于部件系統(tǒng)能力默認配置，若某一個系統(tǒng)能力在部件側默認配置為false，在產(chǎn)品側配置為true，則這個系統(tǒng)能力的最終配置為true。示例如下：

{
      "subsystem": "communication",
      "components": [
        ...
        {
          "component": "wifi",
          "features": [],
          "syscap": [
            "SystemCapability.Communication.WiFi.AP = false",
            "SystemCapability.Communication.WiFi.P2P = true",
            "SystemCapability.Communication.WiFi.HotspotExt = false"
          ]
        },
        ...
`HarmonyOS與OpenHarmony鴻蒙文檔籽料：mau123789是v直接拿`

以上配置表明，WiFi的AP和HotspotExt系統(tǒng)能力是關閉的，而P2P是打開的。綜合部件側的配置，最終STA、P2P為打開系統(tǒng)能力，而AP、Core和HotspotExt為關閉的系統(tǒng)能力。

部件側配置和產(chǎn)品側配置的作用

一般來說，當產(chǎn)品沒有特性化差異的時候，我們僅需在部件側配置系統(tǒng)能力，部件側配置的系統(tǒng)能力是我們的基礎，只有當產(chǎn)品存在特性化差異，需要關閉某個默認打開的系統(tǒng)能力或打開某個系統(tǒng)默認關閉的系統(tǒng)能力時，我們才會需要在產(chǎn)品側配置。

審核編輯 黃宇