使用原生开发高仿瑞幸小程序（一）：使用 Vant 组件库和配置多页面

源起

为什么要跨平台，自然是为了节约成本。尤其是创业初期，需要快速迭代，快速试错。此时用原生技术，开发起来未免太过拖沓。我所想的是，如何能够快速的，最大化的覆盖屏幕数。首先，我们按照old school来分，我们可以分为移动端，web端和pc端。移动端的跨平台技术可以采用目前大热的flutter，这是由google推出的技术。而web端和pc端在Electron出现后，也变得简单了。我们可以用js来写pc端的应用。这就意味着，我们只需要两门技术就能覆盖所有端。

但，我们一定漏掉了什么。对，就是微信的小程序。相比上面的端的覆盖，我更在意的是屏幕数量的覆盖。但作为一个初创公司，拿着自己开发的app去做推广获客成本太高，地推？补贴？别忘了我们定位的是初创公司，这样下去，不是烧钱烧死，就是被羊毛党薅死。所以我们的思路就该是从流量大的地方薅用户。如今移动互联网的流量已经集中在几个大的平台上，例如微信，例如抖音。所以微信小程序是我的不二之选（这不是广告软文哈）。我之所以有这样的认知，也是由于这次疫情给了我极大的启发。由于人们避免在线下集会，造成了很多线下活动无法展开，纷纷转向了从线上寻求出路。所谓大危机中必然有大机会。我相信，很大一部分需求会搬到微信上来。所以微信将在未来的一两年会爆发出一大波需求，不容忽视。

那么再回到技术上来，微信小程序的开发，本质上还是js的开发。所以从技术栈角度来讲，并没有新添什么负担。现在前端的技术栈是js和dart（flutter）。那么服务端呢？为了不增加负担，我们能不能从js和dart中选一个呢？当然可以，在dart方面，闲鱼已经跑了很远了。可我想选js。为什么？别忘了，我们的定位是初创公司。要避免在陌生领域开疆拓土。我们可以选择非常成熟的nodejs。而和小程序联系非常紧密的云开发正是使用了nodejs。云开发不仅可以给小程序提供支持，还能给flutter，web端提供支持。这是似乎是一个很完美的方案。虽然没有收到腾讯云开发一分钱的广告费，但我仍然想为他们打call，这确实是一个伟大的产品。以我在腾讯云上的开发经验，开发效率那是杆杆的。

最后我想实践一下我的想法，所以在接下来的日子里，我会高仿一个小程序。例如某幸咖啡。同时写一系列的笔记或者教程。等小程序开发的差不多了，再用flutter开发 app端。那个时候，flutter的web开发应该也成熟了吧。我会再用Electron将web端打包成桌面端。对，所有的活都有我一个人完成。大家看，这里面也没有多少技术，一个人是可以挑战一下的。

当然，所有的代码都将会开源。

代码放在：https://github.com/gogoswift/luckin，欢迎各位大佬 Star

准备工作

在这一篇中，我们一起来做两件事

1 创建小程序 2 下载微信开发者工具

我们首先要登录微信公众平台，去注册一个小程序 https://mp.weixin.qq.com/wxopen/waregister?action=step1&token=&lang=zh_CN 这个页面会要求我们填写注册邮箱，当我们填写完注册邮箱，设置好密码之后，邮箱会收到一封激活邮件。账号激活后，我们就可以进入小程序的后台，去填写小程序的信息了。内容嘛，大家看着填，这里就没有统一标准了。

当我们填写完信息后，我们再点“查看详情”。

此时我们就进入了小程序的基本设置，将网页一拖到底，可以看到AppID(小程序ID)，这个非常重要，我们复制一下，待用。

至此，我们的准备工作就完成了一半。接下来我们要去以下网址下载“微信开发者工具”https://developers.weixin.qq.com/miniprogram/dev/devtools/stable.html[1]安装好以后，然我们打开微信开发者工具，点这个大大的加号创建新的小程序。

在左侧，我们选择“小程序”，右侧，填一些必要的信息。注意第三行AppID，就是刚才我们复制的内容。

注意要勾选“小程序 云开发”。一切准备妥当，点“新建”按钮。然后我们会进入工作界面。在详情中，我们能看到我们在小程序网站上填写的一些信息。

