在使用小程序源码时,会自动生成一个app.json的文件,是用来对微信小程序进行全局配置,官方文档详见:全局配置,下面我对常见全局配置进行说明:
{
"pages": [
"pages/index/index",
"pages/logs/logs"
],
"window": {
"backgroundTextStyle": "light",
"navigationBarBackgroundColor": "#fff",
"navigationBarTitleText": "WeChat",
"navigationBarTextStyle": "black"
},
"sitemapLocation": "sitemap.json"
}
pages:页面路径列表
在微信开发者工具里面新建page时,pages会自动生成该路径,每一项都对应一个页面的 路径(含文件名) 信息。文件名不需要写文件后缀,框架会自动去寻找对于位置的 .json, .js, .wxml, .wxss 四个文件进行处理,如果删除页面,该页面的路径需要在pages里面手动删除,不然会报页面错误。
window:全局的默认窗口表现
用于设置小程序的状态栏、导航条、标题、窗口背景色:
backgroundColor :窗口的背景色 例如 #ffffff
navigationBarBackgroundColor:导航栏背景颜色,如 #000000
navigationBarTitleText:导航栏标题文字内容(会被页面设置覆盖
navigationBarTextStyle:导航栏标题颜色,仅支持 black / white
sitemapLocation:
解决小程序项目中有 sitemap.json 但是 app.json 中没有指定 sitemaplocation 时sitemap.json 会被覆盖掉修复 偶现 applaunch with an already exist webviewid 错误修复 小游戏模拟器弹出时,wx.showkeyboard 会一闪而过的问题修复 提交版本的 " 项目备注" 历史缓存没了的问题
"tabBar": {
"color": "#707070",
"selectedColor": "#006cad",
"borderStyle": "white",
"backgroundColor": "#ffffff",
"list": [
{
"pagePath": "pages/index/index",
"iconPath": "image/12.png",
"selectedIconPath": "image/11.png",
"text": "首页"
},
{
"pagePath": "pages/list/index",
"iconPath": "image/13.png",
"selectedIconPath": "image/23.png",
"text": "产品中心"
},
{
"pagePath": "pages/component/index",
"iconPath": "image/21.png",
"selectedIconPath": "image/22.png",
"text": "公司介绍"
},
{
"pagePath": "pages/i/index",
"iconPath": "image/32.png",
"selectedIconPath": "image/31.png",
"text": "联系我们"
}
]
},
"networkTimeout": {
"request": 10000,
"connectSocket": 10000,
"uploadFile": 10000,
"downloadFile": 10000
},
"debug": true,
tabBar:底部tab栏的表现
除了tab文字、图标和背景色等常用的选项可以设置,tab上边框颜色也可以设置,tab也可以设置显示在页面顶端(不显示图标)
color:tab 上的文字默认颜色,仅支持十六进制颜色
selectedColor:tab 上的文字选中时的颜色,仅支持十六进制颜色
backgroundColor:tab 的背景色,仅支持十六进制颜色
borderStyle:tabbar上边框的颜色, 仅支持black/white
list:tab 的列表,详见list属性说明,最少2个、最多5个 tab
position:tabBar的位置,仅支持bottom/top
custom:自定义 tabBar
debug:是否开启 debug 模式,默认关闭
debug模式是针对开发者工具的,开启之后再开发者工具的控制台面板输出Page的注册,页面路由,数据更新,事件触发等之类的调试信息:
networkTimeout:各类网络请求的超时时间,单位均为毫秒
request: wx.request 的超时时间,默认:60000毫秒。
connectSocket: wx.connectSocket 的超时时间,默认:60000毫秒。
uploadFile: wx.uploadFile 的超时时间,默认:60000毫秒。
downloadFile:wx.downloadFile 的超时时间,默认:60000毫秒