介绍
本文介绍 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。