Android视角看鸿蒙第七课(module.json5中的各字段含义之abilities）
导读
今天一起来了解module.json5中的最后一个字段，也是最复杂的字段abilities
官方文档
Indicates all abilities in the current module. The value is an array of objects, each of which represents an ability.This label can be left blank by default,and indicates no capability exists in the current module.
字段声明
项目内截图
思考
字段要求是一个数组，描述了所有ability，类似于activity的声明。可以没有任何内容。
下面尝试两个问题：
1：EntryAbility不声明会发生什么；
2：SecondAbility不声明会发生什么；
尝试
EntryAbility不声明会发生什么
全部注释掉了,无警告。
运行
结论
entryModule中没有声明启动ability时，可以打包并安装成功，但会因为没有配置启动ability而导致没有桌面图标，同时也无法启动。
可以确认安装成功
SecondAbility不声明会发生什么
我们把EntryAbility的注释放开，同时把SecondAbility注释
在index中点击跳转到SecondAbility
运行
点击跳转的时候，没有任何提示，也不奔溃。
日志也不是特别清晰。
03-19 10:56:19.122 733-855/? I 02D01/EventLogger: OnEvent: event jsonExtraInfo is {“domain_”:“AAFWK”,“name_”:“START_ABILITY_ERROR”,“type_”:1,“time_”:1710816979113,“tz_”:“+0800”,“pid_”:26,“tid_”:61,“uid_”:5523,“USER_ID”:-1,“BUNDLE_NAME”:“com.example.myapplication”,“MODULE_NAME”:“app”,“ABILITY_NAME”:“SecondAbility”,“ERROR_CODE”:2097152, “transfer_”:1}
结论
非启动Ability不声明，会导致无法启动此Ability，但页面不会闪退，也无任何提示。日志级别也不是特别清晰。遇到类似问题，建议日志过滤START_ABILITY_ERROR
所有子字段
name
文档
字段声明
这里很重要，必须从这两个中选一个，即name必须存在。
有最大长度限制，不允许索引。
尝试
这里实际使用时，建议还是要和文件名相同，本着深入了解的目的，这里测试一下随意自定义name和want跳转的关系。
把SecondAbility的注释放开，同时修改name为second
want使用的abilityName先不改，看看这里的abilityName使用的是文件名还是json5中声明的名字
运行
跳转失败了。
换成刚刚修改过的second
运行
03-19 11:39:48.462 6087-85/? D 02D10/HiView-SysEventSource: Parser: parser raw message size=247, {“domain_”:“AAFWK”,“name_”:“START_ABILITY_ERROR”,“type_”:1,“time_”:1710819588357,“tz_”:“+0800”,“pid_”:16,“tid_”:16,“uid_”:5523,“USER_ID”:-1,“BUNDLE_NAME”:“com.example.myapplication”,“MODULE_NAME”:“app”,“ABILITY_NAME”:“second”,“ERROR_CODE”:2097177}
报错了 看看这个error是什么意思
找不到文档，换个方式
运行
绝了，啥也没有。
研究研究
发现问题了，SecondAbility和EntryAbility一样都是加载的pages/Index，模拟器上也没看出来页面切换，实际上是成功的。
新建了一个page给SecondAbility，就看出效果了。
这样的话，再改回去，name改成SecondAbility看看能不能跳转
不能，这回错误日志，也更加清晰了。
结论
name相当于给Ability起个别名，want跳转的时候使用的是别名，而不是文件名。
使用want，最好关注下结果，否则的话错误原因不好定位。
我把这个日志过滤了一下，只有这么两句，第二句还是我自己打的，第一句是Debug级别。
srcEntry
官方文档
字段描述
思考
其实很简单，String类型的Ability地址，用来正确的指向Ability文件。
在abilities字段描述中，有下图
其实就是srcEntrance和srcEntry二选一，我特意看了一下srcEntrance的描述
发现只是过期了，所以srcEntrance不再关注。
下面我们依然尝试两个问题
1、全路径行不行，带中文行不行
2、library（feature module）中的ability定义在entry行不行
尝试（全路径行不行）
不行，直接报错。
第二个问题也不存在了
尝试（中文行不行）
直接修改文件夹为中文试试
修改成功了,srcEntry也自动变化了。
运行看看
跑不起来。
还是别搞骚操作了。
结论
只能使用相对路径。带中文的不行。
description
这个字段我们在之前的文章说过，感兴趣的同学翻回去看看，这里直接上结论
之前讲description的文章
结论
icon&label
官方文档
字段描述
思考
讲如何修改桌面图标的文章
在上面的文章中，我们确定了桌面图标是由携带
这两个字段的ability的label和icon决定的。
那么为什么我新创建的ability也默认携带这两个字段呢？
会不会还有其他用处?
答案是有的
在运行中的任务中，两个ablity都是存在的，所以ablity并不等同于activity,而且这两个ability各自使用了各自的label及icon。
下面尝试几个问题
1、SecondAbility不配置icon及label如何展示
2、EntryAbility不配置会如何
尝试SecondAbility不配置icon及label
把second下的label注释掉
运行
若Ability不配置label和icon，则使用app.json5中的应用icon和label。
EntryAbility不配置label和icon会如何
把EntryAbility 的label和icon注释掉
运行
结论
1、每个ability在运行中应用列表都显示单独配置的图标及名称，若未配置则显示app.json5中配置的应用图标及名称
2、entryAbility若未配置图标及名称，默认取用app.json5中配置的应用图标和名称。
other
有点太多了，下篇文章继续讲吧。
