微信小程序 app.json 配置

微信小程序的开发中，每个小程序都需要一个 app.json 文件来进行全局性质的配置，包括小程序的页面路由、窗口颜色、导航栏样式等内容，下面我们来逐一介绍 app.json 的配置选项及其作用。

页面路由配置

app.json 中的 pages 配置项，用于指定小程序的所有页面路径。其中，第一个页面为小程序的首页，也是小程序打开时的默认页面。一个常见的 pages 配置如下：

"pages": [
  "pages/index/index",
  "pages/list/list",
  "pages/detail/detail"
],

窗口样式配置

app.json 中的 window 配置项，用于指定小程序的全局窗口样式，包括窗口的背景色、是否允许下拉刷新、导航栏样式等。下面是一个常见的 window 配置：

"window": {
  "backgroundTextStyle": "light",
  "navigationBarBackgroundColor": "#fff",
  "navigationBarTitleText": "小程序标题",
  "navigationBarTextStyle": "black"
}

其中，backgroundTextStyle 表示窗口背景色的文字样式，可选值为"light"和"dark"；navigationBarBackgroundColor 表示导航栏颜色，以16进制颜色代码表示；navigationBarTitleText 表示导航栏标题；navigationBarTextStyle 表示导航栏颜色的文字样式，可选值为"black"和"white"。

网络超时时间配置

app.json 中的 networkTimeout 配置项，用于指定小程序的网络请求超时时间，包括HTTP请求和WebSocket请求。下面是一个常见的 networkTimeout 配置：

"networkTimeout": {
  "request": 10000,
  "downloadFile": 10000,
  "uploadFile": 10000,
  "socketTask": 10000
}

其中，request 表示HTTP请求的超时时间；downloadFile 表示下载文件的超时时间；uploadFile 表示上传文件的超时时间；socketTask 表示WebSocket请求的超时时间。

窗口表现配置

app.json 中的 window 配置项还可以用于指定小程序的窗口表现，包括是否允许下拉刷新、是否允许截图、导航栏样式等。下面是一个常见的 window 配置：

"window": {
  "enablePullDownRefresh": true,
  "disableScroll": false,
  "backgroundColor": "#F7F7F7",
  "backgroundTextStyle": "light",
  "navigationBarTextStyle": "white",
  "navigationBarBackgroundColor": "#0081ff",
  "navigationBarTitleText": "小程序标题",
  "navigationStyle": "default",
  "enableShareAppMessage": true
}

其中，enablePullDownRefresh 表示是否允许下拉刷新；disableScroll 表示是否禁止页面滚动；backgroundColor 表示窗口背景颜色；backgroundTextStyle 表示窗口背景色文字样式；navigationBarTextStyle 表示导航栏颜色的文字样式；navigationBarBackgroundColor 表示导航栏背景颜色；navigationBarTitleText 表示导航栏标题文字；navigationStyle 表示导航栏样式，可选值为"default"和"custom"；enableShareAppMessage 表示是否允许分享小程序。

总结

以上就是微信小程序 app.json 文件的配置选项及其作用，通过 app.json 文件的配置，我们可以更好地控制小程序的页面路由、窗口颜色、导航栏样式、网络超时时间等。同时，app.json 的配置也可以通过微信官方开发者工具中的图形界面进行可视化的配置，并可直接生成 app.json 文件代码。