01.微信小程序开发之环境搭建

在开发之前你要有微信开发者工具，下载地址：https://mp.weixin.qq.com/debug/wxadoc/dev/devtools/download.html

这里我要假设大家有已经拿到了内侧或者公测的资格，因为没有拿到的话下面的步骤是没法进行的。

打开以后你会看到这样的界面，我们选择小程序进入

这时候就可以创建项目了

填写你拿到的appid，和自己的项目名称以及目录，然后就可以打开自己的项目了。界面如下：

左侧菜单栏就不说了，中间是编译后的预览界面，新的开发者工具已经可以做到实时更新，不需要每次都去点编译了。

右侧是你的项目目录，其中pages就是你的页面结构目录了，每个页面下面必须要有 js，wxml，wxss这三个文件，缺少任何一个的话都无法上传预览。

然后就是那个当前态的app.json文件，app.json 是对整个小程序的全局配置。我们可以在这个文件中配置小程序是由哪些页面组成，配置小程序的窗口背景色，配置导航条样式，配置默认标题。注意该文件不可添加任何注释。，我们简单的配置一下：

这里比较好的一点是，navigationbar的背景颜色支持自定义任意颜色了，不再有只能黑白透明的限制，还是很不错的。

然后我们在页面p里简单的写个Hello World

保存以后预览界面已经立即刷新出来

如果想真机测试（个人建议一定要真机测试，特别是给上下游预览的时候，pc上的样式还原程度较差，包括字体等等，毕竟系统不同。），只需要选中项目选项

然后在界面上点击预览

下面的三个选项都比较实用，可以根据需要点选。然后就会弹出可以用注册过的微信号真机预览的二维码，如图：

这样一个简单的小程序demo就完全跑通了。

上面和配置文件app.json平级的还有一个app.js文件，是小程序的脚本代码。我们可以在这个文件中监听并处理小程序的生命周期函数、声明全局变量，在每个page目录里的js做当前页面的业务操作。但是小程序的页面的脚本逻辑是在JsCore中运行，JsCore是一个没有窗口对象的环境，所以不能在脚本中使用window，也无法在脚本中操作组件，所以我们常用的zepto/jquery 等类库也是无法使用的。

另一个app.wxss文件，这个是全局的样式，所有的页面都会调用到，每个项目目录下面的wxss是局部样式文件，不会和其他目录产生污染，可以放心使用样式名。

他提供的WXSS(WeiXin Style Sheets)是一套样式语言，具有 CSS 大部分特性，可以看作一套简化版的css。
同时为了更适合开发微信小程序，还对 CSS 进行了扩充以及修改，直接帮我们把适配的一部分工作都做了，比如他的rpx（responsive pixel），可以根据屏幕宽度进行自适应，规定屏幕宽为750rpx。如在 iPhone6 上，屏幕宽度为375px，共有750个物理像素，则750rpx = 375px = 750物理像素，1rpx = 0.5px = 1物理像素。

这个很赞，很方便。你可以简单的理解为就是你平时按照750设计稿开发的流程，只不过你不需要再去做rem的转换和适配工作了，所以小程序的视觉稿，最好也是按照750来出。

但是！在不同的屏幕上多多少少会有一些差异，只能根据大家的经验去规避和解决，通过媒体查询也好，还是其他方法也好。

而且，在wxss里不能引用本地资源，说起来这个坑，满眼都是泪。那天晚上写小程序demo的时候，没有仔细的去查去问，自己闷头边写边预览，突然真机预览就不行了，毫无预兆，我也完全不会想到是一个背景图造成的问题，折腾了大半夜终于知道了问题所在，于是很开心的把图片都转换成base64，心里想着这下没问题了吧？结果预览上传又失败了，继续折腾了下半夜，才知道小程序对整个包的大小有严格要求，不可以超过1M，最后把所有的静态资源都放到了腾讯云的cdn，才算解决了这个问题。所以如果你要写背景图，那么需要引用一个线上的图片在这里极不推荐使用base64！极不推荐使用base64！极不推荐使用base64！

另外一个应用同时只能打开5个页面，当已经打开了5个页面之后，wx.navigateTo不能正常打开新页面。请避免多层级的交互方式。

在开发的过程中也不可避免的遇到了一些小坑，举个例子，比如一个简单的switch控件，你可以通过查看元素的方式轻易得知他的自身样式

那么我要做一个简单的和文本垂直剧中对齐，从以往的css经验，只要vertical-align: middle就可以轻松解决了，在本地预览的时候也是这样好好的

可是在真机测试的时候，各种设备就开始出现偏差了

然后简单的审查元素之后发现问题在于

这个控件是存在空白区域的，根据设备，屏幕大小的不一，空白区域大小也不一致。

受于时间紧迫，可翻阅文档有限，感觉是因为默认的行高原因，于是我只好发挥老司机的狡猾本质，可以通过行高或者overflow的控制，干掉多余的部分，最终真机界面显示还算统一

如果你要按照像素级别设计稿来做小程序开发的话，控件的小差异还是需要自己来做一些控制（也有可能从根本上就是我个人用错了方法或者理解错了，鉴于文档太少，以后开发者多了大家会有更清晰的认识。）

