weixin_34248118
weixin_34248118

前端外行的微信小程序瞎折腾之旅

迁移一批老文章到掘金

前言

惭愧，最近下班回家沉迷山口山了，前一阵子搞antlr语法转换，这一阵子搞微信小程序，一直拖着没写点啥，一步一步来吧，肯定都得总结点东西留给自己看的。

新技术尝鲜

我一直是一个iOS客户端开发，前端经验只停留在w3cschool上面很基础的最初版本html,css,js学习，纯helloworld水准，就学了不到10分钟。所以这里也算是给客户端开发们打点气，新的东西阻碍的永远是你上手的动力，而不是这个东西的难易。顺带强调自己是前端外行，也是希望各位看官关于内容里如果有很多关于前端理解的偏差，帮我指正和修改。

加了一些小程序开发群，发现很多常问的问题是：

  • 我想上手小程序，需要先学啥语言，先学习html css js吗？
  • 小程序是用js开发吗？那我是不是要去先学js？
  • 想上手学小程序，需要什么知识储备吗？

我的看法是，我反正从来都不是这样学任何一个新东西的，我就一句话

  • 直接开干啊!遇到啥问题再具体查啥问题。

这也跟个人接触新东西的习惯有关，反正我是完全不喜欢那种打算学个新东西（注意是'新'东西），然后就问一下有啥经典书籍么？先抱着一本16开，三四厘米厚的一本大厚书，（我习惯叫砖书，很厚很大砸人很疼），看个好几天一个礼拜的，然后还没上手。或者听到个新东西技术是html，然后美名其曰技术储备，俩仨礼拜略微看明白点html，css，但也毫无实战经验，俩仨礼拜，连小程序的边都没摸到。

对于'新'东西，等系统化的出书，黄花菜都凉了啊，以前捣鼓RN的时候，无数人问RN有什么好书看，现在RN书停留的版本都是0.2X之前，并且一个个都很浅，现在0.3X已经天翻地覆了，这种啥都等系统化整理文章，做好技术储备，再开始动手，完全不是我的个人学习风格。

直接上手是最快的，虽然资料少，但是有源码下，源码是最好的指导方案，没源码，官方文档，Github交流，网上及时阅读最新的碎片化博客文章，这些绝对是最快的学习和了解'新'东西的手段。

光读光看是绝对没用的，最有效最有效的手段是，直接上手，上项目，哪怕是仿写一些开放API接口的app（知乎日报，豆瓣电影，有太多开放提供服务器api，让广大客户端开发者练手的）

以上只是我的个人学习习惯，因人而异

扯淡吐槽

  • xx火了，客户端要完蛋，前端要火
  • 小程序会不会灭掉客户端开发
  • 明年培训机构大量前端要涌入了
  • 小程序也不一定就会火，客户端不可代替

当初RN出来就是这样一波风气，小程序出来也是，我对任何这种话题是毫无兴趣！这种然并卵的话题，键盘侠们热火朝天讨论几个小时，时间就过去了，然后就可以happy下班了，有这功夫demo都写出来了，项目都上线了

开发环境

上面其实也扯了太多的废话，微信小程序其实有自己的IDE开发环境，一切都在这个开发环境里面，下载官方IDE开发包，开始运行，就可以直接开发预览小程序了。

但这里有个IDE开发包破解的问题，小程序目前需要是需要邀请码的，有邀请码你就会有属于你业务的微信小程序appId，有邀请码的好处是你可以把小程序部署到真机上，没有邀请码，无论你是否破解了IDE，你都无法真机预览，但是IDE里面的模拟器预览完全没有问题，能运行，能实现绝大部分功能，完全可以项目上先开发起来，等待一旦公测，就直接上线。

不破解IDE

