Android视角看鸿蒙第三课(module.json中的各字段含义之name&type)

Android视角看鸿蒙第三课(module.json中的各字段含义)

前言

上篇文章我们试图找到鸿蒙app的程序入口，确定了在鸿蒙工程中,由AppScope下的app.json5 负责应用程序的图标及名称,由entry->src->main-module.json5 负责桌面图标及名称的展示。

AppScope下的app.json5还包含了bundleName，versionCode，versionName等配置信息。

entry->src->main-module.json5除abilities下的icon及label字段外，还包含了例如mainElement，pages等等字面看起来就很重要的配置。

这篇文章开始我们主要了解这些字段的作用。

导读

个人以为这个地方不能完全按照经验来了，否则容易出乱子，忽略一些重要的信息。

给大家贴个链接https://developer.huawei.com/consumer/cn/hmos/overview/?catalogVersion=V2
因为版本的更新，文档和代码的对应性不是很强，所以下面内容的准确性无法保证，如有错误，希望您反馈给我，感谢！

结构

module.json5中包含很多字段，比如mainElement等是Srting，deliveryWithInstall是Boolean, pages引用了一个资源，abilities是一个数组。

挨个来分析和尝试下吧。

name字段

官方文档截图

因为版本更新的问题，字段名字和结构都对不上了，但依稀还能看出来他们应该是一致的，描述也不是他特别的详细。

思考一下

"name": "entry"

name的值默认是我们module的名字，点击name看到了name字段的要求和描述(这一点还是不错的)：

parrern 大意是不允许输入中文，但是好像不够全，比如'鿕' ，编码是'\u9fd5',大于\u9fa5,那这个字可以吗？

我更好奇的是他和module是否有实际关联呢？如果修改一下会发生什么呢？来试试吧。

尝试

第一步尝试修改name

改成**"name": "鿕"** 之后，运行到设备报错了

大概意思是:

我们修改后的name不存在，确保他在build-profile.json5文件中存在

找一下这个文件看看

第二步确定build-profile.json5和name字段的关系

一共有两个，第一个在工程目录下,第二个在module目录下。
module目录下：

东西有点少，不像，跳过

工程目录下：

看到了，这里在modules数组中的第一个Object中包含了name和srcPath,我们继续看看这个那么能不能修改

可以看到修改之后，mudule之前是只有entry且entry加粗,现在是entry后多了一个中括号，中括号内是我们修改的名称。

运行依然报错

错误信息，大意是我们的path格式错误，估计是我们的name虽然绕过了正则限定，但中文就是不行，改成英文试试吧。

这样就可以了，app也顺利跑起来了。

兄弟们在尝试的时候不要忘了name 和build-profile.json5都要修改哈。

结论

1、name字段可以修改，允许与module文件名不一致，；

2、name字段必须与工程目录下的build-profile.json5中modules声明的name一致

3、虽然少部分中文可以绕过正则限定，但依然无法成功运行，老老实实的用英文吧，中文也不是个好习惯。

type字段

"type": "entry" 默认是这样的

点进去看看描述

他的类型是String，但是只能从下面四个中选一个,先上个翻译

除了entry好像都不好理解，entry是入口的意思。

翻了翻文档，找到了这个，也不是很全,将就看吧_-

早期只有两个，entry和feature，我们目前就只熟悉这两个，个人感觉这个东西如果没有详细说明，埋头去尝试的话并不能够完全理解。

再上一段文字描述

** HarmonyOS的用户应用程序包以APP Pack（Application Package）形式发布，它是由一个或多个HAP（HarmonyOS Ability Package）以及描述每个HAP属性的pack.info组成。HAP是Ability的部署包，HarmonyOS应用代码围绕Ability组件展开。**

一个HAP是由代码、资源、第三方库及应用配置文件组成的模块包，可分为entry和feature两种模块类型，如图1所示。

entry：应用的主模块。一个APP中，对于同一设备类型，可以有一个或多个entry类型的HAP，来支持该设备类型中不同规格（如API版本、屏幕规格等）的具体设备。如果同一设备类型存在多个entry模块，则必须配置distroFilter分发规则，使得应用市场在做应用的云端分发时，对该设备类型下不同规格的设备进行精确分发。
feature：应用的动态特性模块。一个APP可以包含一个或多个feature类型的HAP，也可以不含。只有包含Ability的HAP才能够独立运行。