基礎(chǔ)知識(shí)

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

開發(fā)并打包完成后的App的程序包結(jié)構(gòu)如圖

1. 開發(fā)者通過DevEco Studio把應(yīng)用程序編譯為一個(gè)或者多個(gè).hap后綴的文件，即HAP
2. 一個(gè)應(yīng)用中的.hap文件合在一起稱為一個(gè)Bundle曹仗，bundleName是應(yīng)用的唯一標(biāo)識(shí)

需要特別說明的是：在應(yīng)用上架到應(yīng)用市場(chǎng)時(shí)，需要把應(yīng)用包含的所有.hap文件（即Bundle）打包為一個(gè).app后綴的文件用于上架蠕搜，這個(gè).app文件稱為App Pack（Application Package）怎茫，其中同時(shí)包含了描述App Pack屬性的pack.info文件；在云端（服務(wù)器）分發(fā)和終端設(shè)備安裝時(shí)妓灌，都是以HAP為單位進(jìn)行分發(fā)和安裝的轨蛤。

3. 所有的HAP最終會(huì)編譯到一個(gè)App Pack中（以.app為后綴的包文件）蜜宪，用于發(fā)布到應(yīng)用市場(chǎng)

HAP

1. HAP是HarmonyOS應(yīng)用安裝的基本單位，包含了編譯后的代碼祥山、資源圃验、三方庫及配置文件
2. 打包后的HAP包結(jié)構(gòu)包括ets、libs枪蘑、resources等文件夾和resources.index损谦、module.json、pack.info等文件岳颇。

• ets目錄用于存放應(yīng)用代碼編譯后的字節(jié)碼文件
• libs目錄用于存放庫文件照捡。庫文件是HarmonyOS應(yīng)用依賴的第三方代碼（.so二進(jìn)制文件）。
• resources目錄用于存放應(yīng)用的資源文件（字符串话侧、圖片等）
• resources.index是資源索引表栗精，由IDE編譯工程時(shí)生成
• module.json是HAP的配置文件，內(nèi)容由工程配置中的module.json5和app.json5組成瞻鹏，該文件是HAP中必不可少的文件悲立。

Entry類型的HAP

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

Feature類型的HAP

1. 應(yīng)用的動(dòng)態(tài)特性模塊埂淮，在 module.json5配置文件 中的type標(biāo)簽配置為“feature”類型姑隅。
2. 一個(gè)應(yīng)用程序包可以包含一個(gè)或多個(gè)Feature類型的HAP，也可以不包含倔撞；
3. Feature類型的HAP通常用于實(shí)現(xiàn)應(yīng)用的特性功能讲仰，可以配置成按需下載安裝，也可以配置成隨Entry類型的HAP一起下載安裝

Module

1. 一個(gè)開發(fā)態(tài)的Module編譯后生成一個(gè)部署態(tài)的HAP痪蝇，Module和HAP一一對(duì)應(yīng)
2. Module是HarmonyOS應(yīng)用/服務(wù)的基本功能單元鄙陡，包含了源代碼、資源文件躏啰、第三方庫及應(yīng)用/服務(wù)配置文件柔吼，每一個(gè)Module都可以獨(dú)立進(jìn)行編譯和運(yùn)行。一個(gè)DevEco Studio工程可以包含多個(gè)Module
3. Module分為“Ability”和“Library”兩種類型

• “Ability”類型的Module對(duì)應(yīng)于編譯后的HAP（Harmony Ability Package）丙唧；
• “Library”類型的Module對(duì)應(yīng)于 HAR 靜態(tài)共享包（Harmony Archive）愈魏，或者 HSP 動(dòng)態(tài)共享包（Harmony Shared Package）

4. 一個(gè)Module可以包含一個(gè)或多個(gè) UIAbility 組件

• 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í)例牌柄，都對(duì)應(yīng)于一個(gè)任務(wù)畸悬，可以在最近任務(wù)列表中呈現(xiàn)

鴻蒙支持快速修復(fù)包

快速修復(fù)包結(jié)構(gòu)