还有另一个遇到的问题，就是小程序对 image 的默认渲染，这是通过工具查看默认图像的样式

经过多方打听发现小程序的image是按照background-image来实现的，所以所有图像会得到一个初始宽高320 240，而且无法通过auto重置，只可以通过具体的值来重写。

好在微信提供了3种缩放模式，9种裁剪模式，在大多数场景可以满足我们对图片的控制：

例如原图：

scaleToFill 模式
不保持纵横比缩放图片，使图片完全适应

aspectFit
保持纵横比缩放图片，使图片的长边能完全显示出来

aspectFill
保持纵横比缩放图片，只保证图片的短边能完全显示出来

top
不缩放图片，只显示图片的顶部区域

bottom
不缩放图片，只显示图片的底部区域

center
不缩放图片，只显示图片的中间区域

left
不缩放图片，只显示图片的左边区域

right
不缩放图片，只显示图片的右边边区域

top left
不缩放图片，只显示图片的左上边区域

top right
不缩放图片，只显示图片的右上边区域

bottom left
不缩放图片，只显示图片的左下边区域

bottom right
不缩放图片，只显示图片的右下边区域

如果你有更严格的图片设计展示方式，那么可以尝试用一些特殊的方式去控制图像的宽高吧。

还有小程序的button控件：

他的初始样式里并没有border，所以我费尽心思也没能把他重写为一个无边无背景的设计形式，最终为了满足设计稿，个别语义化为按钮的元素，我是用其他更可控的元素来实现的，比如这个界面的发送图片按钮：

但是到后来才知道button是通过after来写的样式，开发者工具的调试里完全看不到这个after(┬＿┬)…..

除了这些UI开发上的体会，大家也都知道，小程序诞生就不是为了展示，他不适合做纯展示型的东西，主要是做一些功能型的应用。

而微信所提供的小程序现有的SDK和DEMO,缺乏对服务端的支持，依赖开发者逐个模块搭建服务；而且必须通过HTTPS完成与服务端通信，依赖开发者自行完成证书申请部署；鉴权流程安全性要求高，开发者高效安全的完成会话管理难度会比较大；提供了WebSocket长连接通信的客户端API，但缺乏服务端配套支持，开发者自行实现难度还是较大的。并且具备快速传播，流量突增的特点，要求架构具备弹性伸缩能力。

这些都是微信方面所没有提供的，需要自己来处理，这里可以推荐一下这套解决方案 https://github.com/tencentyun/weapp-client-demo（避免广告嫌疑，发github连接 o(∩_∩)o ），很完善的解决了以上问题。当然你也可以根据自己的需求去用不同的方案。

除了一站式的解决方案，还针对不同的场景做了更细致的demo

1. 会话管理demo

微信小程序框架提供了wxml/wxss/js api便于开发者快速创建小程序。但微信小程序本质上与web开发模式存在区别，尤其是微信小程序采用程序包上传的方式提交，微信加载程序包到本地，使用时微信直接从本地启动小程序，运行模式与web模式大不相同，小程序使用框架提供的wx.request接口发送https请求不会携带cookie信息，传统webserver的会话管理能力(session)在微信小程序无法直接使用，在这点上微信小程序更像CS架构的开发模式，开发者需要自己实现会话管理功能。

查看教程：https://www.qcloud.com/doc/product/448/6424
下载源码：https://github.com/CFETeam/weapp-demo-session

2. 上传下载demo

微信小程序框架提供了文件上传下载的接口，用于将本地资源上传到指定的服务器，或者将指定Url的资源下载到本地。但微信小程序框架只提供了客户端的解决方案，缺少服务端的对应实现，这里通过一个小相册来实现这个demo

查看教程：https://www.qcloud.com/doc/product/448/6404
下载源码：https://github.com/CFETeam/weapp-demo-album

3. WebSocket长连接

微信小程序框架提供了WebSocket请求建立、数据通信、连接关闭等一系列客户端接口，用于与远程支持WebSocket协议的服务器通信，以便小程序能实现服务器主动push等更接近native的体验。但微信只提供了客户端的解决方案，缺少服务端的对应实现。这里通过一个剪刀石头布小游戏的demo来实现

查看教程：https://www.qcloud.com/doc/product/448/6405
下载源码：https://github.com/CFETeam/weapp-demo-websocket

4. 视频应用 Demo

微信小程序框架具备丰富的wxml/wxss/js api以及配套的文档帮助开发者快速地搭建时下热门的视频类应用。但微信只提供了客户端的解决方案，缺少服务端的对应实现，尤其是流媒体转码集群和流媒体播放服务集群。这个实例里有具体的实现

查看教程：https://www.qcloud.com/doc/product/448/6425
下载源码：https://github.com/CFETeam/weapp-demo-video

碍于篇幅和时间，就先对小程序做一些简单的认识以及一些粗略的开发体验，有些点可能不一定对，毕竟也是刚开始接触学习，只是有的分享就尽量分享吧，这是我一贯的想法，希望和大家一起学习进步！

wx-gesture-lock  微信小程序的手势密码

