小程序 App

注册小程序

每个小程序都需要在 app.js 中调用 App() 方法注册小程序实例，绑定生命周期回调函数、错误监听和页面不存在监听函数等。

示例代码

// app.js
App({
  onLaunch (options) {
    // Do something initial when launch.
    console.log("onLaunch 参数", options)
  },
  onShow (options) {
    // Do something when show.
    console.log("onShow 参数", options)
  },
  onHide (options) {
    // Do something when hide.
    console.log("onHide 参数", options)
  },
  onBeforeDestroy () {
    // Do something before destroy.
  },
  data: () => ({
      globalData: 'I am global data'
  })
})

App(Object)

App() 函数用来注册一个小程序。接受一个 Object 作为参数，用以指定小程序的生命周期函数等。

注意: App() 函数必须在 app.js 中被调用一次。该函数在整个小程序中不能被调用多次，否则会出现无法预期的后果。

参数

Object object

属性	类型	说明	触发时机
`onLoad`	function	生命周期函数 – 监听小程序的加载	小程序初始化完成时触发（全局只触发一次）
`onShow`	function	生命周期函数 – 监听小程序的显示	小程序从后台进入前台显示时触发
`onHide`	function	生命周期函数 – 监听小程序的隐藏	小程序从前台进入后台时触发
`onBeforeDestroy`	function	生命周期函数 – 监听小程序的销毁	小程序销毁前触发

详细参数见小程序生命周期函数。

getApp()

整个小程序只有一个 App 实例，是全部页面共享的。开发者可以通过 getApp() 方法获取到全局唯一的 App 实例，获取App上的数据或调用开发者注册在 App 上的函数。

示例代码

// xxx.js(小程序页面)
const appInstance = getApp()
console.log(appInstance.data().globalData)
appInstance.setData({globalData: 123})
console.log(appInstance.data().globalData)

1. 小程序 App