在 __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 } }),
而这两个属性对应的实现分别为 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,返回当前小程序对象。
在上述 page-frame.html 中,我们知道,在 app.js 被加载完后,小程序框架会立即执行 require('app.js') 进行注册小程序实例,即对 App() 函数进行调用(开发者已经在 app.js 中定义好了入参对象),如下:
<script src="./app.js"></script> <script>require("app.js")</script>
在 App() 函数中,最终会调用 y(...) 方法进行初始化,其中 y(...) 的定义比较长,我们这里不再贴出代码,详情请自行查阅 WAService.js ,它的处理流程如下:
声明 App.getCurrentPage 方法将被废弃,请使用 getCurrentPages() 全局方法;
绑定生命周期函数,即把外部入参对象定义的属性绑定到小程序实例对象中,包括 onLaunch, onShow , onHide , onUnlaunch 和 onPageNotFound ;
绑定开发者自定义的其他属性(包括数据和方法),并校验属性名是否为 “getCurrentPage”,如果是则警告;
根据外部是否有定义 onError 属性判断是否注册错误上报;
检查启动参数(取自__wxConfig.appLaunchInfo)并依次调用 onLaunch 和 onShow 方法;
注册前后台切换回调 onShow 和 onHide ;
注册找不到页面的回调 onPageNotFound ;
返回实例给 App() 函数进行缓存。
根据 文档 , Page() 函数用来注册一个页面,接收一个 object 对象参数,其指定页面的初始数据、生命周期函数、事件处理函数等。 Page() 函数的声明如下:
function Page(page: PageOptions): void
对于入参 object 对象(PageOptions)的属性说明如下:
此外, getCurrentPages() 函数用于获取当前页面栈的实例,以数组形式按栈的顺序给出,第一个元素为首页,最后一个元素为当前页面。它的声明如下:
function getCurrentPages(): object[]
同样地,在 __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 } }),
而这两个属性对应的实现分别为 pageHolder() 和 getCurrentPages() 方法,定义如下:
var k = void 0, // 保存当前显示的页面(栈顶) x = [], // 保存已加载过的页面历史栈数组 // 其中的 t 就是 __appServiceEngine__ 对象 t.getCurrentPage = function() { return k }, t.getCurrentPages = function() { var e = []; return x.forEach(function(t) { e.push(t.page) }), e }, M = {}, // 缓存所有已经注册的页面 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 ,避免被后续代码被重复执行;
调用 A(...) 方法检查当前页面是否在 app.json 中定义,如果没有,则抛出错误;
检查外部入参(PageOptions)是否为 Object 对象,如果不是,则抛出错误;
判断当前页面是否使用了自定义组件(对于使用了自定义组件的 Page 对象会采用不同的配置),然后缓存当前 Page 的配置到 M 对象中。
此外,我们可以发现,与 App() 不同的是, 外部通过 Page() 函数传入的(生命周期)代码并不会在这里被执行,而是等待页面 Ready 并进入页面进行实例化后才执行。
同样地,根据 page-frame.html 的加载顺序,在 app.js 被加载并执行后,小程序之后会先依次按顺序加载所有的自定义组件代码(如果有)并自动注册。自定义组件(Component)在小程序开发中具有重要地位,它可以丰富小程序的基础功能,拥有的能力比