武装你的小程序——开发流程指南

前端工程本质上是软件工程的一种。软件工程化关注的是性能、稳定性、可用性、可维护性等方面,注重基本的开发效率、运行效率的同时,思考维护效率。一切以这些为目标的工作都是"前端工程化"。工程化是一种思想而不是某种技术。

本篇文章你可以学到:

  • 如何使小程序支持scss;
  • 怎样通过gulp编译你的项目;
  • 项目常用的模块封装;
  • 小程序同webview之间如何优雅的进行交互;
  • 集中式管理你的项目提高可维护性;
  • 提升开发效率的小工具编写;

全文全部基于原生的小程序开发所阐述,各种第三方框架开发不在此列。并不会将整个项目的搭建流程细致的写出来,而是挑其中我认为在开发过程中存在的一些很重要的点进行详细陈述。

列举部分常见的

  • 小程序本身不支持常用的css预编译器,导致样式规范随意散落在各个文件,无法统一进行管理,而现代前端开发中不论是less,sass,stylus 都可以提升css效率;
  • 缺少统一的request拦截请求;
  • 缺少统一的路由管理;
  • 缺少集中式的API地址和ENV环境变量管理;
  • 缺少统一的本地缓存读取管理;
  • 重复的webview页面;
  • 不支持ES7以上的高级语法,如async await等特性;
  • 不管是体验版还是开发版只能存在一种环境,一旦发布预览测试环境切换繁琐;
  • 上线前需要手动修改线上环境,容易出错......

要解决工程化的问题,需要从两个角度入手:开发 && 部署

Question

  • 如何提高开发生产效率?
  • 如何降代码维护难度?

Program

  • 制定开发规范,提高团队协作能力;
  • 使用自动化编译工具使项目支持各种插件和提高效率的工具;
  • 模块/组件化开发;
  • 所有需要集中管理的地方进行统一封装;

  • 环境切换;
  • 压缩打包;

对于目前常用的工程化方案,webpack,rollup,parcel等来看,都常用与单页应用的打包和处理,而小程序天生是 “多页应用” 并且存在一些特定的配置。根据要解决的问题来看,无非是文件的编译,修改,拷贝这些处理,对于这些需求,我们想到基于流的 gulp非常的适合处理,并且相对于webpack配置多页应用更加简单。所以小程序工程化方案推荐使用 gulp

