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,此时桌面图标消失。

最近更新

  1. TCP协议是安全的吗?

    2024-03-10 19:32:02       18 阅读
  2. 阿里云服务器执行yum,一直下载docker-ce-stable失败

    2024-03-10 19:32:02       19 阅读
  3. 【Python教程】压缩PDF文件大小

    2024-03-10 19:32:02       19 阅读
  4. 通过文章id递归查询所有评论(xml)

    2024-03-10 19:32:02       20 阅读

热门阅读

  1. 【C++】6-12 运动成绩排名 分数 10

    2024-03-10 19:32:02       20 阅读
  2. C/C++蓝桥杯之日期问题

    2024-03-10 19:32:02       21 阅读
  3. 智慧路灯物联网管理平台及应用

    2024-03-10 19:32:02       20 阅读
  4. js进阶-es6-作用域-垃圾回收机制-闭包-变量提升

    2024-03-10 19:32:02       18 阅读
  5. 微信小程序--注册时获取微信头像

    2024-03-10 19:32:02       23 阅读
  6. leetcode刷题笔记 split() 分割字符串

    2024-03-10 19:32:02       20 阅读
  7. 使用XML方式配置IOC

    2024-03-10 19:32:02       23 阅读
  8. CGAL 5.6.1 - Modular Arithmetic(模板化算法)

    2024-03-10 19:32:02       20 阅读
  9. 数据结构-滑动窗口

    2024-03-10 19:32:02       23 阅读