微信小程序之全局配置-1

小程序的配置分为全局配置、页面配置及sitemap 配置

全局配置

小程序根目录下的 app.json 文件用来对微信小程序进行全局配置。文件内容为一个 JSON 对象，有以下属性：

属性	类型	必填	描述	最低版本
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[]	否	需要在后台使用的能力，如「音乐播放」
plugins	Object	否	使用到的插件	1.9.6
preloadRule	Object	否	分包预下载规则	2.3.0
resizable	boolean	否	iPad 小程序是否支持屏幕旋转，默认关闭	2.3.0
navigateToMiniProgramAppIdList	string[]	否	需要跳转的小程序列表，详见 wx.navigateToMiniProgram	2.4.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

1.1 pages

⽤于指定⼩程序由哪些⻚⾯组成，每⼀项都对应⼀个⻚⾯的路径（含⽂件名）信
息。⽂件名不需要写⽂件后缀，框架会⾃动去寻找对于位置的 .json, .js, .wxml,
.wxss 四个⽂件进⾏处理

有多少个⻚⾯，此处就应该有多少个选项
数组的第⼀项代表⼩程序的初始⻚⾯（⾸⻚）。⼩程序中新增/减少⻚⾯，都需
要对 pages 数组进⾏修改。

1.2 window

⽤于设置⼩程序的状态栏、导航条、标题、窗⼝背景⾊。

属性	类型	默认值	描述	最低版本
navigationBarBackgroundColor	HexColor	#000000	导航栏背景颜色，如 `#000000`
navigationBarTextStyle	string	white	导航栏标题颜色，仅支持 `black` / `white`
navigationBarTitleText	string		导航栏标题文字内容
navigationStyle	string	default	导航栏样式，仅支持以下值： `default` 默认样式 `custom` 自定义导航栏，只保留右上角胶囊按钮。参见注 2。	微信客户端 6.6.0
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	是否开启全局的下拉刷新。详见 Page.onPullDownRefresh
onReachBottomDistance	number	50	页面上拉触底事件触发时距页面底部距离，单位为 px。详见 Page.onReachBottom
pageOrientation	string	portrait	屏幕旋转设置，支持 `auto` / `portrait` / `landscape` 详见响应显示区域变化	2.4.0 (auto) / 2.5.0 (landscape)

1.3 tabBar

如果⼩程序是⼀个多 tab 应⽤（客户端窗⼝的底部或顶部有 tab 栏可以切换⻚
⾯），可以通过 tabBar 配置项指定 tab 栏的表现，以及 tab 切换时显示的对应⻚
⾯。

属性	类型	必填	默认值	描述	最低版本
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，见详情	2.5.0

其中 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。

1.4 networkTimeout

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

属性	类型	必填	默认值	说明
request	number	否	60000	wx.request 的超时时间，单位：毫秒。
connectSocket	number	否	60000	wx.connectSocket 的超时时间，单位：毫秒。
uploadFile	number	否	60000	wx.uploadFile 的超时时间，单位：毫秒。
downloadFile	number	否	60000	wx.downloadFile 的超时时间，单位：毫秒。

1.5 debug

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

1.6 functionalPages

插件所有者⼩程序需要设置这⼀项来启⽤插件功能⻚

1.7 permission

⼩程序接⼝权限相关设置。字段类型为 Object，结构为：

属性	类型	必填	默认值	描述
scope.userLocation	PermissionObject	否		位置相关权限声明

PermissionObject 结构为

属性	类型	必填	默认值	说明
desc	string	是		小程序获取权限时展示的接口用途说明。最长 30 个字符

因为疫情原因，不管是工作还是学习都受到了严重影响。在疫情期间，在家也不能放松，这个微信小程序全局配置，希望能对大家有所帮助

逆战之微信小程序全局配置相关推荐

php小程序开发实例,微信小程序全局配置开发实例
本文主要和大家分享微信小程序全局配置开发实例,主要以代码的形式和大家分享,希望能帮助到大家. 一.app.json 使用app.json文件来对微信小程序进行全局配置,决定页面文件的路径.窗口表现.设 ...
uni-app 微信小程序全局配置分享好友、朋友圈...
使用uni-app在实际项目中开发微信小程序,经常会遇到给项目添加分享给微信好友.朋友圈...功能,一般来说要将某个页面分享出去,就要在当前页面添加: <template> <vie ...
微信小程序全局配置参数详解app.json
全局配置 cc文件内容为一个 JSON 对象,有以下属性: 配置项 entryPagePath 指定小程序的默认启动路径(首页),常见情景是从微信聊天列表页下拉启动.小程序列表启动等.如果不填,将默认 ...
微信小程序全局配置分享指定标题、图片、路径
在app.js页面中的onLaunch里添加以下代码 //重写分享方法wx.onAppRoute(function (res) {//获取加载的页面let pages = getCurrentPage ...
微信小程序 php配置,微信小程序的配置
我们使用app.json文件来对微信小程序进行全局配置,决定页面文件的路径.窗口表现.设置网络超时时间.设置多 tab 等. 以下是一个包含了所有配置选项的简单配置app.json{ "pa ...
微信小程序—相关配置
目录微信小程序介绍什么是小程序? 小程序可以干什么? 相关资料第一个小程序申请帐号测试号申请安装开发工具你的第一个小程序编译预览目录结构 JSON 配置小程序配置 app.json ...
微信小程序-页面配置-界面显示部分
微信小程序-页面配置-界面显示部分配置项 singlePage 小结: 每一个小程序页面也可以使用 .json 文件来对本页面的窗口表现进行配置. 页面中配置项在当前页面会覆盖 app.json 的 ...
微信小程序之配置app.json
微信小程序之配置app.json 本人写了一个在线扫码借书的小程序,打算分享一下心得和代码,欢迎关注,再次希望各位大佬指出不足 {"pages": ["pages/ind ...
微信小程序----全局状态管理 (便于全局埋点等操作)
说明由于我是一个有着一颗玻璃心的博主,导致在2018年后博客很少更新.原因是由于我的分享并没有解决到部分人的问题,而导致被骂了.当时这颗玻璃心就碎了,所以这两年以来很是消极,博客很少更新.这里给那些 ...

逆战之微信小程序全局配置