# 技術視界# 【技術視界】欄目為開發者提供華為研發專家對于HarmonyOS關鍵技術的專業解讀，從不同角度、不同方面幫助開發者更好更快地掌握HarmonyOS相關開發知識。本期文章為大家帶來的是華為終端BG編譯構建技術專家的分享，希望能為您的開發之路帶來啟發~ 作者：Lewei，華為終端BG編譯構建技術專家

DevEcoHvigor是使用TypeScript語言開發的全新輕量化的任務調度工具，針對HarmonyOS應用提供了一系列編譯構建任務，支持將HarmonyOS應用編譯構建出對應的產物包。作為一款HarmonyOS應用編譯構建任務流工具，DevEco Hvigor具備許多可以提升構建效率的特性，支持多產物差異化構建，也支持HarmonyOS應用可分可合等特性。可以稱得上是"麻雀雖小五臟俱全"。

一

任務并行

DevEco Hvigor具備任務并行執行的能力。對于C++編譯、ArkTS任務等耗時而沒有依賴關系的任務，DevEcoHvigor可以使用不同的工作線程并行執行，提高構建效率。在多模塊的中大型工程中，將帶來可觀的耗時節省。

在DevEco Studio中開啟DevEco Hvigor的并行編譯構建能力，需要在DevEcoStudio中打開Settings - Build, Execution,Development - Build Tools - Hvigor選項，并勾選"Executetasks in parallel mode"。

二

任務增量

HarmonyOS應用的編譯構建流程是由任務組成的。DevEco Hvigor具備任務增量執行的能力，通過判斷任務的輸入與輸出，對于輸入與輸出沒有變化的任務，可以復用上次構建產物，從而跳過對應的任務，節省構建時間。

在DevEco Studio中開啟DevEco Hvigor的任務增量能力，需要在DevEco Studio中打開Settings - Build,Execution, Development - Build Tools - Hvigor選項，并勾選"Re-execute the task in incremental mode"。

三

常駐進程

DevEco Hvigor提供了常駐進程的功能機制。通過將進程常駐在內存中，一方面避免了Node進程重復啟動、減少了加載js文件的耗時，另一方面可以復用構建過程中的增量緩存、減少增量緩存信息的讀取與落盤操作。

另外，啟用DevEco Hvigor的常駐進程功能，還可以支持預覽器的急速預覽功能和調試的Hot reload功能。DevEco Hvigor通過對代碼文件的監聽，可以快速編譯代碼片段，急速更新預覽畫面和在設備上實時調試代碼修改。

在DevEco Studio中開啟DevEco Hvigor的常駐進程構建能力，需要在DevEcoStudio中打開Settings - Build, Execution,Development - Build Tools - Hvigor選項，并勾選"Enablethe Daemon for tasks"。

在命令行中，可以通過使用hvigorw命令行工具來查看常駐進程狀態或關閉常駐進程。

• 在工程目錄下執行./hvigorw --status-daemon，可以查看所有常駐進程的狀態。

• 在工程目錄下執行./hvigorw --stop-daemon，可以關閉當前工程對應的常駐進程。

• 在工程目錄下執行./hvigorw --stop-daemon-all，可以關閉當前運行的所有DevEco Hvigor常駐進程。

四

構建過程可視化

DevEco Hvigor會記錄每次構建任務的日志信息，并通過可視化的圖表界面進行展示。記錄的信息包括任務執行的耗時與線程、ArkTS編譯中的各環節的細分耗時情況等。開發者可以藉此分析構建過程中的耗時情況、進而改善構建效率。

在DevEco Studio中開啟DevEco Hvigor的常駐進程構建能力，需要在DevEcoStudio中打開Settings - Build, Execution,Development - Build Tools - Hvigor選項，并勾選"Enablethe Daemon for tasks"。

隨后，可以點擊DevEco Studio下方的"Build Analyzer"標簽頁，查看構建過程中的日志信息和耗時情況。

五

差異化構建打包

通常情況下，應用廠商會根據不同的部署環境、不同的目標人群以及不同的運行環境等，將同一個應用定制為不同的版本。DevEcoHvigor支持差異化構建打包，在構建配置文件中將差異化部分顯示配置出來，即可在編譯構建過程中實現一個應用構建出不同的目標產物版本，從而實現源代碼、資源文件等的高效復用。

