微信小程序：全局配置app.json详解编程语言

一、全局配置app.json

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/logs", 

 "text": "日志" 

 "networkTimeout": { 

 "request": 10000, 

 "downloadFile": 10000 

 "debug": true 

}

app.json 配置项列表：

（1）pages：

用于指定小程序由哪些页面组成，每一项都对应一个页面的 路径+文件名 信息。文件名不需要写文件后缀，框架会自动去寻找对于位置的 .json, .js, .wxml, .wxss 四个文件进行处理。

数组的第一项代表小程序的初始页面（首页）。小程序中新增/减少页面，都需要对 pages 数组进行修改。

如开发目录为：

├── app.js 

├── app.json 

├── app.wxss 

├── pages 

│ │── index 

│ │ ├── index.wxml 

│ │ ├── index.js 

│ │ ├── index.json 

│ │ └── index.wxss 

│ └── logs 

│ ├── log.wxml 

│ └── log.js 

└── utils

则需要在 app.json 中写：

{ 

 "pages":[ 

 "pages/index/index", 

 "pages/logs/logs" 

}

（2）window：

用于设置小程序的状态栏、导航条、标题、窗口背景色。

注：HexColor（十六进制颜色值），如 #ff00ff

注：navigationStyle 只在 app.json 中生效。开启 custom 后，低版本客户端需要做好兼容。开发者工具基础库版本切到 1.7.0（不代表最低版本，只供调试用）可方便切到旧视觉

注：客户端 6.7.2 版本开始，navigationStyle: custom 对  web-view  组件无效

如 app.json ：

{ 

 "window":{ 

 "navigationBarBackgroundColor": "#ffffff", 

 "navigationBarTextStyle": "black", 

 "navigationBarTitleText": "微信接口功能演示", 

 "backgroundColor": "#eeeeee", 

 "backgroundTextStyle": "light" 

}

（3）tabBar：

如果小程序是一个多 tab 应用（客户端窗口的底部或顶部有 tab 栏可以切换页面），可以通过 tabBar 配置项指定 tab 栏的表现，以及 tab 切换时显示的对应页面。

其中 list 接受一个数组，只能配置最少2个、最多5个 tab。tab 按数组的顺序排序，每个项都是一个对象，其属性值如下：

（4）networkTimeout：

各类网络请求的超时时间，单位均为毫秒。

（5）debug：

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

（6）functionalPages：

基础库 2.1.0 开始支持，低版本需做兼职处理。

启用插件功能页时，插件所有者小程序需要设置其 functionalPages 为 true。

（7）subPackages：

微信客户端 6.6.0 ，基础库 1.7.3 及以上版本支持

启用分包加载时，声明项目分包结构。

（8）workers：

基础库 1.9.90 开始支持，低版本需做兼职处理。

使用 Worker 处理多线程任务时，设置 Worker 代码放置的目录

（9）requiredBackgroundModes：

微信客户端 6.7.2 及以上版本支持

申明需要后台运行的能力，类型为数组。目前支持以下项目：

audio: 后台音乐播放

如：

{ 

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

 "requiredBackgroundModes": ["audio"] 

}

注：在此处申明了后台运行的接口，开发版和体验版上可以直接生效，正式版还需通过审核。

（10）plugins：

基础库 1.9.6 开始支持，低版本需做兼职处理。

声明小程序需要使用的插件。

 

原创文章，作者：ItWorker，如若转载，请注明出处：https://blog.ytso.com/16710.html

cjavaxml