至此，我们就完成了小程序项目的创建。再下面的章节中，我们就要开始具体的编码工作了。其中，我们会用到来自有赞团的小程序UI组件库Vant Weapp。这是一个非常棒的UI组件库，很大程度上提高了开发效率。必须要粉它。

引入 Vant Weapp 组件库

我觉得小程序的精髓在于小，需精准定位，解决用户痛点。不做大而全，做好小而精，让用户为了解决某个问题能想到我们的小程序就是成功了。例如，想喝咖啡就打开我们的小程序。在这一篇教程中，我们要完成以下几件事。

1 整理项目文件 2 引入有赞UI库vant weapp

在上一篇教程中，我们创建了小程序。小程序默认的项目有太多demo，是我们不需要的。所以我们要把项目整理一下，删掉不要用的东西。首先，我们可以把这三个目录下的内容都删掉 “components”，“images”，“pages”。接下来我们打开app.json，注意“pages”这个字段的值，这里面引用的是一些demo路径。现在我们要把这些路径都删掉。然后写下自己的第一个界面路径。

"pages": [
    "pages/home/home"
  ],

在这里，我们写了一个路径，而相应的微信开发着工具，就会在这个路径下生成一个默认的页面：home。

在网站的概念中，这就是网站的首页。我们可以看到，在home文件夹下，有四个文件。这四个文件都负责什么作用呢？让我们一一细说。home.js 这个文件看后缀名就知道，我们它负责程序的业务逻辑，例如获取数据，设定数据，界面跳转等。home.json 这是页面的配置文件，引入一些第三方的库和模块都可以在这里设置。home.wxml 我们可以把这个后缀名分为w和xml，所以它本质是个xml文件，起的作用是定义页面的界面。我们可以把整个页面上有什么视觉内容都在这个文件中定义好。home.wxss 这其实是一个css样式文件。所以由上面四个文件组成了如下的视觉效果

这是开发者工具创建的默认界面，

<text>pages/home.home.wxml</text>

至此，我们完成了今日的第一部分内容，整理项目文件。接下来，我们要引入一个非常牛逼的UI组件库，来自有赞团队的Vant Weapp。让我们打开他们的首页。https://youzan.github.io/vant-weapp/#/intro[2]大家可以去上面的网址看看他们提供的UI组件和强大的自定义能力，别玩了再跳回来继续看我的文章哟。如果你看完了，我们就来看看如何引入这个牛逼的库。我们在项目网站的“快速上手”中可以找到安装教程。在这里我简单的说一下：1 右键单击miniprogram文件夹，选择“在终端打开”

2 通过# 通过 yarn 安装yarn add @vant/weapp —production3 我们打开微信开发者工具右边的“详情”按钮，在本地设置中，勾选上“使用npm”

4 构建 npm 包 让我们打开微信开发者工具，点击 工具 -> 构建 npm，并勾选 使用 npm 模块 选项，构建完成后，即可引入组件

至此，我们就完成了vant weapp组件库的导入。在我们的项目文件中，会出现 “miniprogram_npm”和“node_modules”两个目录，还有package.json和yarn.lock这两个文件。

至此，我们就完成了Vant Weapp UI组件库的导入。最后有一个大坑别忘记了，我们要在app.json 中把"style": “v2”给删掉。官方给出的理由是“程序的新版基础组件强行加上了许多样式，难以去除，不关闭将造成部分组件样式混乱。” 希望有赞团队以后能改进，要不然总觉得不完美。

创建 TabBar

小程序是工具，服务于社群。公众号是自媒体，两者结合才能发挥最大作用。幸运的是，现在它们已经打通了的。在这一篇教程中，我们要完成以下几件事。

1 学会使用Tabbar组件 2 学会创建components

一 学习Tabbar组件的使用

导入了Vant组件库后，让我们马上来应用一下。我们可以在home页面下引入Tabbar组件。Tabbar起到底部导航的作用，一般来讲，有几个大的模块，就会有几个Tabbar标签。效果如下

在小程序中，引用第三方组件其实很简单。大概分为两步。

1 在页面的json文件中配置第三方组件的引用 2 在wxml中调用。