appqf（Application Quick Fix）

1. appqf與應(yīng)用的app pack包是一一對(duì)應(yīng)關(guān)系
2. appqf包是HarmonyOS應(yīng)用用于發(fā)布到應(yīng)用市場(chǎng)的單元，不能夠直接安裝到設(shè)備上
3. 由一個(gè)或多個(gè)hqf組成珊佣，這些hqf包在應(yīng)用市場(chǎng)會(huì)從appqf包中拆分出來蹋宦，再被分發(fā)到具體的設(shè)備上

hqf（Harmony Ability Package Quick Fix）

1. hqf包是修復(fù)HAP中問題的快速修復(fù)包，用于安裝到設(shè)備上的快速修復(fù)單元
2. 一個(gè)hqf可以包含.abc的快速修復(fù)文件咒锻，.so的快速修復(fù)文件和描述該包的配置文件

• .abc文件：應(yīng)用中修改后的ts代碼冷冗，編譯后生成的字節(jié)碼文件
• libs目錄：存放.so庫文件的差分文件，以.so.diff為后綴惑艇。區(qū)分的不同的系統(tǒng)cpu架構(gòu)蒿辙，例如arm平臺(tái)、x86平臺(tái)
• patch.json：用于描述hqf包版本信息的配置文件滨巴，由開發(fā)者填寫

快速修復(fù)包的發(fā)布部署流程

Stage模型

應(yīng)用組件

AbilityStage組件容器

1. AbilityStage是一個(gè) Module 級(jí)別的組件容器思灌，應(yīng)用的HAP在首次加載時(shí)會(huì)創(chuàng)建一個(gè)AbilityStage實(shí)例，可以對(duì)該Module進(jìn)行初始化等操作
2. AbilityStage與Module一一對(duì)應(yīng)恭取，即一個(gè)Module擁有一個(gè)AbilityStage
3. AbilityStage 擁有 onCreate()] 生命周期回調(diào)和 onAcceptWant() 泰偿、onConfigurationUpdated()、onMemoryLevel() 事件回調(diào)

onCreate() 生命周期回調(diào)

1. 在開始加載對(duì)應(yīng)Module的第一個(gè)UIAbility實(shí)例之前會(huì)先創(chuàng)建AbilityStage蜈垮，并在AbilityStage創(chuàng)建完成之后執(zhí)行其onCreate()生命周期回調(diào)
2. AbilityStage模塊提供在Module加載的時(shí)候甜奄，通知開發(fā)者，可以在此進(jìn)行該Module的初始化（如資源預(yù)加載窃款，線程創(chuàng)建等）能力

onAcceptWant()事件回調(diào)

UIAbility 指定實(shí)例模式（specified）啟動(dòng)時(shí)候觸發(fā)的事件回調(diào)

onConfigurationUpdated()事件回調(diào)

當(dāng)系統(tǒng)全局配置發(fā)生變更時(shí)觸發(fā)的事件，系統(tǒng)語言牍氛、深淺色等晨继，配置項(xiàng)目前均定義在 Configuration 類中

onMemoryLevel() 事件回調(diào)

當(dāng)系統(tǒng)調(diào)整內(nèi)存時(shí)觸發(fā)的事件

應(yīng)用上下文Context

1. Context 是應(yīng)用中對(duì)象的上下文，其提供了應(yīng)用的一些基礎(chǔ)信息
2. UIAbility組件和各種ExtensionAbility派生類組件都有各自不同的Context類搬俊。分別有基類Context紊扬、ApplicationContext、AbilityStageContext唉擂、UIAbilityContext餐屎、ExtensionContext、ServiceExtensionContext等Context

UIAbility組件

• 包含UI界面玩祟，提供展示UI的能力腹缩，主要用于和用戶交互。詳細(xì)介紹請(qǐng)參見 UIAbility組件概述。

UIAbility組件生命周期

UIAbility組件啟動(dòng)模式

• singleton（單實(shí)例模式）

