module的切換

從FA模型切換到Stage模型時(shí)，開發(fā)者需要將config.json文件module標(biāo)簽下的配置遷移到module.json5配置文件module標(biāo)簽下，具體差異見下列表格。 開發(fā)前請(qǐng)熟悉鴻蒙開發(fā)指導(dǎo)文檔 ：[gitee.com/li-shizhen-skin/harmony-os/blob/master/README.md]

表1 FA模型module標(biāo)簽與Stage模型module標(biāo)簽差異對(duì)比

FA標(biāo)簽	標(biāo)簽說(shuō)明	對(duì)應(yīng)的Stage標(biāo)簽	差異說(shuō)明
mainAbility	服務(wù)中心圖標(biāo)露出的ability，常駐進(jìn)程拉起時(shí)會(huì)啟動(dòng)mainAbility。	mainElement	標(biāo)簽名稱變更，Stage模型不在使用“.”符號(hào)。
package	標(biāo)識(shí)HAP的包結(jié)構(gòu)名稱，在應(yīng)用內(nèi)保證唯一性。	/	Stage模型使用name來(lái)保證應(yīng)用唯一性。FA模型升級(jí)到Stage模型時(shí)，Stage模型的name需要和FA模型的package保持一致，否則會(huì)導(dǎo)致升級(jí)失敗。
name	標(biāo)識(shí)HAP的類名。	/	FA模型中實(shí)際未使能，Stage模型沒(méi)有與之對(duì)應(yīng)的標(biāo)簽。
supportedModes	標(biāo)識(shí)應(yīng)用支持的運(yùn)行模式，當(dāng)前只定義了駕駛模式（drive）。	/	Stage模型已廢棄。
distro對(duì)象中的moduleName	標(biāo)識(shí)當(dāng)前HAP的名稱。distro對(duì)象中的moduleName。	name	標(biāo)簽變更。
distro對(duì)象中的moduleType	標(biāo)識(shí)當(dāng)前HAP的類型，包括兩種類型：entry和feature。另外，如果表示HAR包類型，請(qǐng)?jiān)O(shè)置為har。	type	標(biāo)簽變更。
distro對(duì)象中的installationFree	標(biāo)識(shí)當(dāng)前HAP是否支持免安裝特性。	installationFree	標(biāo)簽變更。
distro對(duì)象中的deliveryWithInstall	標(biāo)識(shí)當(dāng)前HAP是否支持隨應(yīng)用安裝。	deliveryWithInstall	標(biāo)簽變更。
metaData	標(biāo)識(shí)HAP的元信息。	metadata	具體差異見表2。
abilities	標(biāo)識(shí)當(dāng)前模塊內(nèi)的所有Ability。	abilities	具體差異見表5。
js	標(biāo)識(shí)基于ArkUI框架開發(fā)的JS模塊集合，其中的每個(gè)元素代表一個(gè)JS模塊的信息。	pages	Stage模型在module標(biāo)簽下保留該對(duì)象中的pages，window配置與pages的下一級(jí)。
shortcuts	標(biāo)識(shí)應(yīng)用的快捷方式信息。	shortcut_config.json文件	在開發(fā)視圖的resources/base/profile下面定義配置文件shortcut_config.json。
reqPermissions	標(biāo)識(shí)應(yīng)用運(yùn)行時(shí)向系統(tǒng)申請(qǐng)的權(quán)限。	requestPermissions	標(biāo)簽名稱變更。
colorMode	標(biāo)識(shí)應(yīng)用自身的顏色模式。	/	Stage模型不支持。
distroFilter	標(biāo)識(shí)應(yīng)用的分發(fā)規(guī)則。	distributionFilter_config.json文件	Stage模型在開發(fā)視圖的resources/base/profile下面定義配置文件distributionFilter_config.json。
reqCapabilities	標(biāo)識(shí)運(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)識(shí)系統(tǒng)內(nèi)部主題的關(guān)鍵字。	/	Stage模型不支持。

表2 FA模型metaData和Stage中metadata對(duì)比

FA標(biāo)簽	標(biāo)簽說(shuō)明	對(duì)應(yīng)的Stage模型標(biāo)簽	差異對(duì)比
parameters	標(biāo)識(shí)調(diào)用Ability時(shí)所有調(diào)用參數(shù)的元信息。	/	Stage模型不支持。
results	標(biāo)識(shí)Ability返回值的元信息。	/	Stage模型不支持。
customizeData	該標(biāo)簽標(biāo)識(shí)父級(jí)組件的自定義元信息，Parameters和results在application不可配。	metadata	具體差異見表3。

