新版文檔中的知識點(diǎn)，介紹更全面，邏輯更清晰，提供了各類基本概念解析，幫助開發(fā)者更快學(xué)習(xí)、掌握系統(tǒng)能力。以下是新版文檔部分概念展示。

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

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

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

在DevEco Studio工程目錄中，一個(gè)HAP對應(yīng)一個(gè)Module。

Module是指DevEco Studio工程中的功能單元。一個(gè)DevEco Studio工程可以包含多個(gè)Module，同時(shí)Module分為“Ability”、“Library”兩種類型。此處的HAP對應(yīng)“Ability”類型的Module；下文即將介紹的HAR（Harmony Ability Resources）包對應(yīng)“Library”類型的Module。

每個(gè)HarmonyOS應(yīng)用可以包含多個(gè).hap文件，這些.hap文件合在一起稱為一個(gè)Bundle，每個(gè)應(yīng)用都有一個(gè)BundleName。在每臺設(shè)備上，已安裝應(yīng)用的BundleName是唯一的。需要特別說明的是：在應(yīng)用上架到應(yīng)用市場時(shí)，需要把應(yīng)用包含的所有.hap文件（即Bundle）打包為一個(gè).app后綴的文件用于上架，這個(gè).app文件稱為App Pack（Application Package），其中同時(shí)包含了描述App Pack屬性的pack.info文件；但是，在云端分發(fā)和端側(cè)安裝時(shí)，都是以HAP為單位進(jìn)行分發(fā)和安裝的。

Ability組件是一種包含用戶界面的應(yīng)用組件，用于與用戶交互。Ability組件是系統(tǒng)調(diào)度的基本單元，為應(yīng)用提供繪制界面的窗口；一個(gè)Ability組件中可以通過多個(gè)頁面來實(shí)現(xiàn)一個(gè)模塊功能。

建議將不同模塊功能拆解為不同的Ability組件單獨(dú)實(shí)現(xiàn)，即將一個(gè)獨(dú)立的功能模塊放到一個(gè)Ability組件中，以多頁面的形式呈現(xiàn)。每一個(gè)Ability組件實(shí)例，都對應(yīng)于一個(gè)任務(wù)，可以在最近任務(wù)列表中呈現(xiàn)。

在開發(fā)態(tài)，一個(gè)Module可以包含一個(gè)或多個(gè)Ability組件，如下圖所示。

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

必要的原理、機(jī)制解讀，讓開發(fā)者“知其然，知其所以然”。

為讓大家更好的理解系統(tǒng)工作原理，我們使用舉例、圖文結(jié)合等方式來詳細(xì)解讀原理機(jī)制。接下來，我們以Ability組件啟動(dòng)模式—specified為例進(jìn)行介紹。

specified（指定實(shí)例模式），在Ability實(shí)例創(chuàng)建之前，允許開發(fā)者為該實(shí)例創(chuàng)建一個(gè)唯一的字符串Key，創(chuàng)建的Ability實(shí)例綁定Key之后，后續(xù)每次調(diào)用startAbility()方法時(shí)，都會(huì)詢問應(yīng)用使用哪個(gè)Key對應(yīng)的Ability實(shí)例來響應(yīng)startAbility請求。運(yùn)行時(shí)由Ability內(nèi)部業(yè)務(wù)決定是否創(chuàng)建多實(shí)例，如果匹配有該Ability實(shí)例的Key，則直接拉起與之綁定的Ability實(shí)例，否則創(chuàng)建一個(gè)新的Ability實(shí)例。

例如用戶在應(yīng)用中重復(fù)打開同一個(gè)文檔時(shí)，啟動(dòng)的均是最近任務(wù)列表中的同一個(gè)任務(wù)。以及在應(yīng)用中重復(fù)新建文檔時(shí)，啟動(dòng)的均是最近任務(wù)列表中新的任務(wù)。這種情況下可以將Ability配置為specified（指定實(shí)例模式）。

指定實(shí)例模式演示效果

本次還補(bǔ)充/完善了20+個(gè)開發(fā)場景指導(dǎo)，只為讓文檔更貼近實(shí)際開發(fā)活動(dòng)，助力開發(fā)者高效開發(fā)。以下為部分場景展示。

