鸿蒙开发入门：应用配置文件概述（二）_{ "module": { "name": "entry", "type": "entry", "d

应用配置文件概述（Stage模型）

每个应用项目必须在项目的代码目录下加入配置文件，这些配置文件会向编译工具、操作系统和应用市场提供应用的基本信息。

在基于Stage模型开发的应用项目代码下，都存在一个app.json5及一个或多个module.json5这两种配置文件。

app.json5主要包含以下内容：

• 应用的全局配置信息，包含应用的包名、开发厂商、版本号等基本信息。
• 特定设备类型的配置信息。

module.json5主要包含以下内容：

• Module的基本配置信息，例如Module名称、类型、描述、支持的设备类型等基本信息。
• 应用组件信息，包含UIAbility组件和ExtensionAbility组件的描述信息。
• 应用运行过程中所需的权限信息。

module.json5配置文件

先通过一个示例，整体认识一下module.json5配置文件。

{  "module": {    "name": "entry",    "type": "entry",    "description": "$string:module_desc",    "mainElement": "EntryAbility",    "deviceTypes": [      "tv",      "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"        }      }    ]  }}
1

module.json5配置文件包含以下标签。

deviceTypes标签

deviceTypes示例：

{  "module": {    "name": "myHapName",    "type": "feature",    "deviceTypes" : [       "tablet"    ]  }}
1

pages标签

该标签是一个profile文件资源，用于指定描述页面信息的配置文件。

{  "module": {    // ...    "pages": "$profile:main_pages", // 通过profile下的资源文件配置  }}
1

在开发视图的resources/base/profile下面定义配置文件main_pages.json，其中文件名(main_pages)可自定义，需要和前文中pages标签指定的信息对应，配置文件中列举了当前应用组件中的页面信息。

{  "src": [    "pages/index/mainPage",    "pages/second/payment",    "pages/third/shopping_cart",    "pages/four/owner"  ]}
1

metadata标签

该标签标识HAP的自定义元信息，标签值为数组类型，包含name，value，resource三个子标签。

{  "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"      }],    }]  }}
1
2
3

abilities标签

abilities标签描述UIAbility组件的配置信息，标签值为数组类型，该标签下的配置只对当前UIAbility生效。

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  }]}
1

skills标签

