注册小程序 App(Object object)

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

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

参数

Object object

属性	类型	默认值	必填	说明	最低版本
onLaunch	function		否	生命周期回调——监听小程序初始化。	1.0.0
onShow	function		否	生命周期回调——监听小程序启动或切前台。	1.0.0
onHide	function		否	生命周期回调——监听小程序切后台。	1.0.0
onError	function		否	错误监听函数。	3.7.5
onPageNotFound	function		否	错误监听函数。	4.0.0
其他	any		否	开发者可以添加任意的函数或数据变量到 Object 参数中，用 this 可以访问	1.0.0

onLaunch()

小程序初始化完成时触发，全局只触发一次。获取启动参数请使用 dlt.getLaunchOptions 获取。

onShow(Object object)

小程序启动或从后台切换到前台运行

onHide()

小程序切换到后台运行时触发

onPageNotFound(Object object)

小程序要打开的页面不存在事件

onError(String error)

监听小程序错误事件。如脚本错误或 API 调用报错等

示例代码

// app.js
App({
  onLaunch() {
    // Do something initial when launch.
  },
  onShow() {
    // Do something when show.
  },
  onHide() {
    // Do something when hide.
  },
  globalData: 'I am global data',
});

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

// xxx.js
const appInstance = getApp();
console.log(appInstance.globalData); // I am global data