配置

全局配置

app.json

小程序根目录下的 app.json 文件用来对微信小程序进行全局配置，决定页面文件的路径、窗口表现、设置网络超时时间、设置多 tab 等。

entryPagePath

指定小程序的默认启动路径（首页），常见情景是从微信聊天列表页下拉启动、小程序列表启动等。如果不填，将默认为 pages 列表的第一项。不支持带页面路径参数。

{
  "entryPagePath": "pages/index/index"
}

pages

{
  "pages": ["pages/index/index", "pages/logs/logs"]
}

window

用于设置小程序的状态栏、导航条、标题、窗口背景色。

• navigationBarBackgroundColor 导航栏背景颜色

• navigationBarTextStyle 导航栏标题颜色 两个参数“black”和“white”

• navigationBarTitleText 导航栏标题文字内容

• navigationStyle 导航栏样式仅支持default和custom

• backgroundColor #ffffff

• backgroundTextStyle 下拉 loading 的样式，仅支持 dark / light

• backgroundColorTop 顶部窗口的背景色，仅 iOS 支持

• backgroundColorBottom 底部窗口的背景色，仅 iOS 支持

• onReachBottomDistance

• enablePullDownRefresh 页面刷新，true or false

• pageOrientation 页面旋转，拥有参数auto/portrait/landscape，其中auto是跟随系统旋转，landscape是固定横屏，portrait是固定竖屏，如果要支持ipad，则需要是使用如下的命令：

{
  "resizable": true
}

tap

如果小程序是一个多 tab 应用（客户端窗口的底部或顶部有 tab 栏可以切换页面），可以通过 tabBar 配置项指定 tab 栏的表现，以及 tab 切换时显示的对应页面。

其中 list 接受一个数组，只能配置最少 2 个、最多 5 个 tab。tab 按数组的顺序排序，每个项都是一个对象，其属性值如下：

networkTimeout

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

app.wxss

app.js

App(Object object)

注册小程序。接受一个 Object 参数，其指定小程序的生命周期回调等。

App() 必须在 app.js 中调用，必须调用且只能调用一次。不然会出现无法预期的后果。

参数

Object object

属性	类型	默认值	必填	说明	最低版本
onLaunch	function		否	生命周期回调——监听小程序初始化。
onShow	function		否	生命周期回调——监听小程序启动或切前台。
onHide	function		否	生命周期回调——监听小程序切后台。
onError	function		否	错误监听函数。
onPageNotFound	function		否	页面不存在监听函数。	1.9.90
onUnhandledRejection	function		否	未处理的 Promise 拒绝事件监听函数。	2.10.0
onThemeChange	function		否	监听系统主题变化	2.11.0
其他	any		否	开发者可以添加任意的函数或数据变量到 Object 参数中，用 this 可以访问

Sitemap.json

小程序根目录下的 sitemap.json 文件用来配置小程序及其页面是否允许被微信索引。

{
  "rules":[{
    "action": "allow",
    "page": "*"
  }]
}