微信小程序 注冊程序 App()函數(shù)

App

App()

App()函數(shù)用來注冊一個(gè)小程序。接受一個(gè)object參數(shù)，其指定小程序的生命周期函數(shù)等。

object參數(shù)說明：

前臺、后臺定義：當(dāng)用戶點(diǎn)擊左上角關(guān)閉，或者按了設(shè)備 Home 鍵離開微信，小程序并沒有直接銷毀，而是進(jìn)入了后臺；當(dāng)再次進(jìn)入微信或再次打開小程序，又會從后臺進(jìn)入前臺。需要注意的是：只有當(dāng)小程序進(jìn)入后臺一定時(shí)間，或者系統(tǒng)資源占用過高，才會被真正的銷毀。

關(guān)閉小程序(基礎(chǔ)庫版本1.1.0開始支持)：當(dāng)用戶從掃一掃、轉(zhuǎn)發(fā)等入口(場景值為1007, 1008, 1011, 1025)進(jìn)入小程序，且沒有置頂小程序的情況下退出，小程序會被銷毀。小程序運(yùn)行機(jī)制在基礎(chǔ)庫版本 1.4.0 有所改變：上一條關(guān)閉邏輯在新版本已不適用， 詳情

示例代碼：

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 參數(shù)

場景值 詳見。

以下場景支持返回 referrerInfo.appId：

onPageNotFound

基礎(chǔ)庫 1.9.90 開始支持，低版本需做兼容處理

當(dāng)要打開的頁面并不存在時(shí)，會回調(diào)這個(gè)監(jiān)聽器，并帶上以下信息：

開發(fā)者可以在 onPageNotFound 回調(diào)中進(jìn)行重定向處理，但必須在回調(diào)中同步處理，異步處理（例如 setTimeout 異步執(zhí)行）無效。

示例代碼：

App({
  onPageNotFound(res) {
    wx.redirectTo({
      url: 'pages/...'
    })
  }
})

注意：

1. 微信開發(fā)者工具暫不支持 onPageNotFound 調(diào)試，請使用真機(jī)調(diào)試
2. 如果開發(fā)者沒有添加 onPageNotFound 監(jiān)聽，當(dāng)跳轉(zhuǎn)頁面不存在時(shí)，將推入微信客戶端原生的頁面不存在提示頁面
3. 如果 onPageNotFound 回調(diào)中又重定向到另一個(gè)不存在的頁面，將推入微信客戶端原生的頁面不存在提示頁面，并且不在回調(diào) onPageNotFound

getApp()

我們提供了全局的getApp()函數(shù)，可以獲取到小程序?qū)嵗?/p>

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

注意：

App()必須在app.js中注冊，且不能注冊多個(gè)。

不要在定義于App()內(nèi)的函數(shù)中調(diào)用getApp()，使用this就可以拿到app實(shí)例。

不要在onLaunch的時(shí)候調(diào)用getCurrentPage()，此時(shí)page還沒有生成。

通過getApp()獲取實(shí)例之后，不要私自調(diào)用生命周期函數(shù)。