配置项 |
配置项子项 |
数据类型 |
是否必需 |
配置详解 |
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 |