对于做鸿蒙开发的小伙伴来说,刚接触模块化开发,肯定会碰到module.json5这个配置文件——它不像业务代码那样能直接实现功能,但却是模块能正常跑起来、被系统认出来的“身份证”。简单说就是,module.json5的核心作用很简单,就是描述一个功能模块的组件架构、运行特征和基础配置,让系统和开发工具清楚:这个模块是干啥的、能在哪些设备上用、需要啥权限才能干活。
  咱们先搞懂它的核心定位:在开源鸿蒙的Stage模型里,不管是入口模块、功能模块还是共享模块,每一个模块都得有module.json5文件,它就像模块的“说明书”,记着模块的关键信息——比如模块叫啥、属于啥类型、支持手机还是平板、需要申请哪些系统权限。少了它,模块根本没法编译,更没法部署到设备上,相当于“没身份没法上岗”。

下面最基础的简化示例:

{
  "module": {
    "name": "entry", // 模块名称,通常entry就是主模块(入口)
    "type": "entry", // 模块类型,entry=主模块,feature=功能模块,记好这两个就够了
    "deviceTypes": ["phone", "tablet"], // 支持的设备类型,手机和平板都能装
    "requestPermissions": [ // 模块需要申请的权限(举个栗子)
      {
        "name": "ohos.permission.CAMERA",
        "reason": "需要使用相机完成扫描功能",
        "usedScene": {"abilities": ["ScanAbility"], "when": "inuse"}
      }
    ]
  }
}

  从这个示例就能看明白,module.json5的核心配置都围着“模块本身”转:告诉系统这是个入口模块,能在手机和平板上用,还需要相机权限。对新手来说,初期不用死记所有配置项,重点抓住“模块名称、模块类型、设备类型、基础权限”这4个核心点,应付简单的模块化开发场景完全够用。

  module.json5就相当于开源鸿蒙模块的“基础配置小管家”,负责定义模块的“身份”和“能力范围”,所有模块的基础信息都得在这儿统一说明,算是模块化开发的第一步。

Logo

社区规范:仅讨论OpenHarmony相关问题。

更多推荐