App

    注：App 函数必须在 app.js 中被调用一次。该函数在整个小程序中不能被调用多次，否则会出现无法预期的后果。

    Web 态说明：

    由于 Web 态框架暂不支持当前是否进入前、后台的状态检测，因此在下列场景中，App.onShow、App.onHide 生命周期无法触发

    • 当 Web 态小程序从后台切换至前台时，如从任务管理器进入、或关闭显示在上层的语音助手等，App.onShow 生命周期无法触发
    • 由于 Web 态框架暂不支持当前是否进入前、后台的状态检测，因此 Web 态小程序暂不支持 App.onHide 生命周期

    参数

    Object object：

    注意:
    只有在以下情况小程序才可能会被动销毁，参考运行机制:

    • 系统资源占用过高；
    • 打开小程序数量超过系统支持上限(系统按照小程序被打开的先后顺序进行销毁)。

    代码示例

    • JS
    • 使用 onLogin 生命周期的意义：Web 态小程序初次登录成功后开发者能获取登录成功的 code。
    • 添加 onLogin 生命周期的原因：与百度 App 端内小程序登录不同（在小程序内部登录），Web 态的登录需要跳转百度登录页面进行登录，登录成功后自动跳转原页面。该跳转过程会导致 Web 态小程序的原执行上下文状态丢失，从而无法通过 swan.login 的成功回调获取登录成功的 code。因此必须通过 onLogin 生命周期获取该 code。

    onLaunch(Object object)

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

    名词解释:

    • 场景值： 智能小程序被打开时，其来源渠道的标识（例如： 从百度搜索结果打开、从百度信息流打开），开发者可以利用该字段统计小程序在什么场景下被打开，更多场景值；
    • 调起协议： 宿主（例如百度 App）用于识别一个小程序被打开时的初始化信息（例如：小程序的 appKey、path、query 等），由该类信息构成的一个协议。

    小程序启动，或从后台进入前台显示时触发。也可以使用 绑定监听。

    onHide()

    小程序从前台进入后台时触发。也可以使用 绑定监听。

    小程序发生脚本错误或 API 调用报错时触发。也可以使用 swan.onError 绑定监听。

    参数：与 一致

    onPageNotFound(Object object)

    小程序要打开的页面不存在时触发。也可以使用 绑定监听。注意事项请参考 swan.onPageNotFound。

    参数：与 一致

    • JS
    1. App({
    2.     onPageNotFound(res) {
    4.         swan.redirectTo({
    5.             url: 'path/to/otherPage'
    7.     }
    8. });