资讯专栏INFORMATION COLUMN

微信小程序开发三宗罪和解决方案

894974231 / 1550人阅读

摘要:微信小程序开发第一宗罪无法调用包虽然微信小程序开发工具打包时实现了函数加载依赖,但并不是完整的依赖管理。微信小程序开发第三宗罪无法重用组件其实微信小程序开发是并非完全不能重用组件,比如语法中支持和。

注意 本文章对应版本已经过时,请查阅最新版文档 https://github.com/maichong/l...


QQ交流群 282140496


在微信公布小程序的文档和开发工具后,脉冲软件在第一时间进行了学习和体验,我们发现微信小程序的技术架构和开发体验让我们非常失望。

由于微信小程序的运行环境并不是一个标准的浏览器环境,而且微信的封装工作并不完善,所以我们以往开发中的很多经验并不适用。

这并非简单的开发习惯不适应,更重要的是我们的开发流程、规范将不适用。

微信小程序开发第一宗罪: 无法调用NPM包

虽然微信小程序开发工具打包时实现了require函数加载依赖,但并不是完整的CommonJS依赖管理。因为require函数仅仅能够加载项目中的JS文件,而且必须严格定义JS文件路径,路径不支持CommonJS的路径风格。例如如下加载方式都将出错:

require("lodash");

require("lodash/map");

require("./foo");

在微信小程序开发工具中,我们必须对应写为如下格式:

require("node_modules/lodash/lodash.js");

require("node_modules/lodash/map.js");

require("./foo.js");

虽然我们可以像上面代码一样加载node_modules目录中的库,但是实际运行时却发生了:

在调试工具的Network选项卡中,我们看到运行时加载了1000多个文件,总数据量1.8MB,而我们仅仅是在代码中加载了一个lodash库而已!这是因为微信小程序开发工具会将所有项目下的js文件视为项目文件,并进行打包。而实际开发中,我们需要安装很多的NPM扩展库,而这些扩展库中有大量的不需要打包的文件,例如lodash中有上千文件,而我们只需要用到其中的非常少的一部分。

另外,在开发中,我们往往需要安装babal、eslient、webpack、grunt等待开发工具,微信小程序开发工具会一视同仁将这些工具的源码也进行打包......实测开发者工具将崩溃!开发者将崩溃!我崩溃!

所以不支持NPM包的原因,是微信开发者工具不支持CommonJS标准,不支持CommonJS标准的原因,是微信开发者工具想当然地认为项目目录下的js文件一定是项目文件,所以只实现了简单的require函数,想当然的原因是。。。

微信小程序开发第二宗罪: 无法使用Babel转码

无法使用Babel转码的原因其实仍然归结于无法加载NPM库。但是后果将十分严重。因为你将不能再安全使用ES6/7特性,你将无法使用async/await函数,你将和无尽的callback做斗争,你该怎样描述自己?回调地狱中的苦逼程序员?

如果你看到这里不明白Babel为何物,那么祝贺你,因为不曾见过天堂就不知何为地狱,你无须为不支持ES6/7而烦恼。但一旦你的大脑支持了ES6/7,用过了Babel,你就回不去了,像我一样,无Babel不编码。

微信小程序开发第三宗罪: 无法重用组件

其实微信小程序开发是并非完全不能重用组件,比如WXML语法中支持import和 include。但是那仅仅是视图模板可重用,并非组件可重用,因为我们认为组件在应当包含视图和逻辑。

WXML其实是基于可重用的组件,但是不允许我们自定义组件。如果你有React经验,你就会明白我的意思。

例如,你的小程序是个电商APP,项目中有两个页面中同时包含了商品列表组件,比如某分类下商品列表和搜索结果列表,我们知道这两个列表其实仅仅是参数不同而已。但是在小程序开发中,你只能将列表的模板抽象出来,不能将逻辑抽象出来,所以你就需要在两个页面上都实现一遍列表组件的控制逻辑,比如刷新、加载更多。。。

我们的实践

