玩转HarmonyOS NEXT之配置文件篇

配置文件概述

本文以Stage模型为例，详细介绍了HarmonyOS NEXT应用的各种配置文件，这些配置文件会向编译工具、操作系统和应用市场提供应用的基本信息。

在基于Stage模型开发的应用项目代码下，都存在一个app.json5的配置文件、以及一个或者多个module.json5配置文件。

应用配置文件

app.json5配置文件

先通过一个示例，整体认识下app.json5配置文件。

{
   
  "app": {
   
    "bundleName": "com.application.myapplication",
    "vendor": "example",
    "versionCode": 1000000,
    "versionName": "1.0.0",
    "icon": "$media:app_icon",
    "label": "$string:app_name",
    "description": "$string:description_application",
    "minAPIVersion": 9,
    "targetAPIVersion": 9,
    "apiReleaseType": "Release",
    "debug": false,
    "car": {
   
      "minAPIVersion": 8
    },
    "targetBundleName": "com.application.test",
    "targetPriority": 50,
    "appEnvironments": [
      {
   
        "name":"name1",
        "value": "value1"
      }
    ],
    "maxChildProcess": 5
  },
}

app.json5配置文件主要包含一下内容：

• 应用的全局配置信息，包含应用的Bundle名称、开发厂商、版本号等基本信息。
• 特定设备类型的配置信息。

具体属性如下表：

属性名称	属性含义	数据类型	是否必填
bundleName	标识应用的Bundle名称，用于标识应用的唯一性。命名规则如下 ： - 由字母、数字、下划线和符号“.”组成，且必须以字母开头。 - 字符串最小长度为7字节，最大长度为128字节。 - 推荐采用反域名形式命名（如com.example.demo，建议第一级为域名后缀com，第二级为厂商/个人名，第三级为应用名，也可以多级）。对于随系统源码编译的应用，建议命名为com.ohos.demo形式，其中的ohos标识系统应用。	string	是
bundleType	标识应用的Bundle类型，用于区分应用或者元服务。支持的取值如下： - app：当前Bundle为应用。 - atomicService：当前Bundle为元服务。 shared：当前Bundle为共享库应用，预留字段。 - appService：当前Bundle为系统级共享库应用，仅供系统应用使用。	string	否，默认值为app
debug<