基于Stage模型開發的應用,經編譯打包后,其應用程序包結構如下圖應用程序包結構(Stage模型)所示。開發者需要熟悉應用程序包結構相關的基本概念。
在開發態,一個應用包含一個或者多個Module,可以在DevEco Studio工程中創建一個或者多個Module。Module是HarmonyOS應用/服務的基本功能單元,包含了源代碼、資源文件、第三方庫及應用/服務配置文件,每一個Module都可以獨立進行編譯和運行。Module分為“Ability”和“Library”兩種類型,“Ability”類型的Module對應于編譯后的HAP(Harmony Ability Package);“Library”類型的Module對應于HAR(Harmony Archive),或者HSP(Harmony Shared Package)。
一個Module可以包含一個或多個UIAbility組件,如下圖所示。
圖1 Module與UIAbility組件關系示意圖:
全文中介紹到的Module默認指的是“Ability”類型的Module。
開發者通過DevEco Studio把應用程序編譯為一個或者多個.hap后綴的文件,即HAP。HAP是HarmonyOS應用安裝的基本單位,包含了編譯后的代碼、資源、三方庫及配置文件。HAP可分為Entry和Feature兩種類型。
Entry類型的HAP:是應用的主模塊,在module.json5配置文件中的type標簽配置為“entry”類型。在同一個應用中,同一設備類型只支持一個Entry類型的HAP,通常用于實現應用的入口界面、入口圖標、主特性功能等。
Feature類型的HAP:是應用的動態特性模塊,在module.json5配置文件中的type標簽配置為“feature”類型。一個應用程序包可以包含一個或多個Feature類型的HAP,也可以不包含;Feature類型的HAP通常用于實現應用的特性功能,可以配置成按需下載安裝,也可以配置成隨Entry類型的HAP一起下載安裝(請參見module對象內部結構中的“deliveryWithInstall”)。
每個HarmonyOS應用可以包含多個.hap文件,一個應用中的.hap文件合在一起稱為一個Bundle,而bundleName就是應用的唯一標識(請參見app.json5配置文件中的bundleName標簽)。需要特別說明的是:在應用上架到應用市場時,需要把應用包含的所有.hap文件(即Bundle)打包為一個.app后綴的文件用于上架,這個.app文件稱為App Pack(Application Package),其中同時包含了描述App Pack屬性的pack.info文件;在云端(服務器)分發和終端設備安裝時,都是以HAP為單位進行分發和安裝的。
打包后的HAP包結構包括ets、libs、resources等文件夾和resources.index、module.json、pack.info等文件。
ets目錄用于存放應用代碼編譯后的字節碼文件。
libs目錄用于存放庫文件。庫文件是HarmonyOS應用依賴的第三方代碼(.so二進制文件)。
resources目錄用于存放應用的資源文件(字符串、圖片等),便于開發者使用和維護,詳見資源分類與訪問。
resources.index是資源索引表,由IDE編譯工程時生成。
module.json是HAP的配置文件,內容由工程配置中的module.json5和app.json5組成,該文件是HAP中必不可少的文件。IDE會自動生成一部分默認配置,開發者按需修改其中的配置。詳細字段請參見應用配置文件。
pack.info是Bundle中用于描述每個HAP屬性的文件,例如app中的bundleName和versionCode信息、module中的name、type和abilities等信息,由IDE工具生成Bundle包時自動生成。
圖2 應用程序包結構(Stage模型)