Stage模型應(yīng)用程序包結(jié)構(gòu)

基于Stage模型開發(fā)的應(yīng)用，經(jīng)編譯打包后，其應(yīng)用程序包結(jié)構(gòu)如下圖應(yīng)用程序包結(jié)構(gòu)（Stage模型）所示。開發(fā)者需要熟悉應(yīng)用程序包結(jié)構(gòu)相關(guān)的基本概念。

• 在開發(fā)態(tài)，一個應(yīng)用包含一個或者多個Module，可以在DevEco Studio工程中創(chuàng)建一個或者多個Module。Module是HarmonyOS應(yīng)用/服務(wù)的基本功能單元，包含了源代碼、資源文件、第三方庫及應(yīng)用/服務(wù)配置文件，每一個Module都可以獨(dú)立進(jìn)行編譯和運(yùn)行。Module分為“Ability”和“Library”兩種類型，“Ability”類型的Module對應(yīng)于編譯后的HAP（Harmony Ability Package）；“Library”類型的Module對應(yīng)于HAR（Harmony Archive），或者HSP（Harmony Shared Package）。

  一個Module可以包含一個或多個UIAbility組件，如下圖所示。

  圖1 Module與UIAbility組件關(guān)系示意圖

  

  全文中介紹到的Module默認(rèn)指的是“Ability”類型的Module。

• 開發(fā)者通過DevEco Studio把應(yīng)用程序編譯為一個或者多個.hap后綴的文件，即HAP。HAP是HarmonyOS應(yīng)用安裝的基本單位，包含了編譯后的代碼、資源、三方庫及配置文件。HAP可分為Entry和Feature兩種類型。

  • Entry類型的HAP：是應(yīng)用的主模塊，在module.json5配置文件中的type標(biāo)簽配置為“entry”類型。在同一個應(yīng)用中，同一設(shè)備類型只支持一個Entry類型的HAP，通常用于實(shí)現(xiàn)應(yīng)用的入口界面、入口圖標(biāo)、主特性功能等。
  • Feature類型的HAP：是應(yīng)用的動態(tài)特性模塊，在module.json5配置文件中的type標(biāo)簽配置為“feature”類型。一個應(yīng)用程序包可以包含一個或多個Feature類型的HAP，也可以不包含；Feature類型的HAP通常用于實(shí)現(xiàn)應(yīng)用的特性功能，可以配置成按需下載安裝，也可以配置成隨Entry類型的HAP一起下載安裝（請參見module對象內(nèi)部結(jié)構(gòu)中的“deliveryWithInstall”）。

• 每個HarmonyOS應(yīng)用可以包含多個.hap文件，一個應(yīng)用中的.hap文件合在一起稱為一個Bundle，而bundleName就是應(yīng)用的唯一標(biāo)識（請參見app.json5配置文件中的bundleName標(biāo)簽）。需要特別說明的是：在應(yīng)用上架到應(yīng)用市場時，需要把應(yīng)用包含的所有.hap文件（即Bundle）打包為一個.app后綴的文件用于上架，這個.app文件稱為App Pack（Application Package），其中同時包含了描述App Pack屬性的pack.info文件；在云端（服務(wù)器）分發(fā)和終端設(shè)備安裝時，都是以HAP為單位進(jìn)行分發(fā)和安裝的。

• 打包后的HAP包結(jié)構(gòu)包括ets、libs、resources等文件夾和resources.index、module.json、pack.info等文件。

  • ets目錄用于存放應(yīng)用代碼編譯后的字節(jié)碼文件。
  • libs目錄用于存放庫文件。庫文件是HarmonyOS應(yīng)用依賴的第三方代碼（.so二進(jìn)制文件）。
  • resources目錄用于存放應(yīng)用的資源文件（字符串、圖片等），便于開發(fā)者使用和維護(hù)，詳見資源分類與訪問。
  • resources.index是資源索引表，由IDE編譯工程時生成。
  • module.json是HAP的配置文件，內(nèi)容由工程配置中的module.json5和app.json5組成，該文件是HAP中必不可少的文件。IDE會自動生成一部分默認(rèn)配置，開發(fā)者按需修改其中的配置。詳細(xì)字段請參見應(yīng)用配置文件。
  • pack.info是Bundle中用于描述每個HAP屬性的文件，例如app中的bundleName和versionCode信息、module中的name、type和abilities等信息，由IDE工具生成Bundle包時自動生成。

  圖2 應(yīng)用程序包結(jié)構(gòu)（Stage模型）