注册小程序:
App():用来注册一个小程序。接受一个 Object 参数,其中指定小程序级别的生命周期函数和通用的数据、方法等。
App() 必须在 app.js 中调用,必须调用且只能调用一次。不然会出现无法预期的后果。
生命周期函数指的是在某一时刻会自动执行的函数。
Object 参数:
-
onLaunch(options)
:生命周期函数。小程序初始化完成时触发,全局只触发一次。options 中包含小程序当前所在页面的路径、进入小程序携带的参数、进入小程序的场景值等。例如:用户现在正在小程序中,此时有一个电话打进,用户退出了小程序,打了几分钟电话之后再次进入小程序。onLaunch() 不会再次触发,原因是即使当时退出了,小程序仍然运行在微信的内存之中,并不会马上释放其内存,打了几分钟的电话之后再次进入小程序,微信不会重新启动它,而是直接唤醒内存中的小程序,因此 onLaunch() 只会初始执行一次。
假如打了一个小时的电话之后再次进入小程序。onLaunch() 会再次触发,原因是微信检测到小程序迟迟没有再次使用,就会释放掉其内存,当再次进入的时候,onLaunch() 就会再执行一次。 -
onShow(options)
:生命周期函数。小程序启动或从后台进入前台展示时触发。获取到的参数与onLaunch()
获取到的参数一样。 -
onHide()
:生命周期函数。小程序从前台进入后台取消展示时触发。 -
onError(msg)
:小程序发生脚本错误或 API 调用报错时触发。 -
onPageNotFound()
:小程序要打开的页面不存在时触发。 -
onUnhandledRejection()
:小程序有未处理的 Promise 拒绝时触发。 -
onThemeChange()
:系统切换主题时触发。 -
其他:开发者可以添加任意的数据变量或函数到 Object 参数中,使用 this 就可以在
app.js
中访问。
// app.js
App({
// 小程序级别的生命周期函数
onLaunch(options) {
console.log(options)
},
// 全局通用的数据。不是响应式的,在 app.js 中通过 this 来获取和直接修改
globalData: {
name: 'Lee',
},
// 全局通用的方法
getUserName() {
console.log(this.globalData.username) // 'Lee'
},
setUserName() {
this.globalData.username = 'Mary'
},
})
获取小程序的 app 实例:
getApp()
:用来获取小程序全局唯一的 App 实例。
可以在小程序其他地方通过 getApp() 来获取 app 实例。
// index.js
// 在 index.js 页面通过 getApp() 获取到 app 实例,就可以使用 app.js 中定义的数据和方法了。
var appInstance = getApp()
console.log(appInstance.globalData.username) // 'Lee'