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