在计算机科学领域,配置文件(英语:configuration file,台湾作设定档)是一种计算机文件,可以为一些计算机程序配置参数和初始设置。
任何计算机编程语言都有自己的配置文件,小程序也不例外,小程序配置文件主要是JSON形式存在,最主要的配置文件有两种app.json和page.json
⼀个⼩程序应⽤程序会包括最基本的两种配置⽂件。⼀种是全局的 app.json 和页面自己的page.json
注意:配置文件中不能出现注释
app.json 是当前⼩程序的全局配置,包括了⼩程序的所有⻚⾯路径、界⾯表现、⽹络超时时间、底
部 tab 等。普通快速启动项⽬⾥边的 app.json 配置

字段的含义

pages主要定义小程序的页面路径信息,一般排在第一位的是小程序启动第一个展示页面
⻚⾯的配置只能设置 app.json 中部分 window 配置项的内容,⻚⾯中配置项会覆盖 app.json
的 window 中相同的配置项。
| 属性 | 类型 | 默认值 | 描述 |
|---|---|---|---|
| navigationBarBackgroundColor | HexColor | #000000 | 导航栏背景颜⾊,如 #000000 |
| navigationBarTextStyle | String | white | 导航栏标题颜⾊,仅⽀持 black / white |
| navigationBarTitle | Text | String | 导航栏标题⽂字内容 |
| backgroundColor | HexColo | r #ffffff | 窗⼝的背景⾊ |
| backgroundTextStyle | String | dark | 下拉 loading 的样式,仅⽀持 dark / light |
| enablePullDownRefresh | Boolean | false | 是否全局开启下拉刷新。 详⻅ Page.onPullDownRefresh |
| onReachBottomDistance | Number | 50 | ⻚⾯上拉触底事件触发时距⻚⾯底部距离,单位为px。 详⻅Page.onReachBottom |
| disableScroll | Boolean | false | 设置为 true 则⻚⾯整体不能上下滚动;只在⻚⾯配置中有效,⽆法在 app.json 中设置该项 |
tabBar主要是对导航的配置比如:选中和为选中图标,背景颜色,边框样式。

⼩程序根⽬录下的 sitemap.json ⽂件⽤于配置⼩程序及其⻚⾯是否允许被微信索引。