HarmonyOS NEXT鸿蒙开发:app.json5配置文件

介绍

本文介绍 app.json5 配置文件,是关于整个应用的配置

位置

项目根目录/AppScope/app.json5

配置文件例子

{
  "app": {
    "bundleName": "com.atomicservice.5765880207855797827",
    "bundleType": "atomicService",
    "vendor": "example",
    "versionCode": 1000000,
    "versionName": "1.0.0",
    "icon": "$media:app_icon",
    "label": "$string:app_name"
  }
}

解释

bundleName

详见链接

bundleType

标识应用的Bundle类型,用于区分 应用 或者 元服务。默认为 app

支持的取值如下:

  • app:当前Bundle为应用。

  • atomicService:当前Bundle为元服务。

  • shared:当前Bundle为共享库应用,预留字段。

  • appService:当前Bundle为系统级共享库应用,仅供系统应用使用。

icon

标识应用的图标,取值为图标资源文件的索引。

图片路径:

AppScope/resources/base/media

label

标识应用的名称,取值为字符串资源的索引

字符串长度不超过63字节。

取值文件:

AppScope/resources/base/element/string.json

vendor

标识对应用开发厂商的描述

取值为长度不超过255字节的字符串。

versionCode

标识应用的版本号,取值为小于 2^31 次方的正整数。此数字仅用于确定某个版本是否比另一个版本更新,数值越大表示版本越高。

开发者可以将该值设置为任何正整数,但是必须确保应用的新版本都使用比旧版本更大的值。

versionName

标识向 用户 展示的应用版本号。

取值为长度不超过127字节的字符串,仅由数字和点构成,推荐采用 A.B.C.D 四段式的形式。

四段式推荐的含义如下所示:

  • 第一段:主版本号/Major,范围0~99,重大修改的版本,如实现新的大功能或重大变化。

  • 第二段:次版本号/Minor,范围0~99,表示实现较突出的特点,如新功能添加或大问题修复。

  • 第三段:特性版本号/Feature,范围0~99,标识规划的新版本特性。

  • 第四段:修订版本号/Patch,范围0~999,表示维护版本,如修复bug。


原文出处:/show_1GWw6jiFah.html