发布时间:2022-08-18 18:22
小程序根目录下的 app.json 文件用来对微信小程序进行全局配置,决定页面文件的路径、窗口表现、设置网络超时时间、设置多 tab 等。
小程序根目录下的 app.json 文件用来对微信小程序进行全局配置。文件内容为一个 JSON 对象,有以下属性:
属性 |
类型 |
必填 |
描述 |
最低版本 |
entryPagePath |
string |
否 |
小程序默认启动首页 |
|
pages |
string[] |
是 |
页面路径列表 |
|
window |
Object |
否 |
全局的默认窗口表现 |
|
tabBar |
Object |
否 |
底部 tab 栏的表现 |
|
networkTimeout |
Object |
否 |
网络超时时间 |
|
debug |
boolean |
否 |
是否开启 debug 模式,默认关闭 |
|
functionalPages |
boolean |
否 |
是否启用插件功能页,默认关闭 |
2.1.0 |
subpackages |
Object[] |
否 |
分包结构配置 |
1.7.3 |
workers |
string |
否 |
Worker 代码放置的目录 |
1.9.90 |
requiredBackgroundModes |
string[] |
否 |
需要在后台使用的能力,如「音乐播放」 |
|
plugins |
Object |
否 |
使用到的插件 |
1.9.6 |
preloadRule |
Object |
否 |
分包预下载规则 |
2.3.0 |
resizable |
boolean |
否 |
PC 小程序是否支持用户任意改变窗口大小(包括最大化窗口);iPad 小程序是否支持屏幕旋转。默认关闭 |
2.3.0 |
usingComponents |
Object |
否 |
全局自定义组件配置 |
开发者工具 1.02.1810190 |
permission |
Object |
否 |
小程序接口权限相关设置 |
微信客户端 7.0.0 |
sitemapLocation |
string |
是 |
指明 sitemap.json 的位置 |
|
style |
string |
否 |
指定使用升级后的weui样式 |
2.8.0 |
useExtendedLib |
Object |
否 |
指定需要引用的扩展库 |
2.2.1 |
entranceDeclare |
Object |
否 |
微信消息用小程序打开 |
微信客户端7.0.9 |
darkmode |
boolean |
否 |
小程序支持 DarkMode |
2.11.0 |
themeLocation |
string |
否 |
指明 theme.json 的位置,darkmode为true为必填 |
开发者工具 1.03.2004271 |
lazyCodeLoading |
string |
否 |
配置自定义组件代码按需注入 |
2.11.1 |
singlePage |
Object |
否 |
单页模式相关配置 |
2.12.0 |
指定小程序的默认启动路径(首页),常见情景是从微信聊天列表页下拉启动、小程序列表启动等。如果不填,将默认为 pages 列表的第一项。不支持带页面路径参数。
{
"pages":[
"pages/thief/thief",
"pages/index/index",//首页
"pages/logs/logs",
"pages/thief/thief-detail/thief-detail"
],
}
参考文档:全局配置 | 微信开发文档