小程序 App() 和 Page() 函數(shù)調用時的初始化流程

2018-06-27|HiShop

導讀：內部實現(xiàn) 在__appServiceEngine__對象中，對App和getApp屬性的定義如下： // 其中的 t 就是 __appServiceEngine__ 對象var i = n(17);Object.defineProperty(t, App, { enumerable: !0, g...

內部實現(xiàn)

在 __appServiceEngine__ 對象中，對 App 和 getApp 屬性的定義如下：

// 其中的 t 就是 __appServiceEngine__ 對象
var i = n(17);
Object.defineProperty(t, "App", {
  enumerable: !0,
  get: function() {
      return i.appHolder
  }
}),
Object.defineProperty(t, "getApp", {
  enumerable: !0,
  get: function() {
      return i.getApp
  }
}),

而這兩個屬性對應的實現(xiàn)分別為 appHolder() 和 getApp() 方法，定義如下：

l = void 0,

t.appHolder = (0, i.surroundByTryCatch)(function(e) {
   l = new y(e)
}, "create app instance"),

t.getApp = function() {
   return l
},

由上可知，在 appHolder() 方法中，把外部傳入的 object 對象傳給 y(...) 方法進行初始化一個小程序實例對象，并把結果賦給變量 l 緩存起來，而在 getApp() 方法中則直接 return l，返回當前小程序對象。

App 實例初始化流程

在上述 page-frame.html 中，我們知道，在 app.js 被加載完后，小程序框架會立即執(zhí)行 require('app.js') 進行注冊小程序實例，即對 App() 函數(shù)進行調用（開發(fā)者已經(jīng)在 app.js 中定義好了入?yún)ο螅?，如下?/p>

<script src="./app.js"></script>
<script>require("app.js")</script>

在 App() 函數(shù)中，最終會調用 y(...) 方法進行初始化，其中 y(...) 的定義比較長，我們這里不再貼出代碼，詳情請自行查閱 WAService.js ，它的處理流程如下：

聲明 App.getCurrentPage 方法將被廢棄，請使用 getCurrentPages() 全局方法；
綁定生命周期函數(shù)，即把外部入?yún)ο蠖x的屬性綁定到小程序實例對象中，包括 onLaunch， onShow ， onHide ， onUnlaunch 和 onPageNotFound ；
綁定開發(fā)者自定義的其他屬性（包括數(shù)據(jù)和方法），并校驗屬性名是否為 “getCurrentPage”，如果是則警告；
根據(jù)外部是否有定義 onError 屬性判斷是否注冊錯誤上報；
檢查啟動參數(shù)（取自__wxConfig.appLaunchInfo）并依次調用 onLaunch 和 onShow 方法；
注冊前后臺切換回調 onShow 和 onHide ；
注冊找不到頁面的回調 onPageNotFound ；
返回實例給 App() 函數(shù)進行緩存。

Page() 和 getCurrentPages() 函數(shù)

根據(jù) 文檔， Page() 函數(shù)用來注冊一個頁面，接收一個 object 對象參數(shù)，其指定頁面的初始數(shù)據(jù)、生命周期函數(shù)、事件處理函數(shù)等。 Page() 函數(shù)的聲明如下：

function Page(page: PageOptions): void

對于入?yún)?nbsp;object 對象（PageOptions）的屬性說明如下：

小程序 App() 和 Page() 函數(shù)調用時的初始化流程

此外， getCurrentPages() 函數(shù)用于獲取當前頁面棧的實例，以數(shù)組形式按棧的順序給出，第一個元素為首頁，最后一個元素為當前頁面。它的聲明如下：

function getCurrentPages(): object[]

內部實現(xiàn)

同樣地，在 __appServiceEngine__ 對象中，對 Page 和 getCurrentPages 屬性的定義如下：

var r = n(2);
Object.defineProperty(t, "Page", {
  enumerable: !0,
  get: function() {
      return r.pageHolder
  }
}),
Object.defineProperty(t, "getCurrentPages", {
  enumerable: !0,
  get: function() {
      return r.getCurrentPages
  }
}),

而這兩個屬性對應的實現(xiàn)分別為 pageHolder() 和 getCurrentPages() 方法，定義如下：

var k = void 0, // 保存當前顯示的頁面（棧頂）
x = [], // 保存已加載過的頁面歷史棧數(shù)組

// 其中的 t 就是 __appServiceEngine__ 對象

t.getCurrentPage = function() {
    return k
},
t.getCurrentPages = function() {
    var e = [];
    return x.forEach(function(t) {
        e.push(t.page)
    }),
    e
},

M = {}, // 緩存所有已經(jīng)注冊的頁面

t.pageHolder = function(e) {
   if (!__wxRouteBegin) throw (0, f.error)("Page 注冊錯誤", "Please do not register multiple Pages in " + __wxRoute + ".js"),
   new a.AppServiceEngineKnownError("Please do not register multiple Pages in " + __wxRoute + ".js");
   __wxRouteBegin = !1;
   var t = __wxRoute;
   if (!A(t)) throw (0, f.error)("Page 注冊錯誤", __wxRoute + " has not been declared in app.json."),
   new a.AppServiceEngineKnownError(__wxRoute + " has not been declared in app.json.");
   var n = "undefined" != typeof __wxAppCode__ ? __wxAppCode__[t + ".json"] || {}: {};
   if ("Object" !== (0, f.getDataType)(e)) throw (0, f.error)("Page 注冊錯誤", "Options is not object: " + JSON.stringify(e) + " in " + __wxRoute + ".js"),
   new a.AppServiceEngineKnownError("Options is not object: " + JSON.stringify(e) + " in " + __wxRoute + ".js"); (0, f.info)("Register Page: " + t),
   void 0 !== n.usingComponents ? (__virtualDOM__.Page(e), M[t] = exparser.Component._list[t]) : M[t] = e
},

分析上述代碼，我們可以總結 pageHolder 方法的處理流程如下：

小程序在每加載一個頁面前，會先設置 __wxRouteBegin = true ，用于標記防重；
判斷 __wxRouteBegin 是否為 false ，如果是，則拋出多次調用 Page 注冊錯誤；
設置 __wxRouteBegin 為 false ，避免被后續(xù)代碼被重復執(zhí)行；
調用 A(...) 方法檢查當前頁面是否在 app.json 中定義，如果沒有，則拋出錯誤；
檢查外部入?yún)ⅲ≒ageOptions）是否為 Object 對象，如果不是，則拋出錯誤；
判斷當前頁面是否使用了自定義組件（對于使用了自定義組件的 Page 對象會采用不同的配置），然后緩存當前 Page 的配置到 M 對象中。

此外，我們可以發(fā)現(xiàn)，與 App() 不同的是，外部通過 Page() 函數(shù)傳入的（生命周期）代碼并不會在這里被執(zhí)行，而是等待頁面 Ready 并進入頁面進行實例化后才執(zhí)行。

頁面初始化流程

同樣地，根據(jù) page-frame.html 的加載順序，在 app.js 被加載并執(zhí)行后，小程序之后會先依次按順序加載所有的自定義組件代碼（如果有）并自動注冊。自定義組件（Component）在小程序開發(fā)中具有重要地位，它可以豐富小程序的基礎功能，擁有的能力比