應(yīng)用模型開發(fā)指南上新介紹

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

指定實例模式演示效果

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

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

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

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

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

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

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

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

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

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

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

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

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

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

END

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

后臺留言給我們

立刻安排！

歡迎點擊｜閱讀原文｜

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