在小程序开发中, App(...) 和 Page(...) 是我们最熟悉也是最常用的两个函数,今天我们就来分析一下它们的内部实现,以及调用时的初始化流程。
在微信开发者工具中,编译运行你的小程序项目,然后打开控制台,输入 document 并回车,就可以看到小程序运行时,WebView 加载的完整的 page-frame.html ,如下图:
通过分析这个 HTML 文件,我们可以得到小程序的启动执行流程大致如下:
此图来自上述文章,我们这里不再重复赘述这些流程,下面我们来看一下其中的 App() 和 Page() 的细节。这两个函数在小程序框架 WAService.js 中定义,并在 app.js 和每个页面的 page.js 中进行调用实例化。
在微信开发者工具的控制台中执行 openVendor() 方法,可以打开小程序框架所在目录,如下:
/Users/用户名/Library/Application Support/微信web开发者工具/WeappVendor/基础库版本号目录
本文以 1.9.94 基础库为例进行分析。 WAService.js 文件的结构如下:
;(function(global) { // WeixinJSBridge 的定义和加载 // NativeBuffer 的定义和加载 // wxConsole 的定义和加载 // WeixinWorker 的定义和加载 // Reporter 的定义和加载 // __appServiceSDK__ 的定义和加载 wx = __appServiceSDK__.wx, // exparser 的定义和加载 // __virtualDOM__ 的定义和加载 // __appServiceEngine__ 的定义和加载 Page = __appServiceEngine__.Page, Component = __appServiceEngine__.Component, Behavior = __appServiceEngine__.Behavior, __webview_engine_version__ = .02, App = __appServiceEngine__.App, getApp = __appServiceEngine__.getApp, getCurrentPages = __appServiceEngine__.getCurrentPages, __createPluginGlobal = __appServiceEngine__.__createPluginGlobal, // __wxModule__ 的定义和加载 definePlugin = __wxModule__.definePlugin, requirePlugin = __wxModule__.requirePlugin; // define 方法的定义 // require 方法的定义 global.App = App; global.Page = Page; global.Component = Component; global.Behavior = Behavior; global.__webview_engine_version__ = 0.02; global.getApp = getApp; global.getCurrentPages = getCurrentPages; global.wx = wx; global.definePlugin = __wxModule__.definePlugin; global.requirePlugin = __wxModule__.requirePlugin; })(this);
我们发现, WAService.js 中定义了 WeixinJSBridge 和 wx 这两个基础 API 集合,同时也包含的其他一些框架核心,如 exparser , __virtualDOM__ , __appServiceEngine__ 等。其中 __appServiceEngine__ 提供了框架最基本的对外接口,如 App,Page,Component,Behavior 等方法; exparser 提供了框架底层的能力,如实例化组件,数据变化监听,View 层与逻辑层的交互等; __virtualDOM__ 则起着连接 __appServiceEngine__ 和 exparser 的作用,如对开发者传入 Page 方法的对象进行格式化再传入 exparser 的对应方法处理。(此段分析摘自上述文章)
由上可知,本文要分析的全局函数 App() 和 Page() 是对 WAService.js 中定义的 __appServiceEngine__ 对象同名方法的引用。下面我们简要分析一下它们的内部实现和初始化流程。
根据微信小程序 开发文档 , App() 函数用来注册一个小程序,接收一个 object 对象参数,其指定小程序的生命周期函数等。我们从微信开发者工具的函数提示可以知道, App() 函数的声明如下:
function App(options: _AppOptions): void
对于入参 object 对象(_AppOptions)的属性说明如下:
此外,全局的 getApp() 函数可以用来获取到小程序实例,它的声明如下:
function getApp(): object
全国7x24小时客服热线
所有故障均24小时内解决
项目一次性收费安心
技术人员均从业5年以上
通过技术营销传播企业服务价值
丰富的行业实战经验积累
基于需求研发多款产品
针对需求提供精细化服务