只吐槽、管杀不管埋是不道德的,既然发现了微信小程序开发中的各种弊端,我们脉冲软件在开发之中总结出了一套流程和工具,专为解决上述三个问题,并免费发布到了开源社区,这就是Labrador。接下来我们一起来尝试一下我们脉冲软件的开发体验。

安装Labrador

通过命令 npm install -g labrador-cli 全局安装Labrador控制行工具。

初始化项目

通过如下命令新建一个Labrador项目:

mkdir demo

cd demo

npm init

labrador init

项目初始化完成后,该目录是这个样子的:

图中的src是我们的源码目录,node_modules是NPM包目录,dist是目标输出目录。请在开发者工具中新建一个项目,并设置路径到dist目录,请勿设置为demo目录!使用WebStorm或Sublime打开demo目录,开发过程中,我们使用WebStorm或Sublime修改src目录下的源码,请勿直接修改dist目录中的文件,因为dist目录是通过labrador命令生成的。

在demo目录中运行 labrador build 命令编译项目,该命令会将src目录下的文件一一处理并生成dist目录下对应的文件。我们也可以运行 labrador watch 命令监控src目录下的文件变化,这样就不用每次修改后手动运行编译命令。

加载NPM包

我们以lodash包为例,在src/app.js中键入代码 const _ = require("lodash"); 编译后,我们看到dist目录下的文件是这样的:

我们看到dist目录下有一个npm/lodash目录,该目录下只有一个lodash.js文件,那么在微信web开发者工具中打包预览,lodash的库将只有这个文件被加载。

这一切是怎么发生的?

我们看一下dist/app.js的源码,发现源码中const _ = require("lodash"); 被编译为 var _ = require("./npm/lodash/lodash.js"); 然后labrador命令将node_modules/lodash/lodash.js 文件复制到了 dist/npm/lodash/lodash.js 。这就是通过labrador可以调用NPM包的原理。

重要的是,只有真正用到的js文件才被labrador命令加入到项目目录中。这样一个小小的改进象征着我们的小程序可以便捷调用NPM仓库中海量的扩展库!

Babel转码

在初始化的示例代码src/app.js中的内容是这样的:

图中timer和getUserInfo属性都为async函数,函数体内使用await调用异步操作。labrador 库对微信API进行了封装,使用 const wx = require("labrador"); 覆盖默认的全局变量wx; 封装后的wx对象提供的异步方法返回的都是Promise异步对象,结合async/await函数彻底终结callback,将异步代码同步写,轻松逃离回调地狱!

但目前async/await函数是不被浏览器支持的,我们需要使用babel对其转码,labrador编译命令已经内置了babel转码,转码后的代码可以查看dist/app.js,内容过长,不再张贴。

重用组件

重用组件最需要解决的问题是组件的逻辑代码怎样重用。在实例代码中有一个src/components目录,用来存放项目内的可重用组件,其结构是这样的:

子目录src/components/list中存放着一个可重用的组件。list.js / list.less / list.xml 分别对应微信小程序的 js / wxss / wxml 文件。JS为控件的逻辑层,其代码如下:

文件导出一个List类,这个组件类拥有像Page一样的生命周期函数onLoad, onReady, onShow, onHide, onUnload 以及setData函数。

LESS文件对应微信的WXSS文件,因为微信小程序实现的限制,LESS中无法使用连级选择语法,但是可以定义变量,方便开发。

XML文件对应微信的WXML文件,是组件视图描述文件,list.xml内容为:

文件中导出一个名为list的template。
组件不但可以存放在src/components目录内,还可以多带带做成NPM包,这样就可以轻松做到跨项目间的组件共享。

组件定义完成后,接下来是在页面中调用,在 src/pages/index/index.js 中有如下代码:

代码中首先引入了labrador库替换全局的默认wx对象,并使用labrador.createPage方法代替全局的Page函数声明页面。然后加载List组件类,在页面声明配置中,增加了components属性,并将List组件类实例化传入。labrador.createPage方法是对Page方法的一层封装,目的是在页面初始化时和组件对象进行关联。

在 src/pages/index/index.less 中加入代码 @import "list" 即可调用list组件的样式,如果在src/components/list中找不到list.less,那么编译命令将在NPM包中寻找 node_modules/list/index.less 。

