先通過一個(gè)示例，整體認(rèn)識(shí)一下module.json5配置文件。
{
"module": {
"name": "entry",
"type": "entry",
"description": "$string:module_desc",
"mainElement": "EntryAbility",
"deviceTypes": [
"default",
"tablet"
],
"deliveryWithInstall": true,
"installationFree": false,
"pages": "$profile:main_pages",
"virtualMachine": "ark",
"metadata": [
{
"name": "string",
"value": "string",
"resource": "$profile:distributionFilter_config"
}
],
"abilities": [
{
"name": "EntryAbility",
"srcEntry": "./ets/entryability/EntryAbility.ts",
"description": "$string:EntryAbility_desc",
"icon": "$media:icon",
"label": "$string:EntryAbility_label",
"startWindowIcon": "$media:icon",
"startWindowBackground": "$color:start_window_background",
"exported": true,
"skills": [
{
"entities": [
"entity.system.home"
],
"actions": [
"ohos.want.action.home"
]
}
]
}
],
"requestPermissions": [
{
"name": "ohos.abilitydemo.permission.PROVIDER",
"reason": "$string:reason",
"usedScene": {
"abilities": [
"FormAbility"
],
"when": "inuse"
}
}
]
}
}module.json5配置文件包含以下標(biāo)簽。
表1 module.json5配置文件配置標(biāo)簽說明
deviceTypes標(biāo)簽
表2 deviceType標(biāo)簽配置說明
deviceTypes示例：
{
"module": {
"name": "myHapName",
"type": "feature",
"deviceTypes" : [
"tablet"
]
}
}pages標(biāo)簽
該標(biāo)簽是一個(gè)profile文件資源，用于指定描述頁面信息的配置文件。
{
"module": {
// ...
"pages": "$profile:main_pages", // 通過profile下的資源文件配置
}
}在開發(fā)視圖的resources/base/profile下面定義配置文件main_pages.json，其中文件名(main_pages)可自定義，需要和前文中pages標(biāo)簽指定的信息對(duì)應(yīng)，配置文件中列舉了當(dāng)前應(yīng)用組件中的頁面信息。
表3 pages配置文件標(biāo)簽說明
{
"src": [
"pages/index/mainPage",
"pages/second/payment",
"pages/third/shopping_cart",
"pages/four/owner"
]
}metadata標(biāo)簽
該標(biāo)簽標(biāo)識(shí)HAP的自定義元信息，標(biāo)簽值為數(shù)組類型，包含name，value，resource三個(gè)子標(biāo)簽。
表5 metadata標(biāo)簽說明
{
"module": {
"metadata": [{
"name": "module_metadata",
"value": "a test demo for module metadata",
"resource": "$profile:shortcuts_config",
}],
"abilities": [{
"metadata": [{
"name": "ability_metadata",
"value": "a test demo for ability",
"resource": "$profile:config_file"
},
{
"name": "ability_metadata_2",
"value": "a string test",
"resource": "$profile:config_file"
}],
}],
"extensionAbilities": [{
"metadata": [{
"name": "extensionAbility_metadata",
"value": "a test for extensionAbility",
"resource": "$profile:config_file"
},
{
"name": "extensionAbility_metadata_2",
"value": "a string test",
"resource": "$profile:config_file"
}],
}]
}
}abilities標(biāo)簽
abilities標(biāo)簽描述UIAbility組件的配置信息，標(biāo)簽值為數(shù)組類型，該標(biāo)簽下的配置只對(duì)當(dāng)前UIAbility生效。
表6 abilities標(biāo)簽說明
abilities示例：
{
"abilities": [{
"name": "EntryAbility",
"srcEntry": "./ets/entryability/EntryAbility.ts",
"launchType":"singleton",
"description": "$string:description_main_ability",
"icon": "$media:icon",
"label": "Login",
"permissions": [],
"metadata": [],
"exported": true,
"continuable": true,
"skills": [{
"actions": ["ohos.want.action.home"],
"entities": ["entity.system.home"],
"uris": []
}],
"backgroundModes": [
"dataTransfer",
"audioPlayback",
"audioRecording",
"location",
"bluetoothInteraction",
"multiDeviceConnection",
"wifiInteraction",
"voip",
"taskKeeping"
],
"startWindowIcon": "$media:icon",
"startWindowBackground": "$color:red",
"removeMissionAfterTerminate": true,
"orientation": " ",
"supportWindowMode": ["fullscreen", "split", "floating"],
"maxWindowRatio": 3.5,
"minWindowRatio": 0.5,
"maxWindowWidth": 2560,
"minWindowWidth": 1400,
"maxWindowHeight": 300,
"minWindowHeight": 200,
"excludeFromMissions": false
}]
}skills標(biāo)簽
該標(biāo)簽標(biāo)識(shí)UIAbility組件或者ExtensionAbility組件能夠接收的Want的特征。
skills示例：
{
"abilities": [
{
"skills": [
{
"actions": [
"ohos.want.action.home"
],
"entities": [
"entity.system.home"
],
"uris": [
{
"scheme":"http",
"host":"example.com",
"port":"80",
"path":"path",
"type": "text/*"
}
]
}
]
}
]
}extensionAbilities標(biāo)簽
描述extensionAbilities的配置信息，標(biāo)簽值為數(shù)組類型，該標(biāo)簽下的配置只對(duì)當(dāng)前extensionAbilities生效。
表9 extensionAbilities標(biāo)簽說明
extensionAbilities示例：
{
"extensionAbilities": [
{
"name": "FormName",
"srcEntry": "./form/MyForm.ts",
"icon": "$media:icon",
"label" : "$string:extension_name",
"description": "$string:form_description",
"type": "form",
"permissions": ["ohos.abilitydemo.permission.PROVIDER"],
"readPermission": "",
"writePermission": "",
"exported": true,
"uri":"scheme://authority/path/query",
"skills": [{
"actions": [],
"entities": [],
"uris": []
}],
"metadata": [
{
"name": "ohos.extension.form",
"resource": "$profile:form_config",
}
]
}
]
}requestPermissions標(biāo)簽
該標(biāo)簽標(biāo)識(shí)應(yīng)用運(yùn)行時(shí)需向系統(tǒng)申請(qǐng)的權(quán)限集合。
說明
在requestPermissions標(biāo)簽中配置的權(quán)限項(xiàng)將在應(yīng)用級(jí)別生效，即該權(quán)限適用于整個(gè)應(yīng)用程序。
如果應(yīng)用需要訂閱自己發(fā)布的事件，而且應(yīng)用在extensionAbilities標(biāo)簽中的permissions字段中設(shè)置了訪問該應(yīng)用所需要的權(quán)限，那么應(yīng)用也需要在requestPermissions標(biāo)簽中注冊(cè)相關(guān)權(quán)限才能收到該事件。
requestPermissions示例：
{
"module" : {
"requestPermissions": [
{
"name": "ohos.abilitydemo.permission.PROVIDER",
"reason": "$string:reason",
"usedScene": {
"abilities": [
"EntryFormAbility"
],
"when": "inuse"
}
}
]
}
}shortcuts標(biāo)簽
shortcuts標(biāo)識(shí)應(yīng)用的快捷方式信息。標(biāo)簽值為數(shù)組，最多可以配置四個(gè)快捷方式。其包含四個(gè)子標(biāo)簽shortcutId、label、icon、wants。
metadata中指定shortcut信息，其中：
name：指定shortcuts的名稱。使用ohos.ability.shortcuts作為shortcuts信息的標(biāo)識(shí)。
resource：指定shortcuts信息的資源位置。
表11 shortcuts標(biāo)簽說明
在/resource/base/profile/目錄下配置shortcuts_config.json配置文件。
{
"shortcuts": [
{
"shortcutId": "id_test1",
"label": "$string:shortcut",
"icon": "$media:aa_icon",
"wants": [
{
"bundleName": "com.ohos.hello",
"abilityName": "EntryAbility"
}
]
}
]
}在module.json5配置文件的abilities標(biāo)簽中，針對(duì)需要添加快捷方式的UIAbility進(jìn)行配置metadata標(biāo)簽，使shortcut配置文件對(duì)該UIAbility生效。
{
"module": {
// ...
"abilities": [
{
"name": "EntryAbility",
"srcEntry": "./ets/entryability/EntryAbility.ts",
// ...
"skills": [
{
"entities": [
"entity.system.home"
],
"actions": [
"ohos.want.action.home"
]
}
],
"metadata": [
{
"name": "ohos.ability.shortcuts",
"resource": "$profile:shortcuts_config"
}
]
}
]
}
}distributionFilter標(biāo)簽
該標(biāo)簽下的子標(biāo)簽均為可選字段，用于定義HAP對(duì)應(yīng)的細(xì)分設(shè)備規(guī)格的分發(fā)策略，以便應(yīng)用市場(chǎng)在云端分發(fā)HAP時(shí)做精準(zhǔn)匹配。該標(biāo)簽需要配置在/resource/profile資源目錄下;在進(jìn)行分發(fā)時(shí)，通過deviceType與下表屬性的匹配關(guān)系，唯一確定一個(gè)用于分發(fā)到設(shè)備的HAP。
表12 distributionFilter標(biāo)簽說明
在開發(fā)視圖的resources/base/profile下面定義配置文件distro_filter_config.json，文件名可以自定義。
{
"distributionFilter": {
"screenShape": {
"policy": "include",
"value": [
"circle",
"rect"
]
},
"screenWindow": {
"policy": "include",
"value": [
"454*454",
"466*466"
]
},
"screenDensity": {
"policy": "exclude",
"value": [
"ldpi",
"xldpi"
]
},
"countryCode": { // 支持中國(guó)和香港地區(qū)分發(fā)
"policy": "include",
"value": [
"CN",
"HK"
]
}
}
}在module.json5配置文件的module標(biāo)簽中定義metadata信息。
{
"module": {
// ...
"metadata": [
{
"name": "ohos.module.distro",
"resource": "$profile:distro_filter_config",
}
]
}
}testRunner標(biāo)簽
此標(biāo)簽用于支持對(duì)測(cè)試框架的配置。
表17 testRunner標(biāo)簽說明
testRunner標(biāo)簽示例：
{
"module": {
// ...
"testRunner": {
"name": "myTestRunnerName",
"srcPath": "etc/test/TestRunner.ts"
}
}
}
京公網(wǎng)安備 11010802030320號(hào)