表3 FA模型metaData的customizeData和Stage中metadata對(duì)比

FA標(biāo)簽	標(biāo)簽說(shuō)明	對(duì)應(yīng)的Stage模型標(biāo)簽	差異對(duì)比
name	標(biāo)識(shí)數(shù)據(jù)項(xiàng)的鍵名稱。字符串最大長(zhǎng)度為255字節(jié)。	name	無(wú)。
value	標(biāo)識(shí)數(shù)據(jù)項(xiàng)的值。字符串最大長(zhǎng)度為255字節(jié)。	value	無(wú)。
extra	標(biāo)識(shí)當(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差異對(duì)比

搜狗高速瀏覽器截圖20240326151547.png

FA模型的abilities對(duì)象標(biāo)簽	描述`HarmonyOS與OpenHarmony鴻蒙文檔籽料：mau123789是v直接拿`	Stage模型中abilities對(duì)象標(biāo)簽	差異對(duì)比
process	運(yùn)行應(yīng)用程序或Ability的進(jìn)程名稱。	/	Stage模型不支持abilities中配置，在module標(biāo)簽下配置process。
uri	標(biāo)識(shí)Ability的統(tǒng)一資源標(biāo)識(shí)符。	/	Stage模型不支持。
deviceCapability	標(biāo)識(shí)Ability運(yùn)行時(shí)要求設(shè)備具有的能力，采用字符串?dāng)?shù)組的格式表示。	/	Stage模型不支持。
metaData	該標(biāo)簽標(biāo)識(shí)ability的元信息。	metadata	具體差異見表2。
type	標(biāo)識(shí)Ability的類型。	/	Stage模型不支持。
grantPermission	指定是否可以向Ability內(nèi)任何數(shù)據(jù)授予權(quán)限。	/	abilities內(nèi)不支持。
readPermission	標(biāo)識(shí)讀取Ability的數(shù)據(jù)所需的權(quán)限。該標(biāo)簽僅適用于data類型的Ability。	/	abilities內(nèi)不支持，在extensionAbilities標(biāo)簽中支持。
writePermission	標(biāo)識(shí)向Ability寫數(shù)據(jù)所需的權(quán)限。	/	abilities內(nèi)不支持，在extensionAbilities標(biāo)簽中支持。
configChanges	標(biāo)識(shí)Ability關(guān)注的系統(tǒng)配置集合。	/	Stage模型不支持。
mission	標(biāo)識(shí)Ability指定的任務(wù)棧。	/	Stage模型不支持。
targetAbility	標(biāo)識(shí)當(dāng)前Ability重用的目標(biāo)Ability。	/	Stage模型不支持。
multiUserShared	標(biāo)識(shí)Ability是否支持多用戶狀態(tài)進(jìn)行共享，該標(biāo)簽僅適用于data類型的Ability。	/	Stage模型不支持。
supportPipMode	標(biāo)識(shí)Ability是否支持用戶進(jìn)入PIP模式（用于在頁(yè)面最上層懸浮小窗口，俗稱"畫中畫"，常見于視頻播放等場(chǎng)景）。	/	Stage模型不支持。
formsEnabled	標(biāo)識(shí)Ability是否支持卡片（forms）功能。	/	Stage模型不支持。
forms	標(biāo)識(shí)服務(wù)卡片的屬性。該標(biāo)簽僅當(dāng)formsEnabled為"true"時(shí)，才能生效。	form_config.json文件	Stage模型在開發(fā)視圖的resources/base/profile下面定義配置文件form_config.json。
srcLanguage	Ability開發(fā)語(yǔ)言的類型。	/	Stage模型不支持。
srcPath	該標(biāo)簽標(biāo)識(shí)Ability對(duì)應(yīng)的JS組件代碼路徑。	srcEntry	該標(biāo)簽標(biāo)識(shí)ability所對(duì)應(yīng)的js代碼路徑。
uriPermission	標(biāo)識(shí)該Ability有權(quán)訪問(wèn)的應(yīng)用程序數(shù)據(jù)。	/	Stage模型不支持。

審核編輯黃宇

聲明：本文內(nèi)容及配圖由入駐作者撰寫或者入駐合作網(wǎng)站授權(quán)轉(zhuǎn)載。文章觀點(diǎn)僅代表作者本人，不代表電子發(fā)燒友網(wǎng)立場(chǎng)。文章及其配圖僅供工程師學(xué)習(xí)之用，如有內(nèi)容侵權(quán)或者其他違規(guī)問(wèn)題，請(qǐng)聯(lián)系本站處理。舉報(bào)投訴