OpenHarmony之module对象的内部结构

module对象的内部结构

module对象包含HAP包的配置信息，涉及到的参数过多，接下来一一了解。

• mainAbility：字符串类型，如果存在page类型的ability，则该字段不可缺省。表示服务中心图标露出的ability，常驻进程拉起时会启动mainAbility。

• package：表示HAP的包结构名称，在应用内保证唯一性。采用反向域名格式（建议与HAP的工程目录保持一致）。字符串长度不超过127字节。

• name：表示HAP的类名。采用反向域名方式表示，前缀要与同级的package标签指定的包名一致，也可采用"."开头的命名方式。字符串长度不超过255字节。

• description：表示HAP的描述信息。字符串长度不超过255字节。如果字符串超出长度或者需要支持多语言，可以采用资源索引的方式添加描述内容。该标签仅适用于默认设备、平板、智慧屏、车机、智能穿戴。

• supportedModes：表示应用支持的运行模式，当前只定义了驾驶模式（drive）。该标签只适用于车机。

• deviceType：表示允许Ability运行的设备类型。系统预定义的设备类型包括：tablet(平板)、tv（智慧屏）、car(车机)、wearable(智能穿戴)等。

• distro：表示HAP发布的具体描述。该标签仅适用于默认设备、平板、智慧屏、车机、智能穿戴。

• metaData：表示HAP元信息。

• abilities：表示当前模块内的所有Ability。采用对象数据格式。其中的每个元素表示一个快捷方式对象。

• js：表示基于ArkUI框架开发的JS模块集合，其中的每个元素代表一个JS模块的信息。

• shortcuts：表示应用的快捷方式信息。采用对象数组格式，其中的每个元素表示一个快捷方式对象。

• reqPermissions：表示应用运行时向系统申请的权限。

• colorMode：表示应用自身的颜色模式。 dark：表示按照深色模式选取资源。 light：表示按照浅色模式选取资源。 auto：表示跟随系统的颜色模式值选取资源。

• distroFilter：表示应用的分发规则。 该标签用于定义HAP包对应的细分设备规格的分发策略，以便在应用市场进行云端分发应用包时做精准匹配。该标签可配置的分发策略维度包括API Version、屏幕形状、屏幕分辨率。在进行分发时，通过deviceType与这三个属性的匹配关系，唯一确定一个用于分发到设备的HAP。

• reqCapabilities：表示运行应用程序所需的设备能力。

• commonEvents：静态广播。

• allowClassMap：HAP的元信息。标记值为true或false。如果标记值为true，则hap使用OpenHarmony框架提供的Java对象代理机制。

• entryTheme：此标签表示OpenHarmony内部主题的关键字。将标记值设置为名称的资源索引。

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