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也顺利跑起来了。

兄弟们在尝试的时候不要忘了namebuild-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才能够独立运行。

思考

只有一个feature类型的module能否运行

官方文档提到: (feature:应用的动态特性模块。一个APP可以包含一个或多个feature类型的HAP,也可以不含。只有包含Ability的HAP才能够独立运行。)

那如果没有entry,只有feature能不能独立运行?

尝试

直接把
"type": "entry"

变更为
"type": "feature"

看看会发生什么

报错了,意思是feature必须在build-preofile.json5中设置entryModules

我们在这里添加一个entryModules,看看这个字段的描述

If the module is a feature module, this field needs to be used to specify the associated entry module.

如果是feature类型,需要声明entry module。

所以我们把这个改回来,重新创建一个feature类型的module

还是选择这个类型,如果依然可以选择entry类型的话,我们还选这个类型.

理论上是可以的,因为文档上的描述entry:应用的主模块。一个APP中,对于同一设备类型,可以有一个或多个entry类型的HAP

但是事实却是不行,只能创建feature类型,继续application改成library

可以看到目录结构完全是一致的,接下来对比一下feature和entry默认的mudule的区别

有区别的地方很少,
除type之外entry类型比feature类型多了一个skills字段,其他完全一致

再对比一下build-preofile.json5,之前报错是需要我们在feature类型中的此文件中,增加entrymodules的,我们看一下这个字段应该怎么写

ok,也只有这一个区别。

那现在我们把feature类型的entryModules字段删除看看又会发生什么

依然还是这样,所以feature中必须有这个字段。

改回来可以运行了,突然发现运行时,module默认选中的是library

那运行出来的第一个界面,是library的还是app的呢?

修改一下library的hello world,再次运行,发现出现的是我们修改过的文案,那就是说feature项目可以独立运行,但是工程目录下必须有个entry目录,可以不用但必须有!

那这种情况下,桌面图标是entry module配置的,还是library的,答案是都不是,桌面图标从桌面上消失了,没有桌面app名称,没有图标,桌面占位都空出来了

结论

1、只有一个feature类型 的module,无法运行

2、feature类型的build-profile.json5中必须包含entryModules

3、运行时可以选择feature类型 的module,出现的第一个页面就是feature的index.ets,此时桌面图标消失。

相关推荐
数据猎手小k2 小时前
AndroidLab:一个系统化的Android代理框架,包含操作环境和可复现的基准测试,支持大型语言模型和多模态模型。
android·人工智能·机器学习·语言模型
Json_181790144803 小时前
An In-depth Look into the 1688 Product Details Data API Interface
大数据·json
你的小103 小时前
JavaWeb项目-----博客系统
android
风和先行3 小时前
adb 命令查看设备存储占用情况
android·adb
AaVictory.4 小时前
Android 开发 Java中 list实现 按照时间格式 yyyy-MM-dd HH:mm 顺序
android·java·list
哟哟耶耶4 小时前
js-将JavaScript对象或值转换为JSON字符串 JSON.stringify(this.SelectDataListCourse)
前端·javascript·json
dawn5 小时前
鸿蒙ArkTS中的获取网络数据
华为·harmonyos
桃花键神5 小时前
鸿蒙5.0时代:原生鸿蒙应用市场引领开发者服务新篇章
华为·harmonyos
鸿蒙自习室5 小时前
鸿蒙多线程开发——并发模型对比(Actor与内存共享)
华为·harmonyos
似霰5 小时前
安卓智能指针sp、wp、RefBase浅析
android·c++·binder