app.js注册小程序

App()接受一个Object作为参数，用来配置小程序的生命周期回调等。

注意

App()必须在app.js里调用，且不能调用多次。

Object属性说明

属性	类型	说明
onLaunch	Function	监听小程序初始化。

当小程序初始化完成时触发，全局只触发一次。|
|onShow|Function|监听小程序显示。

当小程序启动，或从后台进入前台显示时触发。|
|onHide|Function|监听小程序隐藏。

当小程序从前台进入后台时触发。|
|onError|Function|监听小程序错误。

当小程序发生 js 错误时触发。|
|其他|Any|开发者可以添加任意数据或者函数到object对象中，可以通过getApp()方法获取。|

说明

用户点击左上角关闭，或者按了设备 Home 键离开钉钉时，小程序并不会直接销毁，而是进入了后台，当再次进入钉钉或再次打开小程序时，又会从后台进入前台。

只有当小程序进入后台一定时间，或占用系统资源过高，才会被真正销毁。

代码示例

App({
  onLaunch (options) {
    // 第一次打开时调用
    const { query, path } = options;
    const { corpId } = query;
  },
  onShow (options) {
    // 从后台被scheme重新打开时调用
    const { query, path } = options;
    const { corpId } = query;
  },
  onHide () {
    // 进入后台时调用
    console.log('App hide');
  },
  onError (error) {
    // 小程序执行出错时调用
    console.log(error);
  },
  globalData: {
    foo: 'bar'
  }
});

onLaunch(options: Object)

小程序初始化完成时触发，全局只触发一次。

options属性说明：

属性	类型	示例	描述
query	Object	`{corpId: 'xxxxxx'}`	启动小程序时scheme中的query参数。

说明

说明

小程序启动scheme中path忽略时，默认为首页。|

onShow(options: Object)

小程序启动或者在后台时重新用scheme被打开显示时触发。参数与onLaunch一致。

onHide()

当小程序从前台进入后台时触发。

onError

当小程序发生js错误时触发。

Object属性说明#

代码示例#

onLaunch(options: Object)#

onShow(options: Object)#

onHide()#

onError#