1、小程序配置app.json:app.json详细文档

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


app.json

下面我们就来一一细说一下app.json的每一个属性的用法

pages:


pages属性用法

pages属性用法

项目列表处pages文件夹下有几个文件,在app.json中,就写几个文件路径

window:


window属性

例如这样:


window演示实例

tabBar:

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


tabBar属性

networkTimeout:

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


networkTimeout属性


networkTimeout用法

debug:

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


debug用法

functionalPages:

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

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

subPackages:

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

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

workers:

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

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

requiredBackgroundModes:

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

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

audio: 后台音乐播放

如:


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

plugins:

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

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


permission:

小程序接口权限相关设置

例如:地图功能想访问用户当前位置


navigateToMiniProgramAppList:

2、工具配置 project.config.json:project.config.json详细文档

是开发者工具的配置,用来记录开发者在开发项目时的个性化配置,包括编辑器的颜色、代码上传时自动压缩等等一系列选项。可以在项目根目录使用 project.config.json 文件对项目进行配置。


project.config.json

针对project.config.json每一个字段属性的含义,如下图注释


project.config.json属性用途3、页面配置 page.json

这里的 page.json 其实用来表示 pages/logs 目录下的 logs.json 这类和小程序页面相关的配置。

如果你整个小程序的风格是蓝色调,那么你可以在 app.json 里边声明顶部颜色是蓝色即可。实际情况可能不是这样,可能你小程序里边的每个页面都有不一样的色调来区分不同功能模块,因此我们提供了 page.json,让开发者可以独立定义每个页面的一些属性,例如刚刚说的顶部颜色、是否允许下拉刷新等等。


page.json属性