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,常駐進程拉起時會啟動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模型中實際未使能,Stage模型沒有與之對應(yīng)的標(biāo)簽。 |
| supportedModes | 標(biāo)識應(yīng)用支持的運行模式,當(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)用運行時向系統(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ī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ù)項的鍵名稱。字符串最大長度為255字節(jié)。 | name | 無。 |
| value | 標(biāo)識數(shù)據(jù)項的值。字符串最大長度為255字節(jié)。 | value | 無。 |
| extra | 標(biāo)識當(dāng)前custom數(shù)據(jù)的格式,取值為表示extra的資源值。 | resource | 標(biāo)簽變更。具體實例見表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īng)用程序或Ability的進程名稱。 | / | Stage模型不支持abilities中配置,在module標(biāo)簽下配置process。 |
| uri | 標(biāo)識Ability的統(tǒng)一資源標(biāo)識符。 | / | Stage模型不支持。 |
| deviceCapability | 標(biāo)識Ability運行時要求設(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)進行共享,該標(biāo)簽僅適用于data類型的Ability。 | / | Stage模型不支持。 |
| supportPipMode | 標(biāo)識Ability是否支持用戶進入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模型不支持。 |
審核編輯 黃宇
-
程序員
+關(guān)注
關(guān)注
4文章
955瀏覽量
30752 -
鴻蒙
+關(guān)注
關(guān)注
60文章
2779瀏覽量
45222 -
HarmonyOS
+關(guān)注
關(guān)注
80文章
2144瀏覽量
35374 -
OpenHarmony
+關(guān)注
關(guān)注
31文章
3905瀏覽量
20595 -
鴻蒙OS
+關(guān)注
關(guān)注
0文章
191瀏覽量
5288
發(fā)布評論請先 登錄
如何將一個FA模型開發(fā)的聲明式范式應(yīng)用切換到Stage模型
鴻蒙開發(fā)Ability Kit程序框架服務(wù):FA模型綁定Stage模型ServiceExtensionAbility
鴻蒙開發(fā)Ability Kit程序框架服務(wù):FA模型訪問Stage模型DataShareExtensionAbility
鴻蒙開發(fā)Ability Kit程序框架服務(wù):Stage模型啟動FA模型PageAbility
鴻蒙開發(fā)Ability Kit程序框架服務(wù):Stage模型綁定FA模型ServiceAbility
鴻蒙開發(fā)Ability Kit程序框架服務(wù):FA模型切換Stage模型指導(dǎo) app和deviceConfig的切換
鴻蒙開發(fā)Ability Kit程序框架服務(wù):PageAbility切換 組件切換

鴻蒙開發(fā)Ability Kit程序框架服務(wù):FA模型切換Stage模型指導(dǎo) module的切換
評論