该标签标识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/*"            }          ]        }      ]    }  ]}
1

extensionAbilities标签

描述extensionAbilities的配置信息，标签值为数组类型，该标签下的配置只对当前extensionAbilities生效。

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",         }      ]    }  ]}
1

requestPermissions标签

该标签标识应用运行时需向系统申请的权限集合。

说明

• 在requestPermissions标签中配置的权限项将在应用级别生效，即该权限适用于整个应用程序。
• 如果应用需要订阅自己发布的事件，而且应用在extensionAbilities标签中的permissions字段中设置了访问该应用所需要的权限，那么应用也需要在requestPermissions标签中注册相关权限才能收到该事件。

requestPermissions示例：

{  "module" : {    "requestPermissions": [      {        "name": "ohos.abilitydemo.permission.PROVIDER",        "reason": "$string:reason",        "usedScene": {          "abilities": [            "EntryFormAbility"          ],          "when": "inuse"        }      }    ]  }}
1

shortcuts标签

shortcuts标识应用的快捷方式信息。标签值为数组，最多可以配置四个快捷方式。其包含四个子标签shortcutId、label、icon、wants。

metadata中指定shortcut信息，其中：

• name：指定shortcuts的名称。使用ohos.ability.shortcuts作为shortcuts信息的标识。
• resource：指定shortcuts信息的资源位置。

1. 在/resource/base/profile/目录下配置shortcuts_config.json配置文件。

   {  "shortcuts": [    {      "shortcutId": "id_test1",      "label": "$string:shortcut",      "icon": "$media:aa_icon",      "wants": [        {          "bundleName": "com.ohos.hello",          "abilityName": "EntryAbility"        }      ]    }  ]}
   1

2. 在module.json5配置文件的abilities标签中，针对需要添加快捷方式的UIAbility进行配置metadata标签，使shortcut配置文件对该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"          }        ]      }    ]  }}
   1

distroFilter标签

该标签下的子标签均为可选字段，在应用市场云端分发时使用，distroFilter标签用于定义HAP对应的细分设备规格的分发策略，以便在应用市场进行云端分发应用包时做精准匹配。该标签可配置的分发策略维度包括API Version、屏幕形状、屏幕尺寸、屏幕分辨率，设备的国家与地区码。在进行分发时，通过deviceType与这五个属性的匹配关系，唯一确定一个用于分发到设备的HAP。

该标签需要配置在/resource/profile资源目录下，并在模块的metadata的resource字段中引用。

在开发视图的resources/base/profile下面定义配置文件distro_filter_config.json，文件名可以自定义。

{  "distroFilter": {    "screenShape": {      "policy": "include",      "value": [        "circle",        "rect"      ]    },    "screenWindow": {      "policy": "include",      "value": [        "454*454",        "466*466"      ]    },    "screenDensity": {      "policy": "exclude",      "value": [        "ldpi",        "xldpi"      ]    },    "countryCode": { // 支持中国和香港地区分发      "policy": "include",      "value": [        "CN",        "HK"      ]    }  }}
1

在module.json5配置文件的module标签中定义metadata信息。

{  "module": {    // ...    "metadata": [      {        "name": "ohos.module.distro",        "resource": "$profile:distro_filter_config",      }    ]  }}
1

testRunner标签

此标签用于支持对测试框架的配置。

testRunner标签示例：

{  "module": {    // ...    "testRunner": {      "name": "myTestRunnerName",      "srcPath": "etc/test/TestRunner.ts"    }  }}
1

最后

这里整理了一份《鸿蒙零基础入门学习指南》，希望能对那些想要学习鸿蒙，但是有没有方向的人提供一点帮助。本文档适用于HarmonyOS应用开发的初学者（由于文档内容过多，因此为了避免影响到大家的阅读体验，在此只以截图展示部分内容，详细完整版的看文末有免费的获取方式！）

## 《鸿蒙零基础入门学习指南》

目录

一、快速入门

适用于HarmonyOS应用开发的初学者。通过构建一个简单的具有页面跳转/返回功能的应用，快速了解工程目录的主要文件，熟悉HarmonyOS应用开发流程。

• 开发准备
  • 基本概念
  • 工具准备
• 构建第一个ArkTS应用（Stage模型）
• 构建第一个ArkTS应用（FA模型）
• 构建第一个JS应用（FA模型）

二、开发基础知识

• 应用程序包基础知识
  • 应用程序包概述
  • 应用程序包结构
  • 应用程序包多HAP机制
  • 应用程序包安装和卸载流程
  • 应用程序包更新流程
  • 共享包
  • 应用程序包快速修复
• 应用配置文件（Stage模型）
  • 应用配置文件概述（Stage模型）
  • app.json5配置文件
  • module.json5配置文件
• 应用配置文件概述（FA模型）
  • 应用配置文件概述（FA模型）
  • app对象内部结构
  • deviceConfig内部结构
  • module对象内部结构

三、资源分类与访问

应用开发过程中，经常需要用到颜色、字体、间距、图片等资源，在不同的设备或配置中，这些资源的值可能不同。

• 资源分类与访问
  • 资源分类
  • 资源目录
  • 资源组目录
• 创建资源目录和资源文件
  • 创建资源目录和资源文件
  • 创建资源目录
  • 创建资源文件
• 资源访问
  • 应用资源
  • 系统资源
  • 资源匹配
    

四、学习ArkTs语言

ArkTS是HarmonyOS优选的主力应用开发语言。ArkTS围绕应用开发在TypeScript（简称TS）生态基础上做了进一步扩展，继承了TS的所有特性，是TS的超集。因此，在学习ArkTS语言之前，建议开发者具备TS语言开发能力。

• 初识ArkTS语言
• 基本语法
  • 基本语法概述
  • 声明式UI描述
  • 自定义组件
• 状态管理
• 其他状态管理
  • 其他状态管理概述
  • @Watch装饰器：状态变量更改通知
  • $$语法：内置组件双向同步
• 渲染控制
  • 渲染控制概述
  • if/else：条件渲染
  • ForEach：循环渲染
  • LazyForEach：数据懒加载

扫描下方二维码免费领取，《鸿蒙5.0零基础入门学习指南》