配置
小程序根目录下的
app.json
文件用来对微信小程序进行全局配置,决定页面文件的路径、窗口表现、设置网络超时时间、设置多 tab 等。指定小程序的默认启动路径(首页),常见情景是从微信聊天列表页下拉启动、小程序列表启动等。如果不填 ,将默认为
pages
列表的第一项。不支持带页面路径参数。{
"entryPagePath": "pages/index/index"
}
pages
{
"pages": ["pages/index/index", "pages/logs/logs"]
}
用于设置小程序的状态栏、导航条、标题、窗口背景色。

- 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 按数组的顺序排序,每个项都是一个对象,其属性值如下:

各类网络请求的超时时间,单位均为毫秒。
注册小程序。接受一个
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
文件用来配置小程序及其页面是否允许被微信索引。{
"rules":[{
"action": "allow",
"page": "*"
}]
}
Last modified 3yr ago