第4章 小程序的配置文件

第4章小程序的配置文件全局配置文件sitemap配置文件页面配置文件项目配置文件01020403全局配置文件全局配置文件小程序的全局配置文件控制着小程序的全局表现，所有的配置项都在项目根目录下的app.json文件中进行配置。全局配置文件的内容是一个JSON对象，涵盖了小程序的页面路径、窗口表现、底部tab栏、默认启动页、网络超时时间等几十项配置信息。全局配置文件小程序根目录下的app.json文件用来对微信小程序进行全局配置。文件内容为一个JSON对象，核心属性包括：entryPagePath，小程序默认启动首页；pages，页面路径列表；window，全局的默认窗口表现；tabBar，底部tab栏的表现；networkTimeout，网络超时时间；debug，是否开启debug模式，默认关闭；functionalPages，是否启用插件功能页；singlePage，单页模式相关配置。页面配置文件页面配置文件小程序的页面配置文件用于对当前页面的窗口表现进行配置。页面的配置在当前页面会覆盖app.json的window属性中的相同配置项。page.json可以对当前页面的导航栏、窗口背景、下拉刷新、上拉触底、页面自定义组件等表现能力进行配置。页面配置文件页面配置文件内容为一个JSON对象，核心属性包括：navigationBarBackgroundColor，导航栏背景颜色；navigationBarTextStyle，导航栏标题颜色，仅支持black/white；navigationBarTitleText，导航栏标题文字内容；navigationStyle，导航栏样式；backgroundColor，窗口的背景色；backgroundTextStyle，下拉loading的样式，仅支持dark/light；enablePullDownRefresh，是否开启当前页面下拉刷新； onReachBottomDistance，页面上拉触底事件触发时距页面底部距离，单位为px；pageOrientation，屏幕旋转设置，支持auto/portrait/landscape。sitemap配置文件sitemap配置文件微信客户端提供了搜索小程序的能力，开发者可以通过sitemap.json配置文件来配置小程序页面是否允许被微信索引。当开发者允许微信索引时，微信会通过爬虫的形式，为小程序的页面内容建立索引。当用户的搜索词条触发该索引时，小程序的页面将可能展示在搜索结果中。sitemap配置文件rules配置项指定了索引规则，每项规则为一个JSON对象，属性如下所示：action，命中该规则的页面是否能被索引；page，页面的路径；params，当page字段指定的页面在被本规则匹配时可能使用的页面参数名称的列表（不含参数值）；matching string，当page字段指定的页面在被本规则匹配时，此参数说明params匹配方式；priority，优先级，值越大则规则越早被匹配，否则默认从上到下匹配。sitemap配置文件matching取值说明如下：exact，当小程序页面的参数列表等于params时，规则命中；inclusive，当小程序页面的参数列表包含params时，规则命中；exclusive，当小程序页面的参数列表与params交集为空时，规则命中；partial，当小程序页面的参数列表与params交集不为空时，规则命中。sitemap配置文件sitemap文件配置示例代码：{"rules":[{"action":"allow","page":"path/to/page","params":["a","b"],"matching":"exact"},{"action":"disallow","page":"path/to/page"}]}项目配置文件