先说结论：现在的最新版本IDE，完全不需要破解！

  • 最新版本的92300的IDE，mac下是一个dmg包，直接安装就能使用
  • 选择+号添加项目你能看到创建新项目必须填写AppID
  • 在92300版本里面，已经贴心的新增了一个无AppID的按钮，点了后会得到提示无AppID部分功能受限
  • 说的很吓人，这部分API很少，就2个，并且IDE提供了模拟数据返回，完全不影响绝大部分开发
  • 你就是破解了，不提示部分功能受限，也是该没法正常还照样没法正常工作，毕竟微信也有自己的服务器验证，你破解后填的AppID终归是假的
  • 选择工程目录，这时候切记如果你是从0开始创建工程，而不是拥有线程的wx小程序demo代码，一定要在选择工程目录的时候，创建全新文件夹
  • 只有全新创建的文件夹才会开启quickstart自动创建初始工程文件功能，(如下图）自动创建好一个helloworld工程
  • quickstart的自动创建工程，是可以无报错直接运行run起来的。
  • 但如果文件夹内有文件，IDE就不会创建任何的初始文件的。

破解IDE

首先，感谢@老郭以迅雷不及掩耳盗铃之神速第一时间破解了微信官方IDE，并且开源提供给大家使用，GitHub weapp-ide crack

因为在早期的版本，微信的IDE，没有AppID的人是无法体验的，必须经过破解，才能开始自己写demo进行练手。而老郭在第一时间破解了IDE，让所有人能从代码上第一时间体验这个神秘的小程序（真机就没办法了）

后来倒逼微信官方，把小程序IDE直接开放，才有了上面提到的无AppID模式。

但是，我使用破解IDE的时候，发现很多人遇到了个问题，按部就班一步一步把IDE破解了，创建新工程的时候，是没有quickstart这一部的，如果什么都不太懂的人做到这一部，一打开工程，一个文件没有直接点运行，直接会报错，什么can not find app.js之类的，context之类的错误，我看到这个后，直接从网上顺手找个demo（就在老郭的git里就有）扔到目录里，就一切运行了。

所以目前我的感受就是，破解倒逼了微信官方开放无AppID体验，简直太威武了，但对于经验尚浅的新手，破解的一大堆东西和步骤，很可能会出现一大堆不知道为啥的错误提示的时候，真的不如直接下最新版IDE，不破解直接无AppID体验。

开动起来

  • 官方文档全在这里 官方文档，里面包含简易教程，框架，组件，API，工具等等

官方文档其实内容真的不多，很多东西写的很浅，光看文档我是觉得很是吃力，因为很多前端开发的概念并不深入，很多标签，css的名字及其陌生，所以辅助上别人的demo食用就很赞了

  • GitLab上面比较丰富的汇总Demo 这里面包括文章，和demo，demo有很多很赞的repo的，我这就只是搬运

    • 微信小应用示例代码(phodal/weapp-quick)
    • 微信小应用地图定位demo(giscafer/wechat-weapp-mapdemo)
    • 微信小应用- 掘金主页信息流(hilongjw/weapp-gold)
    • 微信小程序（应用号）示例：微信小程序豆瓣电影(zce/weapp-demo)
    • 微信小程序-豆瓣电影(hingsir/weapp-douban-film)
    • 小程序 hello world 尝鲜(kunkun12/weapp)
    • 微信小程序版2048小游戏(jeffche/wechat-app-2048)
    • 微信小程序-微票(wangmingjob/weapp-weipiao)
    • 微信小程序购物车DEMO(SeptemberMaples/wechat-weapp-demo)
    • 微信小程序V2EX(jectychen/wechat-v2ex)
    • 微信小程序-知乎日报(myronliu347/wechat-app-zhihudaily)
    • 微信小程序-公众号热门文章信息流(hijiangtao/weapp-newsapp)
    • 微信小程序版Gank客户端(lypeer/wechat-weapp-gank)
    • 微信小程序集成Redux实现的Todo list(charleyw/wechat-weapp-redux-todos)
    • 微信小程序-番茄时钟(kraaas/timer)
    • 微信小程序项目汇总
    • 微信小程序版聊天室(ericzyh/wechat-chat)
    • 微信小程序-HiApp(BelinChung/wxapp-hiapp)
    • 小程序Redux绑定库(charleyw/wechat-weapp-redux)
    • 微信小程序版微信(18380435477/WeApp)

  • 我的Github上面的小程序Demo 这个真的只是demo，是我们业务项目的雏形代码，我文章后面介绍的截图，功能，都不是这个Demo，都是我们的项目代码的

重要的事情说三遍，后面文章的截图不是这个Demo，不是这个Demo，不是这个Demo╮(╯_╰)╭

quickStart 工程文件基础

项目基础文件

  • app.json 这里对小程序所有的页面进行配置，其实详细的大家可以看官方文档，跟你app界面结构相关的就是前三个

    • "pages"字段表示app包含的所有页面，只有在这里注册过的页面才会有效进行编译，如果你的app不包含"tab"字段，那么app的首页就是"pages"数组里面的第一个page
    • "window"字段是处理对于navigationbar的一些样式设置
    • "tabBar"字段如果存在，表示app开启首页面为底部tabbar的形式，这样每个tab所对应的page在"tabBar"字段里设置
    • "networkTimeout","debug"这两个字段一个配置全局网络超时，一个开启debug模式

  • app.wxss 这里其实是全局的CSS，凡是在这里写过的CSS样式，在各自子page里面可以直接使用，写在其他.wxss文件里的样式是不能跨page使用的，可以通过@import进行样式导入，导入别的.wxss文件，但是目前我实践的结果@import只有在主app.wxss里才有效，路径是相对路径

  • app.js 这里就是纯js代码逻辑了，官方的demo里给你展示了一些基本代码，调用了微信的login接口，回调，读取用户头像，读本地存储之类的。并且通过js的一个全局函数getApp()可以获得app.js的这个app对象。

页面文件

如果一个页面起名叫HomePage，那么我们就应该自行手动创建3个文件，文件名一致才会被系统正确的识别

  • HomePage.js 代表着这个页面的业务逻辑，当你在空白js里面输入page的时候会自动出现代码补全，帮你补全了一个page的所有生命周期，onLoad，onHide啥的，其他的js代码提示很不完善╮(╯_╰)╭
  • HomePage.wxss 这里面写这个页面的专属css，别的页面不能使用，只在这个页面下可以用，但是可以被import到app.wxss里面，实现全局通用，并且wxss的代码提示非常完善，很爽，很多文档没写的css表，可以通过ide代码提示+推测标准css3，来知道如何编写
  • HomePage.wxml 这里面写这个页面了，这种WXML语法看起来就很像html，但他还真不是html，html的东西完全不能直接在这里用。你必须用wx提供的wxml相关组件完全重写，条件渲染，循环渲染，数据绑定，都得按着微信的规定来，并且提供了最简单的模板模块功能，实现一定程度的复用。

还可以有个可选的HomePage.json文件，页面也是可以拥有自己的.json文件进行一些专属配置的，但是页面的json可以配置的字段不如app.json多，职能配置关于本window相关的一些表现，比如

{
    "navigationBarBackgroundColor":"#ffffff",
    "navigationBarTextStyle":"black",
    "navigationBarTitleText":"微信接口功能演示",
    "backgroundColor":"#eeeeee",
    "backgroundTextStyle":"light"
}
复制代码

上手开搞

  • 创建一个新目录HomePage，创建好我们页面自己的HomePage至少三个文件
  • HomePage.js里面写page，自动补全好页面生命周期，其余留空
  • 修改app.json里面 “pages”字段，添加进去我们最新的页面路径，并且放到最上面。
  • 直接点编译，你会发现，你的微信小程序已经在模拟器里面运行起来了，没有报错，只是空白一片，什么也没有嘛。

后面开始动手画UI了，这个我没有啥教学的，因为上文提供的github各种demo里面丰富多彩的所有组件用法已经够全的了，我这手把手的教如何写一个按钮，如何写一个text，如何水平排布好几段文字，这就有点太无脑了。我举例几个项目中用到的界面，然后写点我这个小白在趟出这些界面的时候遇到的一些问题点吧

开发小记

小程序的mvvm

小程序天然有一套数据和UI的绑定机制，在js文件里有如下代码，在onload里面发起网络请求，网络请求后回来，handleResponse，再之后setData，可以看到这个data其实就是一个vm

data:{
    originData: {},
    bookList: []
  },
onLoad:function(options){
	var self = this;
	console.log()
	wx.request({
	    url:'xxxxxxxx',
	    header: {
	        'Content-Type': 'application/json'
	    },
	    success: function(res) {
	       if(res.data.status.code == 0){
	          self.handleResponse(res.data.data);
	       }
	    }
	});
	
	console.log('onLoad')
},
handleResponse:function(response){
	console.log(response);
	
	var bookList = response.content.column_data;
	
	this.setData({
	  originData:response,
	  bookList:bookList
	});
},
复制代码

当任何时候在js逻辑里面，修改了data，这样的wxml中，{{bookList}}这种就是告诉负责UI的WXML，这块UI要和bookList这个data里面的一个字段进行绑定，任何时候data发生了变化，这个UI都会根据最新的数据结果刷新

<view wx:for="{{bookList}}" wx:for-item="listBookItem" wx:for-index="rowIndex" class="novelBookContainer">
    <include src="../../component/novelBook/novelBook.wxml"/>
view>
复制代码

小程序的代码复用&模块化

可以看出来，我的2个页面，最重要的就是一个书籍详情Cell，进行复用，避免代码大量的机械性重复。

模块化得从3个层面，js，wxss，wxml来说

  • js的模块化：小程序的js看起来就是最普通的js，似乎看起来是不支持ES6的，因此用传统的module.exports就可以封装js的api模块提供外部使用
  • wxss的样式导入：上文提过，每个page只能认自己page的wxss，和全局的app.wxss，其他的wxss是不支持由别的文件直接引入的，但是可以在全局app.wxss里面使用@import来把别的文件的样式，导入全局，这样各自page都能使用了
  • wxml的模板：官方文档里说支持