小程序的全局配置文件app.json
qingheluo2020-12-15清河洛648
配置项
配置项子项
数据类型
是否必需
配置详解
entryPagePath
string
否
小程序默认启动首页，默认为pages列表的第一项
pages
Array
是
指定小程序由哪些页面组成，每一项都对应一个含文件名的页面路径，文件名不需要写后缀，会自动去寻找对应的.json，.js，.wxml，.wxss四个文件进行处理
debug
boolea
否
是否开启 debug 模式，默认关闭
functionalPages
boolean
否
是否启用插件功能页，默认关闭
window
Object
否
全局的默认窗口表现
navigati...
| 配置项 | 配置项子项 | 数据类型 | 是否必需 | 配置详解 |
| entryPagePath | string | 否 | 小程序默认启动首页，默认为pages列表的第一项 | |
| pages | Array | 是 | 指定小程序由哪些页面组成，每一项都对应一个含文件名的页面路径，文件名不需要写后缀，会自动去寻找对应的.json，.js，.wxml，.wxss四个文件进行处理 | |
| debug | boolea | 否 | 是否开启 debug 模式，默认关闭 | |
| functionalPages | boolean | 否 | 是否启用插件功能页，默认关闭 | |
| window | Object | 否 | 全局的默认窗口表现 | |
| navigationBarBackgroundColor | string | 十六进制导航栏背景颜色，默认"#000000" | ||
| navigationBarTextStyle | string | 导航栏标题颜色，仅支持black/white，默认white | ||
| navigationBarTitleText | string | 导航栏标题文字内容 | ||
| navigationStyle | string | 导航栏样式，仅支持fault默认样式，custom自定义导航栏 | ||
| backgroundColor | string | 十六进制窗口背景色 | ||
| backgroundTextStyle | string | 下拉 loading 的样式，仅支持dark/light，默认dark | ||
| enablePullDownRefresh | boolean | 是否开启全局的下拉刷新，默认false | ||
| onReachBottomDistance | number | 页面上拉触底事件触发时距页面底部距离，单位为 px，默认50 | ||
| pageOrientation | string | 屏幕旋转设置，支持auto/portrait/landscape | ||
| tabBar | Object | 否 | 底部 tab 栏的表现 | |
| color | string | 是 | tab 上的文字默认十六进制颜色 | |
| selectedColor | string | 是 | tab 上的文字选中时的十六进制颜色 | |
| backgroundColor | string | 是 | tab 的十六进制背景色 | |
| borderStyle | string | 否 | tabbar 上边框的颜色， 仅支持black/white，默认black | |
| list | Array | 是 | tab 的列表，最少 2 个、最多 5 个 tab，每个元素为一个Object，包含pagePath(页面路径，必需，需要在pages中先定义)，text(必需，tab上的文字)，iconPath(非必需，tab上的显示图片，格式为icon，不超过40kb，当tab在顶部时不显示)，selectedIconPath(非必需，选中时tab上的显示图片，格式为icon，不超过40kb，当tab在顶部时不显示) | |
| position | string | 否 | tabBar 的位置，仅支持bottom/top，默认bottom | |
| networkTimeout | Object | 否 | 各类网络请求的超时时间，单位均为毫秒 | |
| request | number | 默认60000 | ||
| connectSocket | number | 默认60000 | ||
| uploadFile | number | 默认60000 | ||
| downloadFile | number | 默认60000 | ||
| subpackages | Array | 否 | 启用分包加载时，声明项目分包结构 | |
| workers | string | 否 | 使用 Worker 处理多线程任务时，设置 Worker 代码放置的目录 | |
| requiredBackgroundModes | Array | 否 | 申明需要后台运行的能力，由字符串组成的数组。目前支持audio后台音乐播放，location:后台定位 | |
| plugins | Object | 否 | 声明小程序需要使用的插件 | |
| preloadRule | Object | 否 | 声明分包预下载规则 | |
| resizable | boolean | 否 | PC 小程序是否支持用户任意改变窗口大小（包括最大化窗口）；iPad 小程序是否支持屏幕旋转。默认关闭 | |
| usingComponents | Object | 否 | 声明全局自定义组件，在小程序内的页面或自定义组件中可以直接使用而无需再声明 | |
| permission | Object | 否 | 小程序接口权限开关及提示文字，每个权限为一个Object，名称为权限名，包含desc属性，表示获取权限时的提示文字，详细权限参见https://developers.weixin.qq.com/miniprogram/dev/framework/open-ability/authorize.html | |
| sitemapLocation | string | 否 | 指明 sitemap.json 的位置，默认为 app.json 同级目录下的sitemap.json文件 | |
| style | string | 否 | 指定使用基础组件的样式，可选值"v2" | |
| useExtendedLib | Object | 否 | 指定需要引用的扩展库，包含两个属性kbone多端开发框架，weuiWeUI 组件库，这两个属性为值boolean类型 | |
| entranceDeclare | Object | 否 | 聊天位置消息用打车类小程序打开 | |
| darkmode | boolean | 否 | 小程序是否支持 DarkMode | |
| themeLocation | string | 否 | 指定theme.json的路径，当配置"darkmode":true时，该配置为必填项 | |
| lazyCodeLoading | string | 否 | 配置自定义组件代码按需注入，可选值"requiredComponents"，添加这项配置后，未使用到的代码文件将不被执行 | |
| singlePage | Object | 否 | 单页模式相关配置，属性"navigationBarFit"是一个string类型，导航栏与页面的相交状态，值为 float 时表示导航栏浮在页面上，与页面相交；值为 squeezed 时表示页面被导航栏挤压，与页面不相交，默认自动调整，若原页面是自定义导航栏，则为 float，否则为 squeezed |