# app.js 在根目錄下的 `app.js` 是小程序的入口文件，其 `App()` 方法用于注冊一個小程序。 ## App() `App()` 函數用來注冊一個小程序。接受一個 object 參數，其指定小程序的生命周期函數等。 **object參數說明：** | 屬性 | 類型 | 描述 | 觸發時機 | | -------- | -------- | ---------------- | ---------------------------------------- | | onLaunch | Function | 生命周期函數--監聽小程序初始化 | 當小程序初始化完成時，會觸發 onLaunch（全局只觸發一次） | | onShow | Function | 生命周期函數--監聽小程序顯示 | 當小程序啟動，或從后臺進入前臺顯示，會觸發 onShow | | onHide | Function | 生命周期函數--監聽小程序隱藏 | 當小程序從前臺進入后臺，會觸發 onHide | | onError | Function | 錯誤監聽函數 | 當小程序發生腳本錯誤，或者 api 調用失敗時，會觸發 onError 并帶上錯誤信息 | | 其他 | Any | | 開發者可以添加任意的函數或數據到 Object 參數中，用 `this` 可以訪問，比如下文中的 globalData | **前臺、后臺定義：** 當用戶點擊左上角關閉，或者按了設備 Home 鍵離開微信，小程序并沒有直接銷毀，而是進入了后臺；當再次進入微信或再次打開小程序，又會從后臺進入前臺。需要注意的是：只有當小程序進入后臺一定時間，或者系統資源占用過高，才會被真正的銷毀。 關閉小程序（基礎庫版本1.1.0開始支持）： 當用戶從掃一掃、轉發等入口([場景值](https://mp.weixin.qq.com/debug/wxadoc/dev/framework/app-service/scene.html)為1007, 1008, 1011, 1025)進入小程序，且沒有置頂小程序的情況下退出，小程序會被銷毀。 **小程序運行機制在基礎庫版本 1.4.0 有所改變：** 上一條關閉邏輯在新版本已不適用。[詳情](https://mp.weixin.qq.com/debug/wxadoc/dev/framework/operating-mechanism.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 參數 | 字段 | 類型 | 說明 | | ---------------------- | ------ | ---------------------------------------- | | path | String | 打開小程序的路徑 | | query | Object | 打開小程序的query | | scene | Number | 打開小程序的場景值 | | shareTicket | String | shareTicket，詳見 [獲取更多轉發信息](https://mp.weixin.qq.com/debug/wxadoc/dev/api/share.html#%E8%8E%B7%E5%8F%96%E6%9B%B4%E5%A4%9A%E8%BD%AC%E5%8F%91%E4%BF%A1%E6%81%AF) | | referrerInfo | Object | 當場景為由從另一個小程序或公眾號或App打開時，返回此字段 | | referrerInfo.appId | String | 來源小程序或公眾號或App的 appId，詳見下方說明 | | referrerInfo.extraData | Object | 來源小程序傳過來的數據，scene=1037或1038時支持 | 場景值 [詳見](https://mp.weixin.qq.com/debug/wxadoc/dev/framework/app-service/scene.html)。 以下場景支持返回 referrerInfo.appId： | 場景值 | 場景 | appId 信息含義 | | ---- | -------------------- | ------------- | | 1020 | 公眾號 profile 頁相關小程序列表 | 返回來源公眾號 appId | | 1035 | 公眾號自定義菜單 | 返回來源公眾號 appId | | 1036 | App 分享消息卡片 | 返回來源應用 appId | | 1037 | 小程序打開小程序 | 返回來源小程序 appId | | 1038 | 從另一個小程序返回 | 返回來源小程序 appId | | 1043 | 公眾號模板消息 | 返回來源公眾號 appId | 示例 ```js App({ onLaunch (path) { console.log(path) } }) ``` :-:  ## getApp() 全局的 `getApp()` 函數可以用來獲取到小程序實例。 ``` // other.js var appInstance = getApp() console.log(appInstance.globalData) // I am global data ``` **注意：** - `App()` 必須在 `app.js` 中注冊，且不能注冊多個。 - 不要在定義于 `App()` 內的函數中調用 `getApp()` ，使用 `this` 就可以拿到 app 實例。 - 不要在 onLaunch 的時候調用 `getCurrentPages()`，此時 page 還沒有生成。 - 通過 `getApp()` 獲取實例之后，不要私自調用生命周期函數。