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

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

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

部件配置系統(tǒng)能力是為了方便某個特定部件是否要打開或關(guān)閉特定的系統(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下加入關(guān)鍵字syscap，對內(nèi)部配置相應(yīng)的系統(tǒng)能力。系統(tǒng)能力若無賦值，則默認(rèn)為true，若有賦值，則按實際值為準(zhǔn)。若值為true，則表示該部件默認(rèn)開啟此系統(tǒng)能力，若值為false，則表明該部件默認(rèn)關(guān)閉此系統(tǒng)能力。

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

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

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

如果要對產(chǎn)品的系統(tǒng)能力進(jìn)行精細(xì)化配置，可在產(chǎn)品配置中加入syscap關(guān)鍵字，并對要配置的系統(tǒng)能力賦值。產(chǎn)品側(cè)的配置優(yōu)先級大于部件系統(tǒng)能力默認(rèn)配置，若某一個系統(tǒng)能力在部件側(cè)默認(rèn)配置為false，在產(chǎn)品側(cè)配置為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)能力是關(guān)閉的，而P2P是打開的。綜合部件側(cè)的配置，最終STA、P2P為打開系統(tǒng)能力，而AP、Core和HotspotExt為關(guān)閉的系統(tǒng)能力。

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

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

審核編輯 黃宇