App
App()
App() 函數(shù)用來注冊一個小程序。接受一個 object 參數(shù)，其指定小程序的生命周期函數(shù)等。
object參數(shù)說明：
| 屬性 | 類型 | 描述 | 觸發(fā)時機 |
|---|
| onLaunch | Function | 生命周期函數(shù)--監(jiān)聽小程序初始化 | 當(dāng)小程序初始化完成時，會觸發(fā) onLaunch（全局只觸發(fā)一次） |
| onShow | Function | 生命周期函數(shù)--監(jiān)聽小程序顯示 | 當(dāng)小程序啟動，或從后臺進入前臺顯示，會觸發(fā) onShow |
| onHide | Function | 生命周期函數(shù)--監(jiān)聽小程序隱藏 | 當(dāng)小程序從前臺進入后臺，會觸發(fā) onHide |
| onError | Function | 錯誤監(jiān)聽函數(shù) | 當(dāng)小程序發(fā)生腳本錯誤，或者 api 調(diào)用失敗時，會觸發(fā) onError 并帶上錯誤信息 |
| 其他 | Any |
| 開發(fā)者可以添加任意的函數(shù)或數(shù)據(jù)到 Object 參數(shù)中，用 this 可以訪問 |
前臺、后臺定義： 當(dāng)用戶點擊左上角關(guān)閉，或者按了設(shè)備 Home 鍵離開微信，小程序并沒有直接銷毀，而是進入了后臺；當(dāng)再次進入微信或再次打開小程序，又會從后臺進入前臺。需要注意的是：只有當(dāng)小程序進入后臺一定時間，或者系統(tǒng)資源占用過高，才會被真正的銷毀。
關(guān)閉小程序（基礎(chǔ)庫版本1.1.0開始支持）： 當(dāng)用戶從掃一掃、轉(zhuǎn)發(fā)等入口(場景值為1007, 1008, 1011, 1025)進入小程序，且沒有置頂小程序的情況下退出，小程序會被銷毀。
小程序運行機制在基礎(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ù)
| 字段 | 類型 | 說明 |
|---|
| path | String | 打開小程序的路徑 |
| query | Object | 打開小程序的query |
| scene | Number | 打開小程序的場景值 |
| shareTicket | String | shareTicket， |
| referrerInfo | Object | 當(dāng)場景為由從另一個小程序或公眾號或App打開時，返回此字段 |
| referrerInfo.appId | String | 來源小程序或公眾號或App的 appId，詳見下方說明 |
| referrerInfo.extraData | Object | 來源小程序傳過來的數(shù)據(jù)，scene=1037或1038時支持 |
場景值 詳見。
以下場景支持返回 referrerInfo.appId：
| 場景值 | 場景 | appId 信息含義 |
|---|
| 1020 | 公眾號 profile 頁相關(guān)小程序列表 | 返回來源公眾號 appId |
| 1035 | 公眾號自定義菜單 | 返回來源公眾號 appId |
| 1036 | App 分享消息卡片 | 返回來源應(yīng)用 appId |
| 1037 | 小程序打開小程序 | 返回來源小程序 appId |
| 1038 | 從另一個小程序返回 | 返回來源小程序 appId |
| 1043 | 公眾號模板消息 | 返回來源公眾號 appId |
getApp()
全局的 getApp() 函數(shù)可以用來獲取到小程序?qū)嵗?/p>
// other.jsvar appInstance = getApp()console.log(appInstance.globalData) // I am global data
注意：
App() 必須在 app.js 中注冊，且不能注冊多個。
不要在定義于 App() 內(nèi)的函數(shù)中調(diào)用 getApp() ，使用 this 就可以拿到 app 實例。
不要在 onLaunch 的時候調(diào)用 getCurrentPages()，此時 page 還沒有生成。
通過 getApp() 獲取實例之后，不要私自調(diào)用生命周期函數(shù)。