本次按場景提供了具體的開發(fā)指導(dǎo)，主要包括：

使用EventHub進(jìn)行數(shù)據(jù)通信：EventHub提供了Ability組件/ExtensionAbility組件級別的事件機(jī)制，以Ability組件/ExtensionAbility組件為中心提供了訂閱、取消訂閱和觸發(fā)事件的數(shù)據(jù)通信能力。

使用globalThis進(jìn)行數(shù)據(jù)同步：globalThis是ArkTS引擎實(shí)例內(nèi)部的一個(gè)全局對象，引擎實(shí)例下的Ability/Page都可以使用，因此可以使用globalThis全局對象進(jìn)行數(shù)據(jù)同步。

詳細(xì)的場景化開發(fā)指導(dǎo)，主要包括：

啟動(dòng)應(yīng)用內(nèi)的Ability：當(dāng)一個(gè)應(yīng)用內(nèi)包含多個(gè)Ability時(shí)，存在應(yīng)用內(nèi)啟動(dòng)Ability的場景。

啟動(dòng)應(yīng)用內(nèi)的Ability并獲取返回結(jié)果：在一個(gè)EntryAbility啟動(dòng)另外一個(gè)FuncAbility時(shí)，希望在被啟動(dòng)的FuncAbility完成相關(guān)業(yè)務(wù)后，能將結(jié)果返回給調(diào)用方。例如在應(yīng)用中將入口功能和帳號登錄功能分別設(shè)計(jì)為兩個(gè)獨(dú)立的Ability，在帳號登錄Ability中完成登錄操作后，需要將登錄的結(jié)果返回給入口Ability。

啟動(dòng)其他應(yīng)用的Ability：啟動(dòng)其他應(yīng)用的Ability，通常用戶只需要完成一個(gè)通用的操作（例如需要選擇一個(gè)文檔應(yīng)用來查看某個(gè)文檔的內(nèi)容信息），推薦使用隱式Want啟動(dòng)。系統(tǒng)會(huì)根據(jù)調(diào)用方的want參數(shù)來識別和啟動(dòng)匹配到的應(yīng)用Ability。

啟動(dòng)其他應(yīng)用的Ability并獲取返回結(jié)果：當(dāng)使用隱式Want啟動(dòng)其他應(yīng)用的Ability并希望獲取返回結(jié)果時(shí)，調(diào)用方需要使用startAbility-ForResult()方法啟動(dòng)目標(biāo)Ability。

啟動(dòng)Ability的指定頁面：一個(gè)Ability可以對應(yīng)多個(gè)頁面，在不同的場景下啟動(dòng)該Ability時(shí)需要展示不同的頁面，例如從一個(gè)Ability的頁面中啟動(dòng)另外一個(gè)Ability時(shí)，希望啟動(dòng)該Ability的指定頁面。本文主要講解目標(biāo)Ability首次啟動(dòng)和目標(biāo)Ability非首次啟動(dòng)兩種啟動(dòng)指定頁面的場景，以及在講解啟動(dòng)指定頁面之前會(huì)講解到在調(diào)用方如何指定啟動(dòng)頁面。

以上就是本期文檔君為大家準(zhǔn)備的HarmonyOS應(yīng)用程序包基礎(chǔ)知識及應(yīng)用模型開發(fā)指南上新內(nèi)容，希望能夠幫助開發(fā)者更高效的探索、體驗(yàn)、上手HarmonyOS。

同時(shí)，我們十分重視開發(fā)者的意見，歡迎各位開發(fā)者在HarmonyOS應(yīng)用開發(fā)官網(wǎng)積極反饋意見，幫助我們持續(xù)提升文檔體驗(yàn)。

我們將持續(xù)改進(jìn)文檔體驗(yàn)、豐富和完善內(nèi)容，感謝各位開發(fā)者的支持及信賴，您的滿意是我們持續(xù)提升文檔體驗(yàn)的目標(biāo)和動(dòng)力。

敬請期待HarmonyOS開發(fā)者公眾號更多相關(guān)推送，獲取最新文檔和內(nèi)容資源！

END

想了解更多HarmonyOS技術(shù)？

后臺留言給我們

立刻安排！

歡迎點(diǎn)擊｜閱讀原文｜

了解應(yīng)用模型開發(fā)指南