1. 每次調(diào)用startAbility()方法時(shí)藏鹊，如果應(yīng)用進(jìn)程中該類型的UIAbility實(shí)例已經(jīng)存在润讥，則復(fù)用系統(tǒng)中的UIAbility實(shí)例。
2. 系統(tǒng)中只存在唯一一個(gè)該UIAbility實(shí)例盘寡，即在最近任務(wù)列表中只存在一個(gè)該類型的UIAbility實(shí)例
3. 在 module.json5配置文件 中的"launchType"字段配置為"singleton"

• standard（標(biāo)準(zhǔn)實(shí)例模式）

1. 每次調(diào)用startAbility()方法時(shí)楚殿，都會(huì)在應(yīng)用進(jìn)程中創(chuàng)建一個(gè)新的該類型UIAbility實(shí)例
2. 即在最近任務(wù)列表中可以看到有多個(gè)該類型的UIAbility實(shí)例
3. 在 module.json5配置文件 中的"launchType"字段配置為"standard"

• specified（指定實(shí)例模式）

1. 在UIAbility實(shí)例創(chuàng)建之前，允許開發(fā)者為該實(shí)例創(chuàng)建一個(gè)唯一的字符串Key
2. 創(chuàng)建的UIAbility實(shí)例綁定Key之后竿痰，后續(xù)每次調(diào)用startAbility()方法時(shí)脆粥，都會(huì)詢問應(yīng)用使用哪個(gè)Key對(duì)應(yīng)的UIAbility實(shí)例來響應(yīng)startAbility()請(qǐng)求。通過AbilityStage的onAcceptWant實(shí)現(xiàn)
3. 運(yùn)行時(shí)由UIAbility內(nèi)部業(yè)務(wù)決定是否創(chuàng)建多實(shí)例影涉，如果匹配有該UIAbility實(shí)例的Key变隔，則直接拉起與之綁定的UIAbility實(shí)例，否則創(chuàng)建一個(gè)新的UIAbility實(shí)例
4. module.json5配置文件 的"launchType"字段配置為"specified"

UIAbility組件與UI的數(shù)據(jù)同步

基于HarmonyOS的應(yīng)用模型常潮，可以通過以下兩種方式來實(shí)現(xiàn)UIAbility組件與UI之間的數(shù)據(jù)同步

1. EventHub：基于發(fā)布訂閱模式來實(shí)現(xiàn)弟胀，事件需要先訂閱后發(fā)布，訂閱者收到消息后進(jìn)行處理喊式。

• 在使用EventHub之前孵户，首先需要獲取EventHub對(duì)象〔砹簦基類Context 提供了EventHub對(duì)象

2. globalThis：ArkTS引擎實(shí)例內(nèi)部的一個(gè)全局對(duì)象夏哭，在ArkTS引擎實(shí)例內(nèi)部都能訪問

UIAbility組件間交互（設(shè)備內(nèi)）

1. UIAbility是系統(tǒng)調(diào)度的最小單元。在設(shè)備內(nèi)的功能模塊之間跳轉(zhuǎn)時(shí)献联，會(huì)涉及到啟動(dòng)特定的UIAbility竖配，該UIAbility可以是應(yīng)用內(nèi)的其他UIAbility，也可以是其他應(yīng)用的UIAbility
2. 通過調(diào)用startAbility并傳遞給它 want 參數(shù)啟動(dòng)其他UIAbility里逆，如果期望其他Ability返回結(jié)果則可以使用startAbilityForResult

• want中如果傳入了abilityName則進(jìn)行顯示跳轉(zhuǎn)进胯，否則進(jìn)行隱式跳轉(zhuǎn)

ExtensionAbility組件

提供特定場(chǎng)景（如卡片、輸入法）的擴(kuò)展能力原押，滿足更多的使用場(chǎng)景胁镐。詳細(xì)介紹請(qǐng)參見 ExtensionAbility組件。

FormExtensionAbility ：FORM類型的ExtensionAbility組件诸衔，用于提供服務(wù)卡片場(chǎng)景相關(guān)能力

