app

app()

app()函数用来注册一个小程序。接受一个object参数，其指定小程序的生命周期函数等。

object参数说明：

前台、后台定义：当用户点击左上角关闭，或者按了设备 home 键离开微信，小程序并没有直接销毁，而是进入了后台；当再次进入微信或再次打开小程序，又会从后台进入前台。需要注意的是：只有当小程序进入后台一定时间，或者系统资源占用过高，才会被真正的销毁。

关闭小程序(基础库版本1.1.0开始支持)：当用户从扫一扫、转发等入口(场景值为1007, 1008, 1011, 1025)进入小程序，且没有置顶小程序的情况下退出，小程序会被销毁。小程序运行机制在基础库版本 1.4.0 有所改变：上一条关闭逻辑在新版本已不适用， 详情

示例代码：

app({
  onlaunch: function(options) { 
    // do something initial when launch.
  },
  onshow: function(options) {
      // do something when show.
  },
  onhide: function() {
      // do something when hide.
  },
  onerror: function(msg) {
    console.log(msg)
  },
  globaldata: 'i am global data'
})

onlaunch, onshow 参数

场景值 详见。

以下场景支持返回 referrerinfo.appid：

onpagenotfound

基础库 1.9.90 开始支持，低版本需做兼容处理

当要打开的页面并不存在时，会回调这个监听器，并带上以下信息：

开发者可以在 onpagenotfound 回调中进行重定向处理，但必须在回调中同步处理，异步处理（例如 settimeout 异步执行）无效。

示例代码：

app({
  onpagenotfound(res) {
    wx.redirectto({
      url: 'pages/...'
    })
  }
})

注意：

1. 微信开发者工具暂不支持 onpagenotfound 调试，请使用真机调试
2. 如果开发者没有添加 onpagenotfound 监听，当跳转页面不存在时，将推入微信客户端原生的页面不存在提示页面
3. 如果 onpagenotfound 回调中又重定向到另一个不存在的页面，将推入微信客户端原生的页面不存在提示页面，并且不在回调 onpagenotfound

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()获取实例之后，不要私自调用生命周期函数。