WXCustomSwitch 微信小程序自定义 Switch 组件模板

WeixinAppBdNovel 微信小程序demo：百度小说搜索

shitoujiandaobu 小程序：石头剪刀布（附代码说明）

audiodemo 微信小程序开发之视频播放器 Video 弹幕 弹幕颜色自定义

star 微信小程序开发之五星评分

switchCity 微信小程序开发之城市选择器 城市切换

huadong_del  微信小程序滑动删除效果

jianhang_menu 微信小程序开发之圆形菜单 仿建行圆形菜单

xiaoxiaoxiao_lazyload  实现微信小程序图片懒加载特效

kangaiduowei  微信小程序：康爱多微商城：学习界面设计

tianmao_dazhuanpan  小程序实现大转盘 仿天猫抽奖 跑马灯效果（有图有源码）

weapp-meirong  微信小程序学习用demo推荐：美容商城；列表，预约

baisi  微信小程序仿百思不得姐

weapp-one 仿 「ONE · 一个」 的微信小程序

netmusic-app  仿网易云音乐APP的微信小程序

a_takeaway  微信小程序的外卖demo

sideslip  微信小程序『侧边栏滑动』特效

wx_plo  微信小程序之仿微信漂流瓶

kwonWhere 微信小程序-知亦行

audiodemo  微信小程序开发之视频播放 弹幕 弹幕颜色自定义

wxChart  微信小程序图标插件

guoku  微信小程序-果库

snake  微信小程序-贪吃蛇小程序

douban_movie  微信小程序-仿豆瓣电影

RecordDemo  麦克风动画

shishanggou  实现了包括常用组件，ajax获取数据，模板使用，路由等的使用，下拉刷新数据；

jiajuzaixian  家具在线-演示如何使用下拉选项

wechat-app-ipinbb  爱拼宝宝-功能非常全的电商应用

TodayNews-wx  微信小程序-今日头条

WXNative-bpgg  奔跑果果-微信小程序

wechatapp-demo   是目前我发现的，实现实用功能较多的demo，推荐大家学习研究

weapp-MatterAssistant  微信小程序－事项助手

weapp-wymusic  微信小程序 仿网易云音乐

weapp-wechat-nearby  微信小程序-仿找事吧app附近三公里

bs  精简版百思不得姐

WXBaiSi  微信小程序版 百思不得姐

weapp-demo-breadtrip  基于面包旅行 API 制作的微信小程序示例

html-to-wxml  小程序中将html内容转化成wxml可以显示的内容，方便用于小程序中显示

kachezhijia  自卡车之家，有丰富的卡车司机和物流园区的资源，所以这个小程序可以说也是他们未来工作上的一个必将实施的项目。

WxEmojiView   微信小程序Emoji展示输入组件alpha 0.1

GankCamp-WechatAPP gank.io (干货集中营) 微信小程序 版本

wechat-JD  微信小程序仿京东首页

wechat-turntalbe-canvas  用微信小程序开发的Canvas绘制可配置的转盘抽奖。

mangguoTv  微信小应用-小程序-demo-仿芒果TV

wxreading  微信小程序跟读

WeChatMeiZhi  微信小程序版妹纸图 API from gank.io

CountDown  微信小程序倒计时组件

weapp-github  微信小程序--github

wechat-weapp-mapdemo  微信小程序开发demo-地图定位，非常简单的demo，只为了解一下微信小程序

wechat-cnode  微信小程序 cnode社区版

weapp-newsapp  微信小程序-公众号热门文章信息流

wechat-weapp-taobao  微信小程序demo 仿手机淘宝

timer  番茄时钟微信小程序版

wechat-app-music  微信小程序：音乐播放器 技术栈: redux + es7 +labrador

fenda-mock  使用微信小程序实现「分答」这款APP的基础功能

Wa-UI  针对微信小程序整合的一套UI库

wx-query  微信小程序 仿jQuery插件

weapp-artand  微信小程序 Artand

WeiXin-SmallApps-Information  微信小程序-仿今日头条

weapp-wechat-zhihu  微信中的知乎--微信小程序

WeApp  基于微信小程序开发的仿微信demo

SmallApp  微信小程序

wechat-v2ex 微信小程序-v2ex

weipiao 微信小程序-微票

DouBanBookApp   微信小程序之小豆瓣图书

wxapp-calc 一个简单的微信小程序-简易计算器

weapp-wechat-zhihu   模仿知乎的小程序

wx-movies-demo   小程序--影讯

caiquan  微信小应用，猜拳小游戏

hayeah-wxapp-Breakfast  小林早厨微信小程序

AppleMusic  微信小程序，仿Apple Music

cnode_wechat-webapp 用cnode社区api做的微信小应用

shoppingcar 一个点餐、购物的购物车效果

wechat-weapp-mall 微信小程序实现移动端商城

SmallAppForQQ  高仿手机QQ应用程序

zhihudaily  微信小程序-知乎日报

wechat-weapp-gank 微信小程序-干货投稿应用

TeamToy  调用TeamToy API 的微信小程序 Demo

douban 微信小程序（应用号）示例教程（豆瓣电影）