微信小程序开发手册: 逻辑层注册程序 App()函数

2018-02-0402:04:30APP与小程序开发Comments2,425 views字数 1335阅读模式

App()


App()函数用来注册一个小程序。接受一个object参数,其指定小程序的生命周期函数等。文章源自菜鸟学院-https://www.cainiaoxueyuan.com/xcx/774.html

object参数说明:文章源自菜鸟学院-https://www.cainiaoxueyuan.com/xcx/774.html

属性类型描述触发时机
onLaunchFunction生命周期函数--监听小程序初始化当小程序初始化完成时,会触发 onLaunch(全局只触发一次)
onShowFunction生命周期函数--监听小程序显示当小程序启动,或从后台进入前台显示,会触发 onShow
onHideFunction生命周期函数--监听小程序隐藏当小程序从前台进入后台,会触发 onHide
onErrorFunction错误监听函数当小程序发生脚本错误,或者 api 调用失败时,会触发 onError 并带上错误信息
其他Any开发者可以添加任意的函数或数据到 Object 参数中,用 this 可以访问

前台、后台定义:当用户点击左上角关闭,或者按了设备 Home 键离开微信,小程序并没有直接销毁,而是进入了后台;当再次进入微信或再次打开小程序,又会从后台进入前台。需要注意的是:只有当小程序进入后台一定时间,或者系统资源占用过高,才会被真正的销毁。文章源自菜鸟学院-https://www.cainiaoxueyuan.com/xcx/774.html

关闭小程序(基础库版本1.1.0开始支持):当用户从扫一扫、转发等入口(场景值为1007, 1008, 1011, 1025)进入小程序,且没有置顶小程序的情况下退出,小程序会被销毁。小程序运行机制在基础库版本 1.4.0 有所改变:上一条关闭逻辑在新版本已不适用,详情文章源自菜鸟学院-https://www.cainiaoxueyuan.com/xcx/774.html

示例代码:文章源自菜鸟学院-https://www.cainiaoxueyuan.com/xcx/774.html

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 参数

字段类型说明
pathString打开小程序的路径
queryObject打开小程序的query
sceneNumber打开小程序的场景值
shareTicketStringshareTicket,详见 获取更多转发信息
referrerInfoObject当场景为由另一个小程序打开时,返回此字段
referrerInfo.appIdString来源小程序的 appId
referrerInfo.extraDataObject来源小程序传过来的数据

场景值 详见文章源自菜鸟学院-https://www.cainiaoxueyuan.com/xcx/774.html

getApp()


我们提供了全局的getApp()函数,可以获取到小程序实例。文章源自菜鸟学院-https://www.cainiaoxueyuan.com/xcx/774.html

// other.js
var appInstance = getApp()
console.log(appInstance.globalData) // I am global data

注意:文章源自菜鸟学院-https://www.cainiaoxueyuan.com/xcx/774.html

App()必须在app.js中注册,且不能注册多个。文章源自菜鸟学院-https://www.cainiaoxueyuan.com/xcx/774.html

不要在定义于App()内的函数中调用getApp(),使用this就可以拿到app实例。文章源自菜鸟学院-https://www.cainiaoxueyuan.com/xcx/774.html

不要在onLaunch的时候调用getCurrentPage(),此时page还没有生成。文章源自菜鸟学院-https://www.cainiaoxueyuan.com/xcx/774.html

通过getApp()获取实例之后,不要私自调用生命周期函数。文章源自菜鸟学院-https://www.cainiaoxueyuan.com/xcx/774.html

  • 本站内容整理自互联网,仅提供信息存储空间服务,以方便学习之用。如对文章、图片、字体等版权有疑问,请在下方留言,管理员看到后,将第一时间进行处理。
  • 转载请务必保留本文链接:https://www.cainiaoxueyuan.com/xcx/774.html

Comment

匿名网友 填写信息

:?: :razz: :sad: :evil: :!: :smile: :oops: :grin: :eek: :shock: :???: :cool: :lol: :mad: :twisted: :roll: :wink: :idea: :arrow: :neutral: :cry: :mrgreen:

确定