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

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

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

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

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

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

Entry類(lèi)型的HAP：是應(yīng)用的主模塊，在module.json5配置文件中的type標(biāo)簽配置為“entry”類(lèi)型。在同一個(gè)應(yīng)用中，同一設(shè)備類(lèi)型只支持一個(gè)Entry類(lèi)型的HAP，通常用于實(shí)現(xiàn)應(yīng)用的入口界面、入口圖標(biāo)、主特性功能等。

Feature類(lèi)型的HAP：是應(yīng)用的動(dòng)態(tài)特性模塊，在module.json5配置文件中的type標(biāo)簽配置為“feature”類(lèi)型。一個(gè)應(yīng)用程序包可以包含一個(gè)或多個(gè)Feature類(lèi)型的HAP，也可以不包含;Feature類(lèi)型的HAP通常用于實(shí)現(xiàn)應(yīng)用的特性功能，可以配置成按需下載安裝，也可以配置成隨Entry類(lèi)型的HAP一起下載安裝(請(qǐng)參見(jiàn)module對(duì)象內(nèi)部結(jié)構(gòu)中的“deliveryWithInstall”)。

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

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

ets目錄用于存放應(yīng)用代碼編譯后的字節(jié)碼文件。

libs目錄用于存放庫(kù)文件。庫(kù)文件是HarmonyOS應(yīng)用依賴(lài)的第三方代碼(.so二進(jìn)制文件)。

resources目錄用于存放應(yīng)用的資源文件(字符串、圖片等)，便于開(kāi)發(fā)者使用和維護(hù)，詳見(jiàn)資源分類(lèi)與訪問(wèn)。

resources.index是資源索引表，由IDE編譯工程時(shí)生成。

module.json是HAP的配置文件，內(nèi)容由工程配置中的module.json5和app.json5組成，該文件是HAP中必不可少的文件。IDE會(huì)自動(dòng)生成一部分默認(rèn)配置，開(kāi)發(fā)者按需修改其中的配置。詳細(xì)字段請(qǐng)參見(jiàn)應(yīng)用配置文件。

pack.info是Bundle中用于描述每個(gè)HAP屬性的文件，例如app中的bundleName和versionCode信息、module中的name、type和abilities等信息，由IDE工具生成Bundle包時(shí)自動(dòng)生成。

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