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是什么意思

找不到文档，换个方式