初始化一个项目,结构如下

  • src 为开发目录
  • dist(开启编译后可见)为预览/上传目录
  • .gitignore git上传忽略文件
  • gulpfile.js 编译配置文件
  • CHANGELOG.md 版本更新日志
  • README.md 项目说明文件
  • package.json 项目配置文件
  • 编译用到的插件 使用npm或yarn自行安装,安装过程不过多赘述,不会请自行搜索。"gulp": "^3.9.1" "gulp-sass": "^4.0.2" scss编译插件 "gulp-postcss": "^6.4.0" 强大的css处理插件 "gulp-rename": "^1.2.2" 更改文件名 "gulp-replace": "^1.0.0" 替换内容 "gulp-changed": "^3.2.0" 检测改动 "autoprefixer": "^6.5.1" 自动添加前缀

    gulp配置打包sass非常简单,唯一需要注意的是@import的使用,wxss是支持样式导入的,但上面说到过小程序是天生的多页面应用,每一个页面都对应一个wxss,因此sass打包会把import的文件打包到当前文件,从而导致当前文件的体积变大。由于微信限制单包代码不能超过2M,因此当css越写越多的时候,这种打包方式势必会使样式文件越来越大。

    那如何解决import的导入问题呢,其实也比较简单,说白了就是sass处理的时候,让其不处理import部分的语句就可以了。有两种方式可以做到,第一种是改写sass处理的源码,当遇到import语句时跳过。第二种是,在把文件交给sass处理前,我们先把import语句部分注释掉,这样sass处理的时候就会忽略了,当sass处理完成后,再把注释掉的语句打开即可。显然第一种成本比较高,也不好维护,所以我们采用第二种。 在处理import的时候,还有个地方是需要注意的。在sass中,import除了能引入css外,也可以引入变量,函数。因此,我们在处理的时候也需要注意区分,变量和函数最好有一个独立的文件目录存放,并且在import的时候,对于变量和函数,是必须交给sass处理的,也就是不能注释掉。因此我们单独配置了sass变量和函数存放的位置,这样我们在打包的时候,遇到这样的import语句,我们就跳过,交给sass处理,否则就代表其是引入了共用的样式文件,这样我们交给sass处理前,就先将其注释掉,sass处理完成后再把注释打开。

    完整实现支持scss思路如下:

    • 指定文件处理目录
    • gulp-replace通过正则匹配@import语句将其注释
    • 判断当前@import语句是否存在于变量和函数文件的配置路径中
    • 不存在就注释,存在就跳过
    • 启用gulp-sass编译scss文件,
    • 通过postcss对低版本ios和安卓进行兼容样式处理
    • gulp-rename更改文件后缀为.wxss
    • gulp-replace通过正则匹配@import语句打开注释
    • 最后输入到dist目录

    将生成的dist目录作为根目录丢进小程序开发工具即可实时刷新预览小程序,至此你的项目已经完全支持scss了,尽情的去浪吧。

    wx.request是小程序中最常用的api,在实际项目中会涉及到很多需要统一拦截/发送/处理,所以我们需要对wx.request进行二次封装用来支持各类需求,以实现代码的可维护性。小程序本身已经支持promise语法, 在此用promise将其封装成常用的.then的形式

    要做什么?

    • 可以通过header和data统一发送公共参数,如请求验证的token,用户id等信息...
    • 可以统一进行错误拦截处理,如全局登录状态判断,特殊code码的处理...
    • 可以根据配置自适应请求环境,如Mock,Dev,Test, Slave,Prod...

    需要支持的功能

    • 请求方式
    • 参数传递
    • 成功回调
    • 失败回调
    • 是否开启mock数据
    • 请求时是否展示loading
    • 请求错误时是否展示toast

    代码实现 

    <img class="lazyload inited loaded" src="https://www.jb51.cc/res/2019/02-18/17/1f03e854a49b1e48cc39140d924f47f8.jpg" alt="" width="957" height="886" src="https://www.jb51.cc/res/2019/02-18/17/1f03e854a49b1e48cc39140d924f47f8.jpg" data-width="1280" data-height="1185"><img class="lazyload inited loaded" src="https://www.jb51.cc/res/2019/02-18/17/56ee11af3a83ae78ec103461c0a87da0.jpg" alt="" src="https://www.jb51.cc/res/2019/02-18/17/56ee11af3a83ae78ec103461c0a87da0.jpg" data-width="1244" data-height="1280"> <img class="lazyload inited loaded" src="https://www.jb51.cc/res/2019/02-18/17/2c3e523f5a21fd1b958379fa641935ce.jpg" alt="" width="962" height="251" src="https://www.jb51.cc/res/2019/02-18/17/2c3e523f5a21fd1b958379fa641935ce.jpg" data-width="1280" data-height="333">

     
    调用方式 

    app.js入口文件内引入,并将其挂载到App对象上,需要调用时可通过getApp()的方式调用

    <img class="lazyload inited loaded" src="https://www.jb51.cc/res/2019/02-18/17/c7014f234ffc6f53057fed9405a17fe2.jpg" alt="" src="https://www.jb51.cc/res/2019/02-18/17/c7014f234ffc6f53057fed9405a17fe2.jpg" data-width="914" data-height="58"><img class="lazyload inited loaded" src="https://www.jb51.cc/res/2019/02-18/17/4538a2b95fe1ed9e56af338dbf6970c7.jpg" alt="" src="https://www.jb51.cc/res/2019/02-18/17/4538a2b95fe1ed9e56af338dbf6970c7.jpg" data-width="1024" data-height="270">
    index.js为例,关于API的引入会在后文介绍:

    路由的封装主要是为了防止路由地址各个文件散落,无法集中管理的问题。

    需要支持的功能

    • 无参路由和有参路由
    • 路由地址缩写
    • 参数传递
    • 跳转延时
    • 跳转类型

    代码实现

    定义出存路由地址的对象,使用时直接通过key值匹配

     
    实现一个parse方法解析参数为query拼接方式
     

     
    定义一个push对象接收普通无参数path地址和有参数的option对象,option对象包含path(路由地址)、query(参数),duration(跳转延时),openType(跳转方式)
     

     
    通过openType结合原生api实现路由的几种跳转方法
     

     
    调用方式 还是老规矩,直接挂载App对象通过getApp()获取直接调用
     

    合理的Stroage方法封装可以使你更优雅的管理你的本地缓存。此功能需要支持三种常用的setItem(设置缓存)、getItem(读取缓存)、clear(清除缓存)方法,并且在你的团队内部最好整理一套写入缓存的规范,不要一股脑丢在全局,应该按一些模块进行划分存取,这样才能更好的维护你的本地缓存信息。 代码实现 写入和读取均支持key ---> value的普通方式也兼容key--->value--->module的模块方式,默认使用同步的方式设置,之所以加catch是为了防止在特殊情况下小程序会报警设置缓存错误,如同步报错则采用异步容错。

    setItem写入缓存

     
    getItem读取缓存
     

     
    clear清除缓存 
     

     
    调用方式 同上挂载App,使用方法如下:
     
    读取
     

     
    清除
     

    API地址和ENV环境变量可以做为两个单独配置的文件进行配置,API文件只存接口路径,ENV存储多个环境变量,环境对象内配置当前环境各种域名,然后在app.js配置当前环境变量,作为key值匹配ENV内的环境,将匹配的环境挂载App对象,配合前面封装的fetchApi以env+url的方式实现自动环境适配。

    API

     
    ENV
     

     
    app.js
     

    微信小程序提供了在小程序中内嵌HTML页面的能力,从微信小程序基础库1.6.4开始,可以在小程序内放置一个组件来链接HTML页面。有了就可以方便的将几端共用的h5页面集成到小程序内部,为我们减少了可观的工作量。

    如果你有多个需要集成的webview页面实际上无需为每个页面都单独建一个文件,只需对一个公共的webview页面进行简单封装配合路由即可集中管理你的webview页面。

    代码实现

    wxml引入webview组件和加载中动画,webview组件接收地址,和加载成功回调。

    <img class="lazyload inited loaded" src="https://www.jb51.cc/res/2019/02-18/17/f2eeac3fbf5bee50cc4ffbab6ac4421b.jpg" alt="" src="https://www.jb51.cc/res/2019/02-18/17/f2eeac3fbf5bee50cc4ffbab6ac4421b.jpg" data-width="1280" data-height="299">
    js中在data内定义webview页面的地址列表,key用type代表指定路径,value用page代表页面链接,通过onload接收一个formpage参数对应type,动态加载组件上的src即可。需要注意的一点是,如果需要在webvie链接拼接获取的参数,在某些安卓机型会因为提前渲染webview而src地址没有初始化而产生白屏,所以最好的方式是通过一个变量控制组件的展示隐藏,确保需要渲染组件时数据已经初始化完成以保证页面正常展示。 <img class="lazyload inited loaded" src="https://www.jb51.cc/res/2019/02-18/17/f4bdb2c34af5d8ce58846a33496ff3bb.jpg" alt="" src="https://www.jb51.cc/res/2019/02-18/17/f4bdb2c34af5d8ce58846a33496ff3bb.jpg" data-width="738" data-height="426"><img class="lazyload inited loaded" src="https://www.jb51.cc/res/2019/02-18/17/a53bded68fa2cee7b699df5157eee37f.jpg" alt="" width="737" height="693" src="https://www.jb51.cc/res/2019/02-18/17/a53bded68fa2cee7b699df5157eee37f.jpg" data-width="1280" data-height="1202"><h3 class="heading" data-id="heading-21">如何解决多环境切换问题

    小程序不像h5网页只要部署到对应环境,就可以随意输入指定的环境域名进行测试,而小程序像app一样没有网址这一说,它本身只会存在一个预览版本,普通的流程是每次当测试同学需要在不同环境中测试时就需要找到开发同学手动更改环境并重新发布体验版。这样的流程是很不灵活的,所以我们需要想一个办法,让一个小程序版本自由的切换多个环境,而无需手动改代码配置发布。

    如何实现?

    实现的思路有很多种,主要需要解决的就是环境如何进行切换的问题,在这里我是通过利用小程序的重力感应api模拟摇一摇,将切换环境搓成一个一个隐藏的小彩蛋,测试人员只需要摇一摇弹出环境选项列表点击对应选项更改App对象的config内的env环境属性即可成功切换环境。

    代码实现

    <img class="lazyload inited loaded" src="https://www.jb51.cc/res/2019/02-18/17/76fa6c211dc0c29b351e6d7fe3d867fb.jpg" alt="" width="818" height="775" src="https://www.jb51.cc/res/2019/02-18/17/76fa6c211dc0c29b351e6d7fe3d867fb.jpg" data-width="1280" data-height="1212"><img class="lazyload inited loaded" src="https://www.jb51.cc/res/2019/02-18/17/24cea14edfad9da334e73478325d0402.jpg" alt="" width="826" height="430" src="https://www.jb51.cc/res/2019/02-18/17/24cea14edfad9da334e73478325d0402.jpg" data-width="1280" data-height="666">

     
    app.js也要进行处理,因为不能将该功能带到线上所以需要进行逻辑判断。
     

    在这里其实还是要用到gulp这个神器,来实现不同环境的代码打包,配置起来很容易,无非就是通过gulp-replace在打包的时候对app.js的环境变量进行配置,但要配合微信开发工具的自定义处理命令每次在发版本审核的时候只需要开启该功能即可。

    gulpfile.js

    <img class="lazyload inited loaded" src="https://www.jb51.cc/res/2019/02-18/17/c3ae6364e532c84d0640bfcc6b35ced2.jpg" alt="" src="https://www.jb51.cc/res/2019/02-18/17/c3ae6364e532c84d0640bfcc6b35ced2.jpg" data-width="1196" data-height="958"><img class="lazyload inited loaded" src="https://www.jb51.cc/res/2019/02-18/17/90d388d233c0386c2b4d91c3946df93c.jpg" alt="" src="https://www.jb51.cc/res/2019/02-18/17/90d388d233c0386c2b4d91c3946df93c.jpg" data-width="1220" data-height="210">

     
    project.config.json
     

     
    开发者工具
     

    以上列举了开发流程中常用的工程化解决方案,再此希望对大家有一个参考作用,如有问题欢迎指正。

    版权声明:本文内容由互联网用户自发贡献,该文观点与技术仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容, 请发送邮件至 dio@foxmail.com 举报,一经查实,本站将立刻删除。

    相关推荐


    概述 消息能力是小程序能力中的重要组成,我们为开发者提供了订阅消息能力,以便实现服务的闭环和更优的体验。 订阅消息推送位置:服务通知 订阅消息下发条件:用户自主订阅 订阅消息卡片跳转能力:点击查看详情可提爱转至该小程序的页面 消息类型 一次性订阅消息 一次性订阅消息用于解决用户使用小程序后,后续服务
    判断H5页面环境在微信中还是小程序中 用小程序提供的wx.miniProgram.getEnv可以获取环境参数 &lt;script type=&quot;text/javascript&quot; src=&quot;https://res.wx.qq.com/open/js/jweixin-1.
    wx.reLaunch和wx.navigateTo,wx.navigateTo的区别 2019-03-23 11:18:05 wx.navigateTo 用于保留当前页面、跳转到应用内的某个页面,使用 wx.navigateBack可以返回到原页面。对于页面不是特别多的小程序,通常推荐使用 wx.n
    微信小程序如何从数组里取值_微信小程序 传值取值的几种方法总结 小程序里常见的取值有以下几种,一个完整的项目写下来,用到的概率几乎是100%。 列表index下标取值 页面传值 form表单取值 1. 列表index下标取值 实现方式是:data-index=&quot;{{index}}&quot
    H5项目接入微信授权登录,通过 UA 区分微信还是普通浏览器: let&#160;ua&#160;=&#160;navigator.userAgent.toLowerCase(); let&#160;isWeixin&#160;=&#160;ua.indexOf(&#39;micromessenge
    微信小程序获取data-xx=&quot;&quot;属性的值,自定义属性设置和获取(data-) 微信小程序&lt;view class=&quot;details-btn&quot; data-taskId=&quot;111&quot; bindtap=&#39;taskdetails&#39
    小程序报错:TypeError: Cannot read property ‘addEventListener‘ of undefined 解决办法 将调试基础库由2.16.0(或者当前的) -&gt; 2.14.1 解决问题
    H5跳转微信小程序-成功案例(VUE)(踩坑无数) TuoMei 已于 2022-07-29 09:52:22 修改 准备工作 根据官方提供的资料需准备以下几点: 1、已认证的服务号 2、绑定JS接口安全域名 (在微信公众平台设置) 3、IP白名单 (在微信公众平台设置) 4、将小程序和H5公众号进
    微信小程序 页面跳转和数据传递实例详解 这篇文章主要介绍了微信小程序 页面跳转和数据传递实例详解的相关资料,这里附有实例代码帮助到家学习理解,需要的朋友可以参考下 微信小程序 页面跳转和数据传递 1.先导 在Android中,我们Activity和Fragment都有栈的概念在里面,微信小程序页面也
    情景1.拉取公司代码演示: 因为github有墙,这里我们以gitee(码云)为例作为演示 (其实就是国产github,也非常好用~) 步骤一:打开Git界面 先在一个空文件夹右击Git Bash Here,打开git界面 步骤二:输入克隆远程仓库指令 别人复制的链接在这里获取 拿到别人赋值的链接自
    如何开发微信小程序? 作为一名10多年一直从事互联网平台开发的从业者,我来回答下这个问题吧。 微信小程序开发流程总体可以归纳为4个步骤, 老张带您捋一捋整个环节,小白用户可以收藏了。 好了废话不多说,开始! 一、开发前小程序需要准备的资料 我们在开发微信小程序前,需要准备下相关资料。这个资料主要是后
    原生小程序开发优化方案 为了更好的制定优化方案,我们 有必要先了解下小程序的底层架构、以及与普通网页开发的差异 小程序最终渲染载体与当下一些热门的技术 Flutter、React Native等不同,依然是浏览器内核,而不是原生客户端。 而对于传统的网页来说,UI 渲染和 JS 脚本是在同一个线程中
    1,不要下两倍尺寸的图片, 小程序本身自己就会对元素缩小两倍,设计图片的一杯就已经很清晰了。 2,图片压缩,(主要是压缩静态资源,ps 可以压缩,然后有一些在线压缩工具,保持600-800kb 的静态) 3,通用的代码组件化 4,是在工程量太大可以分包,分包现在最大支持20m(一般都不会去分包的)
    文章浏览阅读189次。人工智能研究实验室OpenAI在2022年11月30日发布了自然语言生成模型ChatGPT,上线两个月就已经超过一亿用户,成为了人工智能界当之无愧的超级大网红。ChatGPT凭借着自身强大的拟人化及时应答能力迅速破圈,引起了各行各业的热烈讨论。简单来说ChatGPT就是可以基于用户文本输入自动生成回答的人工智能聊天机器人。那肯定会有人说这不就是Siri嘛,虽然都是交互机器人但是两者的差别可老大了。那么ChatGPT在人机交互时为什么会有这么出色的表现?它到底会不会取代搜索引擎?90%的人真的会因为ChatG
    文章浏览阅读193次。8. 导航和路由管理:掌握小程序的导航方式,如使用wx.navigateTo跳转页面、使用wx.redirect重定向页面等,学会实现页面之间的跳转和传参。1. 小程序的基本概念和架构:了解小程序的定义、特点以及与传统APP的区别,掌握小程序的运行环境、组件和API等基本概念。10. 支付功能:学习小程序的支付方式,如微信支付、支付宝支付等,了解支付流程和注意事项,学会实现小程序的支付功能。9. 用户授权和登录:了解小程序的用户授权机制,如获取用户信息、调用微信API等,学会实现用户的登录和注册功能。_微信小程序开发知识点总结
    文章浏览阅读4.8k次,点赞7次,收藏18次。一、准备工作1. 安装微信开发者工具,并登录微信小程序账号;2. 准备斗地主游戏的图片资源;3. 准备斗地主游戏的音效资源;二、创建小程序1. 打开微信开发者工具,点击“新建小程序”,输入小程序名称,选择小程序的项目目录,点击“创建”;2. 在小程序的项目目录中,新建文件夹“images”,将准备好的斗地主游戏的图片资源放入“images”文件夹中;3. 在小程序的项目目录中,新建文件夹“sounds”,将准备好的斗地主游戏的音效资源放入“sounds”文件夹中;三、编写代码1. 在小程_扑克牌微信小程序代码
    文章浏览阅读3.9k次,点赞3次,收藏7次。一、准备工作:1. 安装微信开发者工具,创建小程序项目;2. 准备游戏角色图片;3. 准备游戏背景音乐;二、实现步骤:1. 创建游戏页面,添加游戏角色图片,添加游戏背景音乐;2. 创建游戏角色类,定义游戏角色属性,如角色名称、角色图片、角色能力等;3. 创建游戏类,定义游戏属性,如游戏人数、游戏角色、游戏规则等;4. 创建游戏控制类,定义游戏流程,如游戏开始、游戏结束、游戏角色分配等;5. 创建游戏界面,实现游戏流程,如游戏开始、游戏结束、游戏角色分配等;6. 创建游戏结果页面,显示游戏_微信小程序游戏代码
    文章浏览阅读1.7k次。1. 创建小程序项目:使用微信开发者工具创建一个小程序项目,并在项目中添加一个页面,用于模拟聊天。 2. 定义数据结构:定义一个数据结构,用于存储聊天记录,包括发送者、接收者、消息内容等信息。 3. 实现聊天功能:实现聊天功能,包括发送消息、接收消息、显示消息等功能。 4. 实现界面:使用微信小程序的界面框架,实现聊天界面,包括聊天记录列表、输入框等。代码示例:// 定义数据结构var chatData = { sender: '', receiver: '', message: '' };_制作聊天对话小程序代码
    文章浏览阅读2.1k次。1、创建小程序项目:使用微信开发者工具,新建一个小程序项目,输入项目名称,选择项目目录,点击“创建”按钮,即可创建小程序项目。2、添加页面:在小程序项目中,可以添加多个页面,每个页面都有自己的页面文件,比如首页、分类页、购物车页、我的页面等。3、添加组件:在小程序项目中,可以添加多个组件,比如商品列表组件、购物车组件、订单组件等,用于在页面中显示商品信息、购物车信息、订单信息等。4、添加接口:在小程序项目中,可以添加多个接口,用于获取商品信息、购物车信息、订单信息等,以便在页面中显示。5、_微信开发者工具做一个我的商城