⼩程序开发⽂档-⼩程序配置全局配置
全局配置
⼩程序根⽬录下的 app.json ⽂件⽤来对⼩程序进⾏全局配置。⽂件内容为⼀个 JSON 对象，有以下属性：配置项
属性类型必
填
描述最低版本
string否⼩程序默认启动⾸页
string[]是页⾯路径列表
Object否全局的默认窗⼝表现
Object否底部 tab 栏的表现
Object否⽹络超时时间
boolean否是否开启 debug 模式，默认关闭boolean否是否启⽤插件功能页，默认关闭Object[]否分包结构配置
string否Worker 代码放置的⽬录
string[]否需要在后台使⽤的能⼒，如「⾳乐播放」Object否使⽤到的插件
Object否分包预下载规则
boolean否PC ⼩程序是否⽀持⽤户任意改变窗⼝⼤⼩（包括最⼤化窗⼝）；iPad ⼩程序是否⽀
持屏幕旋转。默认关闭
Object否全局配置
开发者⼯具1.02.1810190
Object否⼩程序接⼝权限相关设置客户端 7.0.0 string是指明 sitemap.json 的位置
string否指定使⽤升级后的weui样式
Object否指定需要引⽤的扩展库
Object否消息⽤⼩程序打开客户端7.0.9 boolean否⼩程序⽀持 DarkMode
string否指明 theme.json 的位置，darkmode为true为必填
开发者⼯具1.03.2004271
string否配置⾃定义组件代码按需注⼊
Object否单页模式相关配置supportedMaterials Object否相关配置serviceProviderTicket string否票据
string[]否半屏⼩程序 appId entryPagePath
指定⼩程序的默认启动路径（⾸页），常见情景是从聊天列表页下拉启动、⼩程序列表启动等。如果不填，将默认为 pages 列表的第⼀项。不⽀持带页⾯路径参数。
{
"entryPagePath": "pages/index/index"
}
pages
⽤于指定⼩程序由哪些页⾯组成，每⼀项都对应⼀个页⾯的 路径（含⽂件名） 信息。⽂件名不需要写⽂件后缀，框架会⾃动去寻对应位置的 .json, .js, .wxml, .wxss 四个⽂件进⾏处理。
未指定 entryPagePath 时，数组的第⼀项代表⼩程序的初始页⾯（⾸页）。
⼩程序中新增/减少页⾯，都需要对 pages 数组进⾏修改。
如开发⽬录为：
├── app.js
├── app.json
├── app.wxss
├── pages
││── index
││├── index.wxml
││├── index.js
││├── index.json
││└── index.wxss
│└── logs
│├── logs.wxml
│└── logs.js
└── utils
则需要在 app.json 中写
{
"pages": ["pages/index/index", "pages/logs/logs"]
}
window
⽤于设置⼩程序的状态栏、导航条、标题、窗⼝背景⾊。
属性类型默认值描述最低版本
navigationBarBackgroundColor HexColor#000000导航栏背景颜⾊，如 #000000
navigationBarTextStyle string white导航栏标题颜⾊，仅⽀持 black / white
navigationBarTitleText string导航栏标题⽂字内容
navigationStyle string default
导航栏样式，仅⽀持以下值：
default 默认样式
custom ⾃定义导航栏，只保留右上⾓胶囊按
钮。参见注 2。
iOS/Android 客户端
6.6.0，Windows 客户端不⽀持
backgroundColor HexColor#ffffff窗⼝的背景⾊
backgroundTextStyle string dark下拉 loading 的样式，仅⽀持 dark / light
backgroundColorTop string#ffffff顶部窗⼝的背景⾊，仅 iOS ⽀持客户端 6.5.16 backgroundColorBottom string#ffffff底部窗⼝的背景⾊，仅 iOS ⽀持客户端 6.5.16
enablePullDownRefresh boolean false 是否开启全局的下拉刷新。
详见
onReachBottomDistance number50页⾯上拉触底事件触发时距页⾯底部距离，单
位为 px。
详见
pageOrientation string portrait 屏幕旋转设置，⽀持 auto / portrait /
landscape
详见
(auto) / (landscape)
string homePage重新启动策略配置initialRenderingCache string页⾯配置，⽀持 static / dynamic
visualEffectInBackground string none 切⼊系统后台时，隐藏页⾯内容，保护⽤户隐私。⽀持 hidden / none
属性类型默认值描述最低版本
注 1：HexColor（⼗六进制颜⾊值），如"#ff00ff"
注 2：关于navigationStyle
iOS/Android 客户端 7.0.0 以下版本，navigationStyle 只在 app.json 中⽣效。
iOS/Android 客户端 6.7.2 版本开始，navigationStyle: custom 对 组件⽆效
开启 custom 后，低版本客户端需要做好兼容。开发者⼯具基础库版本切到 1.7.0（不代表最低版本，只供调试⽤）可⽅便切到旧视觉
Windows 客户端 3.0 及以上版本，为了给⽤户提供更符合桌⾯软件的使⽤体验，统⼀了⼩程序窗⼝的导航栏，navigationStyle: custom 不再⽣效
restartStrategy
基础库 2.8.0 开始⽀持，低版本需做。
配置
可选值含义
homePage（默认值）如果从这个页⾯退出⼩程序，下次将从⾸页冷启动homePageAndLatestPage如果从这个页⾯退出⼩程序，下次冷启动后⽴刻加载这个页⾯，页⾯的参数保持不变（不可⽤于 tab 页）
如：
{
"window": {
"navigationBarBackgroundColor": "#ffffff",
"navigationBarTextStyle": "black",
"navigationBarTitleText": "接⼝功能演⽰",
"backgroundColor": "#eeeeee",
"backgroundTextStyle": "light"
}
}
tabBar
如果⼩程序是⼀个多 tab 应⽤（客户端窗⼝的底部或顶部有 tab 栏可以切换页⾯），可以通过 tabBar 配置项指定 tab 栏的表现，以及tab 切换时显⽰的对应页⾯。
js导航栏下拉菜单属性类型必填默认值描述最低版本
color HexColor 是tab 上的⽂字默认颜⾊，仅⽀持⼗六进制颜⾊
selectedColor HexColor 是tab 上的⽂字选中时的颜⾊，仅⽀持⼗六进制颜⾊
backgroundColor HexColor 是tab 的背景⾊，仅⽀持⼗六进制颜⾊
borderStyle
string 否black tabbar 上边框的颜⾊， 仅⽀持 black  / white list Array 是tab 的列表，详见 list  属性说明，最少 2 个、最多 5 个 tab
position string 否bottom tabBar 的位置，仅⽀持 bottom  / top
custom
boolean
否
false
⾃定义 tabBar，见
属性类型必填默认值
描述最低版本
其中 list 接受⼀个数组，只能配置最少 2 个、最多 5 个 tab。tab 按数组的顺序排序，每个项都是⼀个对象，其属性值如下：
属性类型必填说明
pagePath string 是页⾯路径，必须在 pages 中先定义
text
string
是
tab 上按钮⽂字
iconPath string 否
图⽚路径，icon ⼤⼩限制为 40kb，建议尺⼨为 81px * 81px，不⽀持⽹络图⽚。
当 position  为 top  时，不显⽰ icon。
selectedIconPath string 否
选中时的图⽚路径，icon ⼤⼩限制为 40kb，建议尺⼨为 81px * 81px，不⽀持⽹络图⽚。
当 position  为 top  时，不显⽰ icon。
networkTimeout
各类⽹络请求的超时时间，单位均为毫秒。
属性类型必填默认值说明
request number 否60000的超时时间，单位：毫秒。connectSocket number 否60000的超时时间，单位：毫秒。uploadFile
number
否
60000
的超时时间，单位：毫秒。

版权声明：本站内容均来自互联网，仅供演示用，请勿用于商业和其他非法用途。如果侵犯了您的权益请与我们联系QQ:729038198，我们将在24小时内删除。