通過配置Target，每個HAP包都可以定制功能和資源。在每個HAP模塊的build-profile.json5中，可以配置該模塊支持的Targets：

{
  "apiType": 'stageMode',
  "buildOption": {  
  },
  "targets": [  //定義不同的target
    {
      "name": "default",  //默認target名稱default
      "runtimeOS": "HarmonyOS",
    },
    {
      "name": "free",  //免費版target名稱
      "runtimeOS": "HarmonyOS"
    },
    {
      "name": "pay",  //付費版target名稱
      "runtimeOS": "HarmonyOS",
    }
  ]
}

（左右滑動查看更多）

在每個target中，可以定制其頁面源碼集、資源目錄、支持的設備類型等，比如當你只希望某個hap對應平板設備、而某個hap包對應手機配置時，可以如下配置：

{
  "apiType": 'stageMode',
  "buildOption": {
  },
  "targets": [
    {
      "name": "default",
      "runtimeOS": "HarmonyOS",
    },
    {
      "name": "phone",
      "runtimeOS": "HarmonyOS",
      "config": {
        "deviceType": [  //定義free支持的設備類型為phone
          "phone"
        ]
      }
    },
    {
      "name": "tablet",
      "runtimeOS": "HarmonyOS",
      "config": {
        "deviceType": [  //定義pay支持的設備類型為phone
          "tablet"
        ]
      }
    }
  ]
}

（左右滑動查看更多）通過配置將哪些HAP模塊的Target與Product綁定，讓定制化的HAP可以組合成APP包、發布上架應用市場。在工程級的build-profile.json5中，先定義Product，并可以定制使用不同的bundleName和簽名材料：

"app": {
    "signingConfigs": [],
    "compileSdkVersion": 9,
    "compatibleSdkVersion": 9,
    "products": [
      {
        "name": "default",
        "bundleName": "com.example00.com",  //定義default的bundleName信息
        "signingConfig": "default" //定義default的簽名文件信息
      },
      {
        "name": "productA",
        "bundleName": "com.example01.com",  //定義productA的bundleName信息
        "signingConfig": "productA" //定義productA的簽名文件信息
      },
      {
        "name": "productB",
        "bundleName": "com.example02.com",  //定義productB的bundleName信息
        "signingConfig": "productB" //定義productB的簽名文件信息
      }
    ]
}

（左右滑動查看更多）再定義需要將哪些HAP模塊的Target與Product綁定，就可以在上架應用商店時提供不同的APP包。

{
  "app": {
    "signingConfigs": [],
    "compileSdkVersion": 9,
    "compatibleSdkVersion": 9,
    "products": [
      {
        "name": "default",
        "bundleName": "com.example00.com",
        "signingConfig": "default"
      },
      {
        "name": "productA",
        "bundleName": "com.example01.com",
        "signingConfig": "productA"
      },
      {
        "name": "productB",
        "bundleName": "com.example02.com",
        "signingConfig": "productB"
      }
    ]
  },
  "modules": [
    {
      "name": "entry",
      "srcPath": "./entry",
      "targets": [
        {
          "name": "default",  //將default target分別打包到default、productA和productB APP中
          "applyToProducts": [
            "default",
            "productA",
            "productB"
          ]
        },
        {
          "name": "free",  //將free target打包到productA APP中
          "applyToProducts": [
            "productA"
          ]
        },
        {
          "name": "pay",  //將pay target打包到productB APP中
          "applyToProducts": [
            "productB"
          ]
        }
      ]
    }
  ]
}

（左右滑動查看更多）最后，在DevEco Studio中，可以使用可視化界面來選擇運行和調試指定模塊和Target。從DevEco Studio界面的右上角打開面板，執行需要調試或運行的Target，DevEco Hvigor就會執行指定模塊、指定Target的編譯構建，并在預覽和調試中都使用該配置。

六

未來特性與總結

目前，DevEcoHvigor作為全新開發的編譯構建工具，雖然已經有了不少可以提升編譯效率的地方，但仍有許多新的特性、功能和性能優化還在路上。比如，DevEcoHvigor即將開放的自定義構建任務插件能力和編譯流程插樁接口、在運行時獲取構建配置的BuildProfile機制等。我們會繼續努力，力求將更好的編譯效率、更便捷的構建體驗，帶給每一位HarmonyOS應用的開發者。