App()
App() 函数用来注册一个小程序。接受一个 object 参数(本质就是function 和 data)
,其指定小程序的生命周期函数等。
object参数说明:
属性 | 类型 | 描述 | 触发时机 |
---|---|---|---|
onLaunch | Function | 生命周期函数–监听小程序初始化 | 当小程序初始化完成时,会触发 onLaunch(全局只触发一次) |
onShow | Function | 生命周期函数–监听小程序显示 | 当小程序启动,或从后台进入前台显示,会触发 onShow |
onHide | Function | 生命周期函数–监听小程序隐藏 | 当小程序启动,或从后台进入前台显示,会触发 onShow |
onError | Function | 错误监听函数 | 当小程序发生脚本错误,或者 api 调用失败时,会触发 onError 并带上错误信息 |
其他 | Any | 开发者可以添加任意的函数或数据到 Object 参数中,内部 用 this 可以访问 ,外部用 getApp() 访问 |
前台、后台定义:
当用户点击左上角关闭,或者按了设备 Home 键离开微信,小程序并 没有直接销毁,而是进入了后台;
当再次进入微信或再次打开小程序,又会从 后台进入前台。
需要注意的是:只有当小程序进入后台一定时间,或者系统资源占用过高,才会被真正的销毁。
关闭小程序(基础库版本1.1.0开始支持):
当用户从 扫一扫
、 转发
等入口(场景值为 1007, 1008, 1011, 1025
)进入小程序,且没有置顶小程序的情况下退出,小程序会被销毁。
一、获取app()
内容的方法
getApp()
此函数 为全局函数
可以用来获取到小程序 实例。
代码(其他子文件中的js
代码)
// other.js
var appInstance = getApp()
console.log(appInstance.globalData) // 控制台输出 :I am global data
注意:
- App() 必须在
app.js
中注册,且不能注册多个。 - 不要在定义于 App() 内的函数中调用
getApp()
,使用this
就可以拿到 app 实例。 - 不要在
onLaunch
的时候调用getCurrentPages()
,此时page
还没有生成。 - 通过 getApp() 获取实例之后,不要私自调用生命周期函数。
二、app.js文件是项目的入口文件:
//app.js
App({
onLaunch: function () {
// 展示本地存储能力
var logs = wx.getStorageSync('logs') || []
logs.unshift(Date.now())
wx.setStorageSync('logs', logs)
// 登录
wx.login({
success: res => {
// 发送 res.code 到后台换取 openId, sessionKey, unionId
}
})
// 获取用户信息
wx.getSetting({
success: res => {
if (res.authSetting['scope.userInfo']) {
// 已经授权,可以直接调用 getUserInfo 获取头像昵称,不会弹框
wx.getUserInfo({
success: res => {
// 可以将 res 发送给后台解码出 unionId
this.globalData.userInfo = res.userInfo
// 由于 getUserInfo 是网络请求,可能会在 Page.onLoad 之后才返回
// 所以此处加入 callback 以防止这种情况
if (this.userInfoReadyCallback) {
this.userInfoReadyCallback(res)
}
}
})
}
}
})
},
globalData: {
userInfo: null
}
})
页面的 page.js 文件会覆盖 app.js文件
App.js文件里面的一些方法:
onLaunch : function(){}:
onLoad:function(options){}:页面初始化 options 为页面跳转所传递过来的参数
onReady:function(){}:页面渲染完成
onShow:function(){}:页面显示
onHide:function(){}:页面隐藏
onUnload:function(){}:页面关闭
还可以在 app.js里面定义一些全局的方法:
例如:获取用户信息的方法(wx.getSetting)和属性(globalData):
在 page 页面如何获取 app.js 定义的属性:
首先在 page.js 文件里面:const app = getApp(); 在对应方法里面直接console.log( app.globalData.userInfo );
实例:获取当前微信用户信息
这个可以用在登陆页:判断是否存在登陆。登陆过就改变 app.js 里面的配置。
使用:
例如这个用户是否登陆了,如果全局里面没有用户的信息,需要跳转到登陆的页面进行登陆,如果说有了用户的信息就不用跳转到登陆页面,当登陆完成之后,我们就可以设置全局的数据,然后返回到跳转的页面,直接读取用户的信息就可以。