我的微信小程序第三篇（app.json）

前言

端午节回家了，所以好多天没有更新，只想说还是待在家里舒服呀，妈妈各种做好吃的，小侄子侄女各种粘着我在室外玩，导致我三天下来不仅胖了一圈，还黑了一圈，上班第一天有同事就说我晒黑了，哭~~~，为了防止自己的"懒癌"症复发，赶紧打开电脑敲敲字，废话不多说，我们就回到今天的主题，今天给大家介绍下微信小程序框架主体文件中的配置文件（app.json）,其实我们在上一篇《我的微信小程序第二篇》中已经对app.json做过简单的描述，在此篇中，我们将对其进行详细的介绍。

正文

app.json是小程序的全局配置文件，编写时需严格遵循json的格式规范，app.json在程序加载时加载，负责全局配置，其配置项有：

• pages：设置页面路径，必填

• window：设置默认页面的窗口表现

• tabBar：设置tab的表现

• networkTimeOut：设置网络超时时间

• debug：设置是否开启debug模式，默认关闭false

app.json文件内容整体结构如下;

1. pages配置

   pages负责注册小程序页面，必须填写，值为一个包含页面路径的数组，用来指定小程序由哪些页面构成，如下所示：

     //页面路径设置

     "pages":[

       "pages/index/index",

       "pages/logs/logs"

     ]

   pages中不需要填写文件后缀名，渲染页面时框架会自动寻找路径.json,.js,.wxml,.wxss四个文件进行整合，建议文件名和目录名保持一致，便于管理，pages配置中第一项代表小程序的初始页面，小程序增加或者修改，删除页面都需要对pages进行相应的调整。

2.window配置

Window负责小程序状态栏，导航条，标题，窗口背景色等系统级样式。属性有：

• navigationBarBackgroundColor：导航栏背景色，默认值为#fff

• navigationBarTextStyle：导航栏标题颜色，仅支持black/white,默认值为black

• navigationBarTitleText：导航栏标题文字内容

• backgroundTextStyle：下拉背景字体，loading图样式，仅支持dark/light

• backgroundColor：窗口背景色，默认值为#ffffff

• enablePullDownRefresh：是否开启下拉刷新，默认为false，开启后，当用户下拉时会触发页面onPullDownRefresh事件

3.TabBar配置

当程序顶部或者底部需要菜单栏时，我们可以通过tabbar设置，非必填，属性如下：

• color：tab上文字默认颜色，默认值为#000000

• selectedColor：tab上文字选中时的颜色，默认值为#000000

• backgroundColor：tab背景色

• borderStyle：tabbar上边框颜色，仅支持blackwhite,默认值为black

• list：tab的列表，必填项，其值为一个数组，最少2个，最多5个，数组中每一个项是一个对象，代表一个tab的相关配置，配置如下：

• pagepath：页面路径，必须在pages中先定义，必填项

• text：tab上按钮的文字

• iconpath：tab上icon的相对路径，icon大小限制在40kb

• selectedIconPath：选中图片的相对路径，，icon大小限制在40kb

• position：在顶部或者底部显示，可选值为bottom/top，默认值为bottom

  4.networkTimeout配置

  小程序中各种请求API的超时时间只能通过networktimeout统一设置，不能在api中单独设置，属性如下：

• request：设置wx.request的超时时间，单位毫秒

• connectSocket:设置wx.connectSocket的超时时间，单位毫秒

• uploadFile:设置wx.uploadFile的超时时间，单位毫秒

• downloadFile：设置wx.downloadFile的超时时间，单位为毫秒

  5.debug配置

• 此配置项控制是否开启debug模式，默认是关闭的，当开启debug模式时，在开发者工具面板，调试信息以info形式输出，有page注册，页面路由，数据更新，事件触发，可以帮助开发者快速定位一些问题。

相关推荐：《微信小程序开发入门及案例详解》---李骏

欢迎关注我的个人微信公众号