5.3 注册程序
App()
App() 是微信小程序注册程序函数。App() 接受一个object参数,其指定小程序的生命周期函数等。App() 方法有且仅有一个,存在于 App.js 中。 object参数说明,如表5-7所示:
表5-7
属性名 | 类型 | 说明 | 触发时机 |
---|---|---|---|
onLaunch | Function | 生命周期函数--监听小程序初始化 | 当小程序初始化完成时,会触发 onLaunch(全局只触发一次) |
onShow | Function | 生命周期函数--监听小程序显示 | 当小程序启动,或从后台进入前台显示,会触发 onShow |
onHide | Function | 生命周期函数--监听小程序隐藏 | 当小程序从前台进入后台,会触发 onHide |
onError | Function | 错误监听函数 | 当小程序发生脚本错误,或者 api 调用失败时,会触发 onError 并带上错误信息 |
其他 | Any | 开发者可以添加任意的函数或数据到 Object 参数中,用 this 可以访问式 |
前台、后台: 用户当前界面运行或正在操作小程序时称为前台。当用户点击左上角关闭,或者按了设备 Home 键离开微信,小程序并没有直接销毁,而是进入了后台;当再次进入微信或再次打开小程序,又会从后台进入前台。
销毁;只有当小程序进入后台一定时间,或者系统资源占用过高,才会被真正的销毁。此时小程序生命周期结束。
应用的生命周期过程如图5-6所示:
图5-6 应用生命周期
示例代码:
App({
onLaunch: function() {
// 启动时执行的初始化方法
},
onShow: function() {
// 小程序进入前台时执行的方法
},
onHide: function() {
// 小程序进入后台时执行的方法
},
onError: function(msg) {
console.log(msg)
},
globalData: 'I am global data'
})
getApp()
微信小程序提供了全局的 getApp() 函数。可以用来获取小程序实例。 示例代码:
// other.js
var appInstance = getApp()
console.log(appInstance.globalData) // I am global data
注意:
App() 必须在 app.js 中注册,且不能注册多个。
不要在定义于 App() 内的函数中调用 getApp() ,使用 this 就可以拿到 app 实例。
不要在 onLaunch 的时候调用 getCurrentPage(),此时 page 还没有生成。
通过 getApp() 获取实例之后,不要私自调用生命周期函数。