小程序配置 app.json

小程序配置 app.json

app.json 是当前小程序的全局配置，包括了小程序的所有页面路径、界面表现、网络超时时间、底部 tab 等。QuickStart 项目里边的 app.json 配置内容如下

{
  "pages":[
    "pages/index/index",
    "pages/logs/logs"
  ],
  "window":{
    "backgroundTextStyle":"light",    //下拉字体颜色
    "navigationBarBackgroundColor": "#fff",  //导航背景颜色
    "navigationBarTitleText": "Weixin",  //修改，改变程序导航栏名称
    "navigationBarTextStyle":"black" }  //导航栏标题颜色配置
 }

我们简单说一下这个配置各个项的含义:

1. pages字段 —— 用于描述当前小程序所有页面路径，这是为了让微信客户端知道当前你的小程序页面定义在哪个目录。
2. window字段 —— 定义小程序所有页面的顶部背景颜色，文字颜色定义等。

小程序根目录下的 app.json 文件用来对微信小程序进行全局配置，决定页面文件的路径、窗口表现、设置网络超时时间、设置多 tab 等。

完整配置项说明请参考小程序全局配置

以下是一个包含了部分常用配置选项的 app.json ：

{
  "pages": [　　　　　　　　　　　//页面路径列表
    "pages/index/index",
    "pages/logs/index"
  ],
  "window": {　　　　　　　　　　//全局的默认窗口表现
    "navigationBarTitleText": "Demo"
  },
  "tabBar": {　　　　　　　　　　//自定义底部导航栏
    "list": [{
      "pagePath": "pages/index/index",
      "text": "首页"
    }, {
      "pagePath": "pages/logs/index",
      "text": "日志"
    }]
  },
  "networkTimeout": {　　　　　　//网络请求的超时时间
    "request": 10000,
    "downloadFile": 10000
  },
  "debug": true,　　　　　　　　//是否开启debug模式
  "navigateToMiniProgramAppIdList": [
    "wxe5f52902cf4de896"
  ]

　　"position": "bottom"　　//底部

}

  "sitemapLocation": "sitemap.json"　　//sitemapLocation指明 sitemap.json 的位置；默认为 'sitemap.json' 即在 app.json 同级目录下名字的 sitemap.json 文件

}

完整配置项说明请参考小程序全局配置

tabBar ：自定义底部导航栏

页面配置

每一个小程序页面也可以使用同名 .json 文件来对本页面的窗口表现进行配置，页面中配置项会覆盖 app.json 的 window 中相同的配置项。

完整配置项说明请参考小程序页面配置

例如：

{
  "navigationBarBackgroundColor": "#ffffff",
  "navigationBarTextStyle": "black",
  "navigationBarTitleText": "微信接口功能演示",
  "backgroundColor": "#eeeeee",
  "backgroundTextStyle": "light"    //下拉字体颜色

}