鴻蒙開發(fā)Ability Kit程序框架服務(wù)：FA模型切換Stage模型指導(dǎo) module的切換
module的切換
從FA模型切換到Stage模型時，開發(fā)者需要將config.json文件module標(biāo)簽下的配置遷移到module.json5配置文件module標(biāo)簽下，具體差異見下列表格。 開發(fā)前請熟悉鴻蒙開發(fā)指導(dǎo)文檔 ：[gitee.com/li-shizhen-skin/harmony-os/blob/master/README.md]
表1 FA模型module標(biāo)簽與Stage模型module標(biāo)簽差異對比
| FA標(biāo)簽 | 標(biāo)簽說明 | 對應(yīng)的Stage標(biāo)簽 | 差異說明 |
|---|---|---|---|
| mainAbility | 服務(wù)中心圖標(biāo)露出的ability，常駐進(jìn)程拉起時會啟動mainAbility。 | mainElement | 標(biāo)簽名稱變更，Stage模型不在使用“.”符號。 |
| package | 標(biāo)識HAP的包結(jié)構(gòu)名稱，在應(yīng)用內(nèi)保證唯一性。 | / | Stage模型使用name來保證應(yīng)用唯一性。FA模型升級到Stage模型時，Stage模型的name需要和FA模型的package保持一致，否則會導(dǎo)致升級失敗。 |
| name | 標(biāo)識HAP的類名。 | / | FA模型中實(shí)際未使能，Stage模型沒有與之對應(yīng)的標(biāo)簽。 |
| supportedModes | 標(biāo)識應(yīng)用支持的運(yùn)行模式，當(dāng)前只定義了駕駛模式（drive）。 | / | Stage模型已廢棄。 |
| distro對象中的moduleName | 標(biāo)識當(dāng)前HAP的名稱。distro對象中的moduleName。 | name | 標(biāo)簽變更。 |
| distro對象中的moduleType | 標(biāo)識當(dāng)前HAP的類型，包括兩種類型：entry和feature。另外，如果表示HAR包類型，請設(shè)置為har。 | type | 標(biāo)簽變更。 |
| distro對象中的installationFree | 標(biāo)識當(dāng)前HAP是否支持免安裝特性。 | installationFree | 標(biāo)簽變更。 |
| distro對象中的deliveryWithInstall | 標(biāo)識當(dāng)前HAP是否支持隨應(yīng)用安裝。 | deliveryWithInstall | 標(biāo)簽變更。 |
| metaData | 標(biāo)識HAP的元信息。 | metadata | 具體差異見表2。 |
| abilities | 標(biāo)識當(dāng)前模塊內(nèi)的所有Ability。 | abilities | 具體差異見表5。 |
| js | 標(biāo)識基于ArkUI框架開發(fā)的JS模塊集合，其中的每個元素代表一個JS模塊的信息。 | pages | Stage模型在module標(biāo)簽下保留該對象中的pages，window配置與pages的下一級。 |
| shortcuts | 標(biāo)識應(yīng)用的快捷方式信息。 | shortcut_config.json文件 | 在開發(fā)視圖的resources/base/profile下面定義配置文件shortcut_config.json。 |
| reqPermissions | 標(biāo)識應(yīng)用運(yùn)行時向系統(tǒng)申請的權(quán)限。 | requestPermissions | 標(biāo)簽名稱變更。 |
| colorMode | 標(biāo)識應(yīng)用自身的顏色模式。 | / | Stage模型不支持。 |
| distroFilter | 標(biāo)識應(yīng)用的分發(fā)規(guī)則。 | distributionFilter_config.json文件 | Stage模型在開發(fā)視圖的resources/base/profile下面定義配置文件distributionFilter_config.json。 |
| reqCapabilities | 標(biāo)識運(yùn)行應(yīng)用程序所需的設(shè)備能力。 | / | Stage模型不支持。 |
| commonEvents | 公共事件。 | common_event_config.json文件 | Stage模型在開發(fā)視圖的resources/base/profile下面定義配置文件common_event_config.json。 |
| entryTheme | 此標(biāo)簽標(biāo)識系統(tǒng)內(nèi)部主題的關(guān)鍵字。 | / | Stage模型不支持。 |
表2 FA模型metaData和Stage中metadata對比
| FA標(biāo)簽 | 標(biāo)簽說明 | 對應(yīng)的Stage模型標(biāo)簽 | 差異對比 |
|---|---|---|---|
| parameters | 標(biāo)識調(diào)用Ability時所有調(diào)用參數(shù)的元信息。 | / | Stage模型不支持。 |
| results | 標(biāo)識Ability返回值的元信息。 | / | Stage模型不支持。 |
| customizeData | 該標(biāo)簽標(biāo)識父級組件的自定義元信息，Parameters和results在application不可配。 | metadata | 具體差異見表3。 |
表3 FA模型metaData的customizeData和Stage中metadata對比
| FA標(biāo)簽 | 標(biāo)簽說明 | 對應(yīng)的Stage模型標(biāo)簽 | 差異對比 |
|---|---|---|---|
| name | 標(biāo)識數(shù)據(jù)項(xiàng)的鍵名稱。字符串最大長度為255字節(jié)。 | name | 無。 |
| value | 標(biāo)識數(shù)據(jù)項(xiàng)的值。字符串最大長度為255字節(jié)。 | value | 無。 |
| extra | 標(biāo)識當(dāng)前custom數(shù)據(jù)的格式，取值為表示extra的資源值。 | resource | 標(biāo)簽變更。具體實(shí)例見表4。 |
表4 FA模型metaData和Stage中metadata示例
| FA模型示例 | Stage模型示例 |
|---|---|
| “meteData”: { "customizeDate": [{ "name": "label", "value": "string", "extra": "**string:label", }] } | “meteData”: [{ "name": "label", "value": "string", "resource": "**string:label", }] |
表5 FA模型和Stage中abilities差異對比
| FA模型的abilities對象標(biāo)簽 | 描述HarmonyOS與OpenHarmony鴻蒙文檔籽料：mau123789是v直接拿 | Stage模型中abilities對象標(biāo)簽 | 差異對比 |
|---|---|---|---|
| process | 運(yùn)行應(yīng)用程序或Ability的進(jìn)程名稱。 | / | Stage模型不支持abilities中配置，在module標(biāo)簽下配置process。 |
| uri | 標(biāo)識Ability的統(tǒng)一資源標(biāo)識符。 | / | Stage模型不支持。 |
| deviceCapability | 標(biāo)識Ability運(yùn)行時要求設(shè)備具有的能力，采用字符串?dāng)?shù)組的格式表示。 | / | Stage模型不支持。 |
| metaData | 該標(biāo)簽標(biāo)識ability的元信息。 | metadata | 具體差異見表2。 |
| type | 標(biāo)識Ability的類型。 | / | Stage模型不支持。 |
| grantPermission | 指定是否可以向Ability內(nèi)任何數(shù)據(jù)授予權(quán)限。 | / | abilities內(nèi)不支持。 |
| readPermission | 標(biāo)識讀取Ability的數(shù)據(jù)所需的權(quán)限。該標(biāo)簽僅適用于data類型的Ability。 | / | abilities內(nèi)不支持，在extensionAbilities標(biāo)簽中支持。 |
| writePermission | 標(biāo)識向Ability寫數(shù)據(jù)所需的權(quán)限。 | / | abilities內(nèi)不支持，在extensionAbilities標(biāo)簽中支持。 |
| configChanges | 標(biāo)識Ability關(guān)注的系統(tǒng)配置集合。 | / | Stage模型不支持。 |
| mission | 標(biāo)識Ability指定的任務(wù)棧。 | / | Stage模型不支持。 |
| targetAbility | 標(biāo)識當(dāng)前Ability重用的目標(biāo)Ability。 | / | Stage模型不支持。 |
| multiUserShared | 標(biāo)識Ability是否支持多用戶狀態(tài)進(jìn)行共享，該標(biāo)簽僅適用于data類型的Ability。 | / | Stage模型不支持。 |
| supportPipMode | 標(biāo)識Ability是否支持用戶進(jìn)入PIP模式（用于在頁面最上層懸浮小窗口，俗稱"畫中畫"，常見于視頻播放等場景）。 | / | Stage模型不支持。 |
| formsEnabled | 標(biāo)識Ability是否支持卡片（forms）功能。 | / | Stage模型不支持。 |
| forms | 標(biāo)識服務(wù)卡片的屬性。該標(biāo)簽僅當(dāng)formsEnabled為"true"時，才能生效。 | form_config.json文件 | Stage模型在開發(fā)視圖的resources/base/profile下面定義配置文件form_config.json。 |
| srcLanguage | Ability開發(fā)語言的類型。 | / | Stage模型不支持。 |
| srcPath | 該標(biāo)簽標(biāo)識Ability對應(yīng)的JS組件代碼路徑。 | srcEntry | 該標(biāo)簽標(biāo)識ability所對應(yīng)的js代碼路徑。 |
| uriPermission | 標(biāo)識該Ability有權(quán)訪問的應(yīng)用程序數(shù)據(jù)。 | / | Stage模型不支持。 |
審核編輯 黃宇
聲明：本文內(nèi)容及配圖由入駐作者撰寫或者入駐合作網(wǎng)站授權(quán)轉(zhuǎn)載。文章觀點(diǎn)僅代表作者本人，不代表電子發(fā)燒友網(wǎng)立場。文章及其配圖僅供工程師學(xué)習(xí)之用，如有內(nèi)容侵權(quán)或者其他違規(guī)問題，請聯(lián)系本站處理。
舉報投訴
-
程序員
+關(guān)注
關(guān)注
4文章
950瀏覽量
29768 -
鴻蒙
+關(guān)注
關(guān)注
57文章
2321瀏覽量
42749 -
HarmonyOS
+關(guān)注
關(guān)注
79文章
1967瀏覽量
30033 -
OpenHarmony
+關(guān)注
關(guān)注
25文章
3665瀏覽量
16161 -
鴻蒙OS
+關(guān)注
關(guān)注
0文章
188瀏覽量
4371
發(fā)布評論請先 登錄
相關(guān)推薦
鴻蒙元服務(wù)萬能卡片開發(fā)-stage模型和fa模型的卡片區(qū)別
一、項(xiàng)目類型
Application： 應(yīng)用開發(fā)
Atomic Service：原子化服務(wù)開發(fā)
這里選擇Empty Ability模板創(chuàng)建項(xiàng)目。
二、
發(fā)表于 05-22 14:20
鴻蒙開發(fā)Ability Kit程序框架服務(wù)：FA模型與Stage模型應(yīng)用組件互通綜述
FA模型與Stage模型是兩套不同的應(yīng)用模型，他們擁有各自的組件。FA
鴻蒙開發(fā)Ability Kit程序框架服務(wù)：FA模型啟動Stage模型UIAbility
本文介紹FA模型的三種應(yīng)用組件如何啟動Stage模型的UIAbility組件。
鴻蒙開發(fā)Ability Kit程序框架服務(wù)：FA模型綁定Stage模型ServiceExtensionAbility
本文介紹FA模型的三種應(yīng)用組件如何綁定Stage模型的ServiceExtensionAbility組件。
鴻蒙開發(fā)Ability Kit程序框架服務(wù)：FA模型訪問Stage模型DataShareExtensionAbility
無論FA模型還是Stage模型，數(shù)據(jù)讀寫功能都包含客戶端和服務(wù)端兩部分。
鴻蒙開發(fā)Ability Kit程序框架服務(wù)：Stage模型啟動FA模型PageAbility
本小節(jié)介紹Stage模型的兩種應(yīng)用組件如何啟動FA模型的PageAbility組件。
鴻蒙開發(fā)Ability Kit程序框架服務(wù)：Stage模型綁定FA模型ServiceAbility
本小節(jié)介紹Stage模型的兩種應(yīng)用組件如何綁定FA模型ServiceAbility組件。
鴻蒙開發(fā)Ability Kit程序框架服務(wù)：FA模型切換Stage模型概述
本文介紹如何將一個FA模型開發(fā)的聲明式范式應(yīng)用切換到Stage模型
鴻蒙開發(fā)Ability Kit程序框架服務(wù)：FA模型切換Stage模型指導(dǎo) 配置文件差異
FA模型應(yīng)用在[config.json文件]中描述應(yīng)用的基本信息，一個應(yīng)用工程中可以創(chuàng)建多個Module，每個Module中都有一份config.json文件。config.json由
鴻蒙開發(fā)Ability Kit程序框架服務(wù)：FA模型切換Stage模型指導(dǎo) app和deviceConfig的切換
為了便于開發(fā)者維護(hù)應(yīng)用級別的屬性配置，Stage模型將config.json中的app和deviceConfig標(biāo)簽提取到了app.json5中進(jìn)行配置，并對部分標(biāo)簽名稱進(jìn)行了修改，具體差異見下表。
鴻蒙開發(fā)Ability Kit程序框架服務(wù)：PageAbility切換 組件切換
FA模型中PageAbility對應(yīng)Stage模型中的UIAbility，PageAbility切換為UIAbility的方法如下。
鴻蒙開發(fā)Ability Kit程序框架服務(wù)：ServiceAbility切換 組件切換
FA模型中的ServiceAbility對應(yīng)Stage模型中的ServiceExtensionAbility。Stage
鴻蒙開發(fā)Ability Kit程序框架服務(wù)：DataAbility切換 組件切換
FA模型中的DataAbility對應(yīng)Stage模型中的DataShareExtensionAbility。
鴻蒙開發(fā)Ability Kit程序框架服務(wù)：API切換概述 API切換
FA模型和Stage模型由于線程模型和進(jìn)程模型的差異，部分接口僅在
工商網(wǎng)監(jiān)
評論