在 src/pages/index/index.xml 中加入代码 即可调用list组件的模板文件,component 是Labrador自定义的组件,编译后对应生成 import 和 template。如果在src/components/list中找不到list.xml,那么编译命令将在NPM包中寻找 node_modules/list/index.xml

具体的体验还需要你亲自动手才行,文章到此结束,谢谢!


注意 Labrador 已经发布0.3版本,最新接口和此文内容会有出处,如果你不曾了解Labrador,那么你可以阅读此文初步了解Labrador,如果你已经开始基于Labrador构建项目,请参阅 使用Labrador 0.3构建ES6/ES7标准模块化微信小程序 一文查看最新的接口。

文章版权归作者所有,未经允许请勿转载,若此文章存在违规行为,您可以联系管理员删除。

转载请注明本文地址:https://www.ucloud.cn/yun/55651.html

相关文章

  • 使用Labrador 0.3构建ES6/ES7标准模块化微信小程

    摘要:是一个专为微信小程序开发的模块化的前端开发框架在微信小程序开发三宗罪和解决方案一文中我向大家阐述了微信小程序开发的三个弊端,并提供了框架来解决这些弊端。注意虽然我们采用了文件,但是由于微信小程序框架的限制,不能使用的层级选择及嵌套语法。 Labrador 是一个专为微信小程序开发的模块化的前端开发框架 在微信小程序开发三宗罪和解决方案一文中我向大家阐述了微信小程序开发的三个弊端,并提供...

    lindroid 评论0 收藏0
  • 使用Labrador 0.3构建ES6/ES7标准模块化微信小程

    摘要:是一个专为微信小程序开发的模块化的前端开发框架在微信小程序开发三宗罪和解决方案一文中我向大家阐述了微信小程序开发的三个弊端,并提供了框架来解决这些弊端。注意虽然我们采用了文件,但是由于微信小程序框架的限制,不能使用的层级选择及嵌套语法。 Labrador 是一个专为微信小程序开发的模块化的前端开发框架 在微信小程序开发三宗罪和解决方案一文中我向大家阐述了微信小程序开发的三个弊端,并提供...

    nanfeiyan 评论0 收藏0
  • React 可视化开发工具 Shadow Widget 非正经入门(之一:React 宗罪

    摘要:前言非正经入门是相对正经入门而言的。不过不要紧,正式学习仍需回到正经入门的方式。快速入门建议先学会用拼文写文档注册一个账号,把库到自己名下,然后用这个库写自己的博客,参见这份介绍。会用拼文写文章,相当于开发已入门三分之一了。 本系列博文从 Shadow Widget 作者的视角,解释该框架的设计要点,既作为用户手册的补充,也从更本质角度帮助大家理解 Shadow Widget 为什么这...

    dongxiawu 评论0 收藏0
  • React 可视化开发工具 Shadow Widget 非正经入门(之一:React 宗罪

    摘要:前言非正经入门是相对正经入门而言的。不过不要紧,正式学习仍需回到正经入门的方式。快速入门建议先学会用拼文写文档注册一个账号,把库到自己名下,然后用这个库写自己的博客,参见这份介绍。会用拼文写文章,相当于开发已入门三分之一了。 本系列博文从 Shadow Widget 作者的视角,解释该框架的设计要点,既作为用户手册的补充,也从更本质角度帮助大家理解 Shadow Widget 为什么这...

    leonardofed 评论0 收藏0
  • 使用Labrador 0.4构建组件化自动化测试微信小程

    摘要:自定义组件的自定义组件,是基于微信小程序框架的组件之上,进一步自定义组合,拥有逻辑处理和样式。这样做的目的请参见微信小程序开发三宗罪和解决方案项目中通用自定义组件存放在目录,一个组件一般由三个文件组成,和分别对应微信小程序框架的和文件。 Labrador 是一个专为微信小程序开发的组件化开发框架。 特性 使用Labrador框架可以使微信开发者工具支持加载海量NPM包 支持ES6/7...

    LiuRhoRamen 评论0 收藏0

发表评论

0条评论

最新活动
阅读需要支付1元查看
<