app.json文件用来对微信小程序进行全局配置,决定页面文件的路径、窗口表现、设置网络超时时间、设置多 tab 等。
注意:
1) json配置中键名、键值必须使用双引号,不能使用单引号。
2) 以下配置中除了page字段是必需设置,其它项目为可选项。
置项说明:
1 {
2
3 /**
4 * 【必需】 pages 键值是一列数组
5 * 指定小程序由哪些页面组成,每一项都对应一个页面的 路径+文件名 信息。文件名不需要写文件后缀
6 * 数组第一项代表小程序的首页
7 **/
8 "pages": [
9 "pages/index/index",
10 "pages/logs/index"
11 ],
12
13
14 /**
15 * window 用于设置小程序的状态栏、导航条、标题、窗口背景色。
16 **/
17 "window": {
18
19 /**
20 * 以下是页面顶部导航栏设置
21 **/
22 "navigationBarBackgroundColor" : "[Color]", // 导航栏背景颜色,默认值:#000000
23 "navigationBarTextStyle" : "white|black", // 导航栏标题颜色,默认值white
24 "navigationBarTitleText": "[String]" , // 导航栏标题文字内容
25 "navigationStyle" : "default|custom", // 导航样式,默认值default。 custom 自定义导航栏,只保留右上角胶囊按钮
26
27 /**
28 * 以下是下拉刷新或上拉触底设置
29 **/
30 "backgroundColor" : "[Color]", // 窗口的背景色
31 "backgroundTextStyle" : "dark|light", // 下拉 loading 的样式,默认值dark(暗)
32 "backgroundColorTop" : "[Color]", // 顶部窗口的背景色,仅 iOS 支持
33 "backgroundColorBottom" : "[Color]", // 底部窗口的背景色,仅 iOS 支持
34 "enablePullDownRefresh" : true|false, // 是否全局开启下拉刷新,值 true | false
35 "onReachBottomDistance" : [Number] // 页面上拉触底事件触发时距页面底部距离,单位为px,默认值 50
36
37 },
38
39
40 /**
41 * tabBar 配置项指定 tab 栏的表现,以及 tab 切换时显示的对应页面。
42 **/
43 "tabBar": {
44
45 "color" : "[Color]", // 【必需】 tab 上的文字默认颜色
46 "selectedColor" : "[Color]", // 【必需】 tab 上的文字选中时的颜色
47 "backgroundColor" : "[Color]", // 【必需】 tab 的背景色
48 "borderStyle" : "black|white", // tabbar上边框的颜色, 默认值:black
49 "position" : "bottom|top", // tabBar的位置,仅支持 bottom / top
50
51 /**
52 * 【必需】 tab 的列表,最少2个、最多5个 tab
53 **/
54 "list": [
55 {
56 "pagePath": "[String]", // 【必需】 打开的页面路径,必须在 pages 中先定义
57 "text": "[String]", // 【必需】 tab 上按钮文字,比如首页
58 "iconPath" : "[String]", // 图片路径,icon 大小限制为40kb,建议尺寸为 81px * 81px,不支持网络图片。 当 postion 为 top 时,不显示 icon。
59 "selectedIconPath" : "[String]" // 选中时的图片路径,icon 大小限制为40kb,建议尺寸为 81px * 81px,不支持网络图片。当 postion 为 top 时,不显示 icon。
60 },
61 {
62 "pagePath": "[String]",
63 "text": "[String]",
64 "iconPath" : "[String]",
65 "selectedIconPath" : "[String]"
66 }
67 //设置每个列表...
68 ]
69 },
70
71
72 /**
73 * networkTimeout 各类网络请求的超时时间,单位均为毫秒。
74 **/
75 "networkTimeout": {
76 "request" : [Number], // wx.request 的超时时间。默认值 60000
77 "connectSocket" : [Number], // wx.connectSocket 的超时时间。默认值 60000
78 "uploadFile" : [Number], // wx.uploadFile 的超时时间。默认值 60000
79 "downloadFile": [Number] // wx.downloadFile 的超时时间。默认值 60000
80 },
81
82
83 /**
84 * debug 是否开启调试模式,默认关闭(false)
85 **/
86 "debug": true|false,
87
88 "resizable": true|false, // 值true时使小程序支持 iPad 屏幕旋转
89 /**
90 * functionalPages 是否启用插件功能页,默认关闭(false)
91 **/
92 "functionalPages" : true|false,
93
94
95 /**
96 * usingComponents 定义全局可以使用的自定义组件(所有页面可用)
97 **/
98 "usingComponents": {
99 "component-tag-name": "component-path", // 格式:组件标签名称 : 自定义组件路径
100 // 可定义多个自定义组件
101 }
102
103 /**
104 * subPackages
105 **/
106
107
108 /**
109 * workers
110 **/
111
112
113 /**
114 * requiredBackgroundModes
115 **/
116
117
118 /**
119 * plugins
120 **/
121
122 }