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

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

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

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

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

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

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

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

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

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

審核編輯 黃宇