有时我们也可以直接在,js文件中import，然后直接用它。好了，下面的环节是我们今天的这篇文章的最后一部分，如何使用Tabbar。通过观察可得，底部会有5个标签，分别是：”首页“，”菜单“，”订单“，”购物车“和”我的“ 所以我们首先需要准备的是图标文件。由于瑞幸的小程序底部的Icon是由线框和实底两种风格组成。所以我们需要准备十张图片。当然，我们也可以使用Iconfront，但不在本次的教学范围之内。我们将准备好的图片放入images文件夹中。带select后缀的标示为选中后显示的图标。

这些图片我将会放到github上，以供大家使用。接着我们打开home.json文件进行组件的引用。

"usingComponents": {
    "van-tabbar": "@vant/weapp/tabbar/index",
    "van-tabbar-item": "@vant/weapp/tabbar-item/index"
  }

做好组件引用之后，我们就要在home.wxml中进行调用了。先来看一下完整的代码（其实我建议直接跳过去看分析，一般来讲，大段贴代码都是为了混字数）：

<van-tabbar active="{{ active }}" bind:change="onChange">
<van-tabbar-item name="home">
<image slot="icon" src="../../images/home.png" mode="aspectFit" style="width: 30px; height: 18px;" />
<image slot="icon-active" src="../../images/home_select.png" mode="aspectFit" style="width: 30px; height: 18px;" />
首页
</van-tabbar-item>
<van-tabbar-item name="menu">
<image slot="icon" src="../../images/menu.png" mode="aspectFit" style="width: 30px; height: 18px;" />
<image slot="icon-active" src="../../images/menu_select.png" mode="aspectFit" style="width: 30px; height: 18px;" />
菜单
</van-tabbar-item>
<van-tabbar-item name="order">
<image slot="icon" src="../../images/order.png" mode="aspectFit" style="width: 30px; height: 18px;" />
<image slot="icon-active" src="../../images/order_select.png" mode="aspectFit" style="width: 30px; height: 18px;" />
订单</van-tabbar-item>
<van-tabbar-item name="cart">
<image slot="icon" src="../../images/cart.png" mode="aspectFit" style="width: 30px; height: 18px;" />
<image slot="icon-active" src="../../images/cart_select.png" mode="aspectFit" style="width: 30px; height: 18px;" />
购物车</van-tabbar-item>
<van-tabbar-item name="my">
<image slot="icon" src="../../images/my.png" mode="aspectFit" style="width: 30px; height: 18px;" />
<image slot="icon-active" src="../../images/my_select.png" mode="aspectFit" style="width: 30px; height: 18px;" />
我的</van-tabbar-item>
</van-tabbar>

我们可以很明了的看到，整个Tabbar由“van-tabbar”和“van-tabbar-item”组成。我们先来看“van-tabbar-item”我们这里使用到了vant强大的自定义的能力。在默认情况下，tabbar-item的是酱紫使用的

<van-tabbar-item icon=“home-o">标签</van-tabbar-item>

由于我们是自定义图标，所以我们要在van-tabbar-item把icon属性去掉。同时加入image组件用slot这个关键字来描述我们要自定义的部位。例如在我们的项目中，我们用slot=“icon"定义了未选中的图标，用 slot=“icon-active”定义了选中的图标。还有一点需要注意的是，我们image标签下src的属性。这里使用的是当前文件（home.wxml）的相对路径大家想一下../../images/home.png是不是指向当前文件（home.wxml）的，上一级，再上一级的images目录下的home.png文件？这个概念很重要，在我们的组件引入也会用到。大家要用心体会。当我们完成页面的搭建后，我们就要来做一些交互了。比如选中van-tabbar-item的时候，图标会进行切换，同时展示不同的界面。这一切，就要跟home.js 文件进行交互了。在小程序的框架中，wxml和js文件的绑定是默认的，只要是同名文件就好。那么如何进行选中图标的切换呢？我们要使用van-tabbar 中 active属性进行指定。那么如何做呢？我们注意到tabbar-item中有个name属性，例如“首页”的name属性是“home”，所以当我们把home做为值赋予active属性是，界面上就显示了被选中的图标。我们可以active=“home”和active=“menu”体验一下。当然，这不能满足我们的需求。我们的需求是，active的值要根据我们点选的item而进行改变。所以，我们要把active绑定到一个变量上。如下active=“{{ active }}”在wxml绑定js中的变量，我们需要使用双大括号{{ }} 而变量名，则写在js文件的data对象中。如下：

