小程序全局配置之app.json

2016-10-19

当我们使用开发工具创建好我们的工程时候,给到我们的 app.json 文件并不是很完整,我们可以配置更多的参数,来让我们的小程序更加的强大

包含所有配置项的 app.json

{
  "pages": [
    "pages/index/index",
    "pages/logs/logs"
  ],
  "window": {
    "navigationBarBackgroundColor": "#ffffff",
    "navigationBarTextStyle": "black",
    "navigationBarTitleText": "小程序app.json文件",
    "backgroundColor": "#eeeeee",
    "backgroundTextStyle": "light"
  },
  "tabBar": {
    "color": "#353535",
    "selectedColor": "#3cc51f",
    "borderStyle": "white",
    "backgroundColor": "#ffffff",
    "list": [{
      "pagePath": "pages/index/index",
      "iconPath": "images/icon_API.png",
      "selectedIconPath": "images/icon_API_HL.png",
      "text": "首页"
    }, {
      "pagePath": "pages/logs/logs",
      "iconPath": "images/icon_component.png",
      "selectedIconPath": "images/icon_component_HL.png",
      "text": "日志"
    }]
  },
  "networkTimeout": {
    "request": 10000,
    "downloadFile": 10000
  },
  "debug": true
}

配置项释义

  • pages

    必填配置,设置页面路径,数组类型

  • window

    可选配置,设置默认页面的窗口表现,对象类型

    • navigationBarBackgroundColor: 导航栏背景颜色,如”#000000”,十六进制颜色

    • navigationBarTextStyle:导航栏标题颜色,仅支持 black/white

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

    • backgroundColor:窗口的背景色,十六进制颜色

    • backgroundTextStyle:下拉背景字体、loading 图的样式,仅支持 dark/light

    • enablePullDownRefresh:是否开启下拉刷新,后面讲解

  • tabBar

    可选配置,如果我们的小程序是一个多 tab 应用(客户端窗口的底部有tab栏可以切换页面),那么我们可以通过 tabBar 配置项指定 tab 栏的表现,以及 tab 切换时显示的对应页面。

    • color :tab 上的文字默认颜色,必填

    • selectedColor:tab 上的文字选中时的颜色,必填

    • backgroundColor:tab的背景色,必填,十六进制颜色

    • borderStyle:tabbar上边框的颜色, 仅支持 black/white,可选

    • list:tab 的列表,最少2个、最多5个 tab,以下四个参数必填

      • pagePath : 页面路径,必须在 pages 中先定义

      • text: tab 上按钮文字

      • iconPath : 图片路径,icon 大小限制为40kb

      • selectedIconPath :选中时的图片路径,icon 大小限制为40kb

  • networkTimeout

    可选配置,可以设置各种网络请求的超时时间。

    • request: 发起https请求的超时时间,单位毫秒

    • connectSocket: 创建一个 WebSocket 连接的超时时间,单位毫秒

    • uploadFile: 将本地资源上传到开发者服务器的超时时间,单位毫秒

    • downloadFile: 下载文件资源到本地的超时时间,单位毫秒

  • debug

    可选配置

    可以在开发者工具中开启 debug 模式,在开发者工具的控制台面板,调试信息以 info 的形式给出,其信息有Page的注册,页面路由,数据更新,事件触发 。 可以帮助开发者快速定位一些常见的问题。

###本文代码
请查看此目录下面的 wx1 文件夹