基于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都可以獨立進(jì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，通常用于實現(xiàn)應(yīng)用的入口界面、入口圖標(biāo)、主特性功能等。

Feature類型的HAP：是應(yīng)用的動態(tài)特性模塊，在module.json5配置文件中的type標(biāo)簽配置為“feature”類型。一個應(yīng)用程序包可以包含一個或多個Feature類型的HAP，也可以不包含;Feature類型的HAP通常用于實現(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模型)