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 }