一屿附、基本概念解析
新版文檔中的知識點郎逃,介紹更全面,邏輯更清晰挺份,提供了各類基本概念解析褒翰,幫助開發(fā)者更快學習、掌握系統(tǒng)能力。以下是新版文檔部分概念展示优训。
1朵你、HAP是什么?
開發(fā)者通過DevEco Studio把應用程序編譯為一個或者多個.hap后綴的文件揣非,即HAP(Harmony Ability Package)抡医。HAP是HarmonyOS應用安裝的基本單位,包含了編譯后的代碼早敬、資源忌傻、三方庫及配置文件。HAP可分為Entry和Feature兩種類型搞监。
1)Entry類型的HAP:是應用的主模塊水孩,在module.json5中的type屬性配置為entry類型。在同一個應用中腺逛,同一設備類型只支持一個Entry類型的HAP荷愕,通常用于實現(xiàn)應用的入口界面、入口圖標棍矛、主特性功能等安疗。
2)Feature類型的HAP:是應用的動態(tài)特性模塊,在module.json5中的type屬性配置為feature類型够委。一個應用程序包可以包含一個或多個Feature類型的HAP荐类,也可以不包含;Feature類型的HAP通常用于實現(xiàn)應用的特性功能茁帽,可以配置成按需下載安裝玉罐,也可以配置成隨Entry類型的HAP一起下載安裝(請參見module對象內部結構中的“deliveryWithInstall”)。
2潘拨、Module是什么吊输?
在DevEco Studio工程目錄中,一個HAP對應一個Module铁追。
Module是指DevEco Studio工程中的功能單元季蚂。一個DevEco Studio工程可以包含多個Module,同時Module分為“Ability”琅束、“Library”兩種類型扭屁。此處的HAP對應“Ability”類型的Module;下文即將介紹的HAR(Harmony Ability Resources)包對應“Library”類型的Module涩禀。
3料滥、Bundle是什么?
每個HarmonyOS應用可以包含多個.hap文件艾船,這些.hap文件合在一起稱為一個Bundle葵腹,每個應用都有一個BundleName高每。在每臺設備上,已安裝應用的BundleName是唯一的践宴。需要特別說明的是:在應用上架到應用市場時觉义,需要把應用包含的所有.hap文件(即Bundle)打包為一個.app后綴的文件用于上架,這個.app文件稱為App Pack(Application Package)浴井,其中同時包含了描述App Pack屬性的pack.info文件晒骇;但是,在云端分發(fā)和端側安裝時磺浙,都是以HAP為單位進行分發(fā)和安裝的洪囤。
4、Ability組件概述
Ability組件是一種包含用戶界面的應用組件撕氧,用于與用戶交互匪蝙。Ability組件是系統(tǒng)調度的基本單元抓狭,為應用提供繪制界面的窗口蒙谓;一個Ability組件中可以通過多個頁面來實現(xiàn)一個模塊功能芝雪。
建議將不同模塊功能拆解為不同的Ability組件單獨實現(xiàn),即將一個獨立的功能模塊放到一個Ability組件中不脯,以多頁面的形式呈現(xiàn)府怯。每一個Ability組件實例,都對應于一個任務防楷,可以在最近任務列表中呈現(xiàn)牺丙。
在開發(fā)態(tài),一個Module可以包含一個或多個Ability組件复局,如下圖所示冲簿。
二、原理機制解讀
必要的原理亿昏、機制解讀峦剔,讓開發(fā)者“知其然,知其所以然”角钩。
為讓大家更好的理解系統(tǒng)工作原理吝沫,我們使用舉例、圖文結合等方式來詳細解讀原理機制彤断。接下來野舶,我們以Ability組件啟動模式—specified為例進行介紹易迹。
specified(指定實例模式)宰衙,在Ability實例創(chuàng)建之前,允許開發(fā)者為該實例創(chuàng)建一個唯一的字符串Key睹欲,創(chuàng)建的Ability實例綁定Key之后供炼,后續(xù)每次調用startAbility()方法時一屋,都會詢問應用使用哪個Key對應的Ability實例來響應startAbility請求。運行時由Ability內部業(yè)務決定是否創(chuàng)建多實例袋哼,如果匹配有該Ability實例的Key冀墨,則直接拉起與之綁定的Ability實例,否則創(chuàng)建一個新的Ability實例涛贯。
例如用戶在應用中重復打開同一個文檔時诽嘉,啟動的均是最近任務列表中的同一個任務。以及在應用中重復新建文檔時弟翘,啟動的均是最近任務列表中新的任務虫腋。這種情況下可以將Ability配置為specified(指定實例模式)。
三稀余、場景化開發(fā)指導
本次還補充/完善了20+個開發(fā)場景指導悦冀,只為讓文檔更貼近實際開發(fā)活動,助力開發(fā)者高效開發(fā)睛琳。以下為部分場景展示盒蟆。
1、如何實現(xiàn)Ability組件與UI數(shù)據(jù)同步
本次按場景提供了具體的開發(fā)指導师骗,主要包括:
使用EventHub進行數(shù)據(jù)通信:EventHub提供了Ability組件/ExtensionAbility組件級別的事件機制历等,以Ability組件/ExtensionAbility組件為中心提供了訂閱、取消訂閱和觸發(fā)事件的數(shù)據(jù)通信能力辟癌。
使用globalThis進行數(shù)據(jù)同步:globalThis是ArkTS引擎實例內部的一個全局對象募闲,引擎實例下的Ability/Page都可以使用,因此可以使用globalThis全局對象進行數(shù)據(jù)同步愿待。
2浩螺、跨Ability組件跳轉
詳細的場景化開發(fā)指導,主要包括:
啟動應用內的Ability:當一個應用內包含多個Ability時仍侥,存在應用內啟動Ability的場景要出。
啟動應用內的Ability并獲取返回結果:在一個EntryAbility啟動另外一個FuncAbility時,希望在被啟動的FuncAbility完成相關業(yè)務后农渊,能將結果返回給調用方患蹂。例如在應用中將入口功能和帳號登錄功能分別設計為兩個獨立的Ability,在帳號登錄Ability中完成登錄操作后砸紊,需要將登錄的結果返回給入口Ability传于。
啟動其他應用的Ability:啟動其他應用的Ability,通常用戶只需要完成一個通用的操作(例如需要選擇一個文檔應用來查看某個文檔的內容信息)醉顽,推薦使用隱式Want啟動沼溜。系統(tǒng)會根據(jù)調用方的want參數(shù)來識別和啟動匹配到的應用Ability。
啟動其他應用的Ability并獲取返回結果:當使用隱式Want啟動其他應用的Ability并希望獲取返回結果時游添,調用方需要使用startAbility-ForResult()方法啟動目標Ability系草。
啟動Ability的指定頁面:一個Ability可以對應多個頁面通熄,在不同的場景下啟動該Ability時需要展示不同的頁面,例如從一個Ability的頁面中啟動另外一個Ability時找都,希望啟動該Ability的指定頁面唇辨。本文主要講解目標Ability首次啟動和目標Ability非首次啟動兩種啟動指定頁面的場景,以及在講解啟動指定頁面之前會講解到在調用方如何指定啟動頁面能耻。