manifest配置及须知更新时间:2025-12-25 09:37:01
一、manifest说明
在小游戏中,manifest.json 是一个核心配置文件,用于声明游戏的基本信息、版本号、资源路径、分包规则等关键内容。平台通过解析该文件识别游戏的运行参数、资源路径等,实现游戏的正常加载和运行。
manifest.json中的很多字段可以在各引擎导出时在面板中填写,如包名、游戏名、最小平台版本号等,也可在构建出的小游戏工程中手动进行修改。
注意事项:如手动修改了manifest.json中的字段,如游戏版本号等,需要重新进行打包才可生效,将修改后的manifest.json打入rpk包中。
二、manifest各配置项的注意事项
1.manifest.json配置文件字段说明
{
"package": "com.minigame.demo", //小游戏包名
"name": "mini game", //小游戏名称
"icon": "/image/logo.png", //小游戏icon
"versionName": "1.0.0", //小游戏版本
"versionCode": 1, //小游戏版本号,int 类型
"minPlatformVersion": 1308, //最小支持版本,int 类型
"orientation": "portrait", //屏幕方向,默认值为portrait。portrait为竖屏 或landscape横屏
"type": "game", //默认值为app,取值为app或game
"config": {
"logLevel": "log" //logLevel取值off,error,warn,info,log,debug,trace
},
"subpackages": [ //分包配置
{
"name": "sub1Name", //子包名称
"root": "sub1/" //可以指定一个目录,该目录根目录下的 main.js 会作为入口文件
},
{
"name": "sub2Name", //子包名称
"root": "sub2.js" //也可以指定一个 JS 文件
}
]
}
"quickGameCliVersion":"0.2.5" // 若是使用大于等于0.2.5打包工具版本打出的runtime包中会有此字段2.manifest各配置项的注意事项
1、package:小游戏包名后缀需要使用在小米平台注册过的合法的包名后缀,否则无法在开发者后台上传,如.mini。
2、subpacakges:若游戏引擎或使用的引擎版本不支持自动分包配置,则可以在subpacakges字段中可以进行手动分包配置,命名name由开发者自己决定,各分包的路径需确保和自己小游戏工程中的文件夹路径一致(关于分包操作的说明详见分包目录及大小限制)。
3、minPlatformVersion:该字段即为最小平台版本号,该字段含义为游戏只能运行在大于等于该版本的快应用服务框架上,若快应用服务框架低于此版本的手机则会屏蔽此游戏。webview包建议最小平台版本号为1076,如果是打runtime包,则该字段会被打包工具默认设为1308且无法低于此版本,即使手动改为较低的版本也会被打包工具强制修正为1308。
上一篇:项目目录
下一篇:分包目录及大小限制
文档内容是否有帮助?
有帮助
无帮助