微信小程序app.json全局配置
小程序根目录下的 app.json 文件用来对微信小程序进行全局配置。文件内容为一个 JSON 对象,有以下属性:
app.json配置项(该配置项由微信小程序开发文档复制而来)
属性 |
类型 |
必填 |
描述 |
最低版本 |
entryPagePath |
string |
否 |
小程序默认启动首页 |
|
pages |
string[] |
是 |
页面路径列表 |
|
window |
Object |
否 |
全局的默认窗口表现 |
|
tabBar |
Object |
否 |
底部 tab 栏的表现 |
|
networkTimeout |
Object |
否 |
网络超时时间 |
|
debug |
boolean |
否 |
是否开启 debug 模式,默认关闭 |
|
functionalPages |
boolean |
否 |
是否启用插件功能页,默认关闭 |
2.1.0 |
subpackages |
Object[] |
否 |
分包结构配置 |
1.7.3 |
workers |
string |
否 |
Worker 代码放置的目录 |
1.9.90 |
requiredBackgroundModes |
string[] |
否 |
需要在后台使用的能力,如「音乐播放」 |
|
requiredPrivateInfos |
string[] |
否 |
调用的地理位置相关隐私接口 |
|
plugins |
Object |
否 |
使用到的插件 |
1.9.6 |
preloadRule |
Object |
否 |
分包预下载规则 |
2.3.0 |
resizable |
boolean |
否 |
PC 小程序是否支持用户任意改变窗口大小(包括最大化窗口);iPad 小程序是否支持屏幕旋转。默认关闭 |
2.3.0 |
usingComponents |
Object |
否 |
全局自定义组件配置 |
开发者工具 1.02.1810190 |
permission |
Object |
否 |
小程序接口权限相关设置 |
微信客户端 7.0.0 |
sitemapLocation |
string |
是 |
指明 sitemap.json 的位置 |
|
style |
string |
否 |
指定使用升级后的 weui 样式 |
2.8.0 |
useExtendedLib |
Object |
否 |
指定需要引用的扩展库 |
2.2.1 |
entranceDeclare |
Object |
否 |
微信消息用小程序打开 |
微信客户端 7.0.9 |
darkmode |
boolean |
否 |
小程序支持 DarkMode |
2.11.0 |
themeLocation |
string |
否 |
指明 theme.json 的位置,darkmode为 true 为必填 |
开发者工具 1.03.2004271 |
lazyCodeLoading |
string |
否 |
配置自定义组件代码按需注入 |
2.11.1 |
singlePage |
Object |
否 |
单页模式相关配置 |
2.12.0 |
supportedMaterials |
Object |
否 |
聊天素材小程序打开相关配置 |
2.14.3 |
serviceProviderTicket |
string |
否 |
定制化型服务商票据 |
|
embeddedAppIdList |
string[] |
否 |
半屏小程序 appId |
2.20.1 |
halfPage |
Object |
否 |
视频号直播半屏场景设置 |
2.18.0 |
debugOptions |
Object |
否 |
调试相关配置 |
2.22.1 |
enablePassiveEvent |
Object或boolean |
否 |
touch 事件监听是否为 passive |
2.24.1 |
resolveAlias |
Object |
否 |
自定义模块映射规则 |
|
renderer |
string |
否 |
全局默认的渲染后端 |
2.25.2 |