ArkTS運(yùn)行機(jī)制

進(jìn)程模型

Stage模型有三類進(jìn)程盯漂，是從系統(tǒng)總體資源占用考慮，希望由系統(tǒng)負(fù)責(zé)應(yīng)用進(jìn)程的創(chuàng)建和銷毀笨农。所以不支持應(yīng)用自定義配置多進(jìn)程就缆，也不支持通過接口啟動(dòng)進(jìn)程

主進(jìn)程

開發(fā)者編寫的UIAbility入口及其依賴的代碼都在該進(jìn)程中運(yùn)行。它是由UIAbility組件的啟動(dòng)觸發(fā)創(chuàng)建的谒亦。

ExtensionAbility進(jìn)程

開發(fā)者編寫的同一種類型的ExtensionAbility組件實(shí)例都會(huì)在同一個(gè)進(jìn)程中運(yùn)行竭宰。不同類型的ExtensionAbility組件實(shí)例則在不同的進(jìn)程中運(yùn)行空郊。該類進(jìn)程是由系統(tǒng)服務(wù)在特定場(chǎng)景下創(chuàng)建，并根據(jù)用戶對(duì)特定場(chǎng)景的使用羞延，決定其何時(shí)銷毀渣淳。同時(shí)該類進(jìn)程獨(dú)立于主進(jìn)程創(chuàng)建，并且不支持與主進(jìn)程之間進(jìn)行IPC通信

渲染進(jìn)程

為了支持WebView的運(yùn)行伴箩，每個(gè)應(yīng)用只能創(chuàng)建一個(gè)Render進(jìn)程用于運(yùn)行WebView的渲染引擎入愧。這個(gè)Render進(jìn)程也是由系統(tǒng)負(fù)責(zé)創(chuàng)建和銷毀

基于HarmonyOS的進(jìn)程模型，系統(tǒng)提供了 公共事件機(jī)制 用于一對(duì)多的通信場(chǎng)景嗤谚，公共事件發(fā)布者可能存在多個(gè)訂閱者同時(shí)接收事件

線程模型

1. ArkTS引擎實(shí)例的創(chuàng)建 一個(gè)進(jìn)程可以運(yùn)行多個(gè)應(yīng)用組件實(shí)例棺蛛，所有應(yīng)用組件實(shí)例共享一個(gè)ArkTS引擎實(shí)例。
2. 線程模型 ArkTS引擎實(shí)例在主線程上創(chuàng)建巩步。
3. 進(jìn)程內(nèi)支持對(duì)象共享

HarmonyOS應(yīng)用中每個(gè)進(jìn)程都會(huì)有一個(gè)主線程旁赊，主線程有如下職責(zé)：

1. 執(zhí)行UI繪制；
2. 管理主線程的ArkTS引擎實(shí)例椅野，使多個(gè)UIAbility組件能夠運(yùn)行在其之上终畅；
3. 管理其他線程（例如Worker線程）的ArkTS引擎實(shí)例，例如啟動(dòng)和終止其他線程竟闪；
4. 分發(fā)交互事件离福；
5. 處理應(yīng)用代碼的回調(diào)，包括事件處理和生命周期管理炼蛤；
6. 接收Worker線程發(fā)送的消息妖爷；

HarmonyOS可以使用Worker線程執(zhí)行耗時(shí)操作，這些線程無法直接操作UI理朋。Worker線程在主線程中創(chuàng)建絮识，與主線程相互獨(dú)立。最多可以創(chuàng)建8個(gè)Worker

線程間通信目前主要有Emitter和Worker兩種方式嗽上，其中Emitter主要適用于線程間的事件同步次舌， Worker主要用于新開一個(gè)線程執(zhí)行耗時(shí)任務(wù)

Stage模型只提供了主線程和Worker線程，Emitter主要用于主線程內(nèi)或者主線程和Worker線程的事件同步

應(yīng)用配置文件

使用app.json5描述應(yīng)用信息兽愤，module.json5描述HAP信息彼念、應(yīng)用組件信息