data: {
    active:"home"
},

完成这步，我们要做的就是动态的改变active的值了。所以我们这里要用到事件和js文件中的函数进行绑定。bind:change=“onChange"看语法，每次item的点击，都会触发change事件，所以我们只要跟onChange函数绑定即可。在这里我们只需写上函数名，然后在js文件中进行实现。而在onChange函数中，我们要做什么呢？我们只需要把item的name赋值给变量active。怎么做到这点呢？很巧的事，change事件携带的参数e，有一个属性detail正好对应上name属性。于是我们的代码可以这么写

onChange:function(e){
    console.log(e.detail)
    this.setData({
      active:e.detail
    })
},

注意最后一个大括号后面的逗号”,”，如果函数插在js文件中间的话，这个必不可少。好了，至此，我们就完成了Tabbar标签图标的切换。我们今天要做的最后一块内容是，做5个界面组件，随着item的切换进行切换。

二 学会创建组件

也很简单，分三步：

1 创建组件 2 引入组件 3 代码其控制显示

我们在pages/home路径下创建components文件夹，用来存放不同的组件。我们先在components下创建home文件夹，再右键点击home文件夹，选择“新建Component”

命名为home，这时候就会在home文件夹下生成四个文件，这四个文件和我们之前在pages创建的页面意义是一样的。至此，我们就完成了home组件的创建，接着我们再依次创建menu，my，order，cart四个组件。具体界面暂时先不用写。我们先完成界面切换的互动。还记得我们是怎么引入组件的吗？对咯，在json文件中。所以我们打开pages/home目录下的home.json文件。这里要注意，有两个home，不要打开components目录下的home。引入我们创建的组件

"usingComponents": {
    "van-tabbar": "@vant/weapp/tabbar/index",
    "van-tabbar-item": "@vant/weapp/tabbar-item/index",
    "tabbar_home":"./components/home/home",
    "tabbar_menu":"./components/menu/menu",
    "tabbar_order":"./components/order/order",
    "tabbar_cart":"./components/cart/cart",
    "tabbar_my":"./components/my/my"
  }

tabbar_home等key是我们自定义的标签名，它的value则是组件存放的相对路径。”./”标示从当前目录开始算起。大家要注意，这是相对路径。当我们依次设定好tabbar_menu，tabbar_order，tabbar_cart，tabbar_my之后 ，我们就要回到wxml中构建界面了。由于标签化后，我们可以直接在home.wxml中使用组件标签。

<tabbar_home />
<tabbar_menu  />
<tabbar_order  />
<tabbar_cart  />
<tabbar_my />

但此时，我们创建的五个组件都显示在界面上。我们希望的是，当我们点击不同的item的时候，会切换到不同组件。那么我们该如何控制呢？其实也不复杂，我们依然要利用变量active进行控制。在小程序中，我们可以使用wx:if来做简单的逻辑控制。所以，当active的值为home时，我们要显示tabbar_home该怎么做呢？代码为

wx:if="{{active == 'home'}}"

这就表示了，除非active的值为home，否则tabbar_home标签就不会显示。这里有个简单的逻辑转换，这种颠过来倒过去的逻辑造成了很多人觉得程序猿很难沟通，而程序猿早就习以为常。好了，当我们完成以下代码时，我们就完成了不同组件的切换。

<tabbar_home wx:if="{{active == 'home'}}" />
<tabbar_menu wx:if="{{active == 'menu'}}" />
<tabbar_order wx:if="{{active == 'order'}}" />
<tabbar_cart wx:if="{{active == 'cart'}}" />
<tabbar_my wx:if="{{active == 'my'}}" />

于是乎，我们今天的内容就结束了。

参考资料

[1] https://developers.weixin.qq.com/miniprogram/dev/devtools/stable.html: https://developers.weixin.qq.com/miniprogram/dev/devtools/stable.html

[2] https://youzan.github.io/vant-weapp/#/intro: https://youzan.github.io/vant-weapp/#/intro