特性

特性配置規(guī)則

下面介紹feature的聲明、定義以及使用方法。

• feature的聲明

• 開(kāi)發(fā)前請(qǐng)熟悉鴻蒙開(kāi)發(fā)指導(dǎo)文檔：[gitee.com/li-shizhen-skin/harmony-os/blob/master/README.md]。
  在部件的bundle.json文件中通過(guò)feature_list來(lái)聲明部件的feature列表，每個(gè)feature都必須以" {部件名} "開(kāi)頭。示例如下：

  {
    "name": "@ohos/xxx",
    "component": {
      "name": "partName",
      "subsystem": "subsystemName",
      "features": [
        "{partName}_feature_A"
      ]
    }
  }
  

  features中可以為部件聲明多個(gè)feature。
  

• feature的定義
  在部件內(nèi)可通過(guò)以下方式定義feature的默認(rèn)值：

  declare_args() {
    {partName}_feature_A = true
  }
  

  該值是此部件的默認(rèn)值，產(chǎn)品可以在部件列表中重載該feature的值。

  feature需給部件內(nèi)多個(gè)模塊使用時(shí)，建議把feature定義在部件的全局gni文件中，各個(gè)模塊的BUILD.gn中import該gni文件。

• feature的使用
  BUILD.gn文件中可通過(guò)以下方式進(jìn)行根據(jù)feature決定部分代碼或模塊參與編譯：

  if ({partName}_feature_A) {
      sources += [ "xxx.c" ]
  }
  
  # 某個(gè)特性引入的依賴，需要通過(guò)該feature進(jìn)行隔離
  if ({partName}_feature_A) {
      deps += [ "xxx" ]
      external_deps += [ "xxx" ]
  }
  
  # bundle.json中不支持if判斷，如果bundle.json中包含的sub_component需要被裁減，可以定義group進(jìn)行裁減判斷
  group("testGroup") {
    deps = []
    if ({partName}_feature_A) {
      deps += [ "xxx" ]
    }
  }
  
  `HarmonyOS與OpenHarmony鴻蒙文檔籽料：mau123789是v直接拿`
  

也可以通過(guò)以下方式為模塊定義代碼宏進(jìn)行代碼級(jí)差異化配置：

if ({partName}_feature_A) {
defines += ["FEATUREA_DEFINE"]
}

審核編輯 黃宇