干货｜最新最全微信应用号开发教程

法厉无边 2016-11-29

展开全文

之前微信自己和各方频频提起「应用号」，应用号作为继公众号之后的又一大风口，一开始的半年到一年是红利期，抓住了红利期至少少奋斗5年，无论对个人还是企业而言其重要性不言而喻。

9月21日微信悍然发布了微信「小程序」，并且在小范围的邀请内测，为了让更多开发者了解平台新能力进行开发小程序和模拟运行效果，为尚未获得内测邀请的开发者提供如下文档和工具：

1. 小程序开发文档

2. 小程序设计指南

3. 小程序开发者工具

具体文档地址：https://mp.weixin.qq.com/wiki/

张小龙在朋友圈这样说：

“什么是小程序：小程序是一种不需要下载安装即可使用的应用，它实现了应用“触手可及”的梦想，用户扫一扫或者搜一下即可打开应用。也体现了“用完即走”的理念，用户不用关心是否安装太多应用的问题。应用将无处不在，随时可用，但又无需安装卸载。”

这无疑引起各大媒体争相报道，产品开发技术人员也纷纷进行测试模拟运行效果并发表自己的体验的看法。下面小编就根据自身体验并整合博卡君以「名片盒」公众号为材料制作的完整教程发布给大家。

首先在进行小程序开发之前我们需要了解他是怎么运行的，我们就结合微信小程序「官方示例代码」进行相关的讲解。

微信小程序运行机制

解压应用

首先你需要有下面的工具啦

Mac电脑
微信web开发者工具.app
WebStorm / 其他编程器或 IDE，最好可以支持重命名

首先，我们需要右键微信web开发者工具.app，然后显示包的内容，在 Contents/Resources/app.nw下面的内容即是我们的代码，拷贝出来啦：

简单的说明一下：

app/ 目录下放置了app的代码
modified_modules/ 即一些修改后的模块
node_modules/ 地球人都知道
package.json 呵呵，你一定是知道的，配置了NW相关的内容

在modified_modules目录下有两个子模块：

anyproxy，从名字就可以看起来这是一个代理模块
weinre，远程调试工具

IDE

我们已经知道了这是一个NodeWebkit封装的Web应用了。

在package.json中的'main': 'app/html/index.html',，即定义了这个APP的入口是这个index.html，而不是别的文件。

很顺利的我们看到了他们调用的文件了：

这里面有一个init方法，看来他就是NodeWebkit相关的入口了。用WebStorm的shift f6 RENAME 这些变量好十几次，终于看到了下面的代码了：

这是一个React应用，还好我一年多以前学得不错。扫视了一下代码，终于看到了这一句：

直接跳转到ContainController.js，跳转到render方法，找到了这个：

果然Main里面就是大入口了

对应的就是下面这个界面了：

edit 就是编辑器及其相关的事项
detail就是项目的配置

补充一下咯，其中的编辑环境是基于Monaco

WeAPP运行机制

慢慢的就探索到了打包，其运行时的过程。由于我并没有拿到内测资格，所以我只好边看边猜测一下。

在之前的文章中，我们提到了两点很有意思的东西：wxml和wxss，这两个文件会被分别转换，即wxml -> html，wxss -> css。对应的有几个不同的transform:

transWxmlToJs
transWxssToCss
transConfigToPf
transWxmlToHtml
transManager

这里的PF指代的是PageFrame的意思，pageFrame有一个对应的模板文件：

这种风格一看就是生成字符串Replace的，然后他们写了一个名为wcc以及一个名为wcsc的工具。

wcc用于转转wxml中的自定义tag为virtual_dom
wcsc，我观察到的现象是它为转换wxss为css

这样的话，我们就可以理解为微信小应用有点类似于 Virtual Dom WebView，毕竟上面有个WAWebView文件，还有一个webviewSDK文件。

当然无论是React WebView，或者Vue WebView都不重要，现在有了 WA WebView了，哈哈。

WeApp采用的是如下图所示的提交方式，所以：

你在本地写的WeApp都会被提交到微信服务器，然后打包，上传到服务器，交给CDN——毕竟为了分发。

上传的过程大致如下：

APP会被打包成以日期命名 .wx文件
IDE会检测包的大小，并提示：代码包大小为 xx kb，超过限制 xx kb，请删除文件后重试。这个xx好像是1024，所以APP的大小是1M。
APP将会上传到 https:///wxa-dev/commitsource/?appid=xx&user-version=&user-desc=xx

微信小程序开发教程

微信官方也给出了相应的简易教程，但很多细节、代码、功能都没有明确的展示，下面就将博卡君以「名片盒」公众号为材料制作的完整教程发布给大家。

第一章：准备工作

做好准备工作很重要。开发一个微信应用号，你需要提前到微信的官方网站（weixin.qq.com）下载开发者工具。

1. 下载最新微信开发者工具，打开后你会看到该界面：

2. 点击「新建 web 」项目，随后出现如下画面：

3. 该页面内的各项内容需要注意——

AppID：依照官方解释来填。
Appname: 项目最外层文件夹名称，如你将其命名为「ABC」，则之后的全部项目内容均将保存在「/ABC/…」目录下。
本地开发目录：项目存放在本地的目录。

注：再次强调，如果你和团队成员共同开发该项目，则建议你们使用同样的目录名称及本地目录，以确保协同开发的统一性。如果你之前已有项目，则导入过程与以上内容近似，不再赘述。

4. 准备工作全部完成后，点击「新建项目」按钮，弹出框点「确定」。

5. 如上图所示，此刻，微信开发者工具已经为你自动构建了一个初始的 demo 项目，该项目内包含了一个微信应用项目所需具备的基本内容和框架结构。点击项目名称（图中即「cards」）进入该项目，就能看到整个项目的基本架构了：

第二章：项目构架

微信目前用户群体非常庞大，微信推出公众号以后，火爆程度大家都看得到，也同样推动着 Html 5 的高速发展，随着公众号业务的需求越来越复杂，应用号现在的到来也是恰到好处。

博卡君发现，微信提供给开发者的方式也在发生全面的改变：从操作 DOM 转为操作数据，基于微信提供的一个过桥工具实现很多 Html 5 在公众号很难实现的功能，有点类似于 hybrid 开发，不同于 hybrid 开发的方式是：微信开放的接口更为严谨，结构必须采用他提供给的组件，外部的框架和插件都不能在这里使用上，让开发者完全脱离操作 DOM，开发思想转变很大。

工欲善其事，必先利其器。理解它的核心功能非常重要，先了解它的整个运作流程。

生命周期：

在index.js里面：

开发者工具上 Console 可以看到：

在首页 console 可以看出顺序是 App Launch-->App Show-->onLoad-->onShow-->onReady。

首先是整个 app 的启动与显示，app 的启动在 app.js 里面可以配置，其次再进入到各个页面的加载显示等等。

可以想象到这里可以处理很多东西了，如加载框之类的都可以实现等等。

路由：

路由在项目开发中一直是个核心点，在这里其实微信对路由的介绍很少，可见微信在路由方面经过很好的封装，也提供三个跳转方法。

wx.navigateTo(OBJECT)：保留当前页面，跳转到应用内的某个页面，使用wx.navigateBack可以返回到原页面。

wx.redirectTo(OBJECT)：关闭当前页面，跳转到应用内的某个页面。

wx.navigateBack()：关闭当前页面，回退前一页面。

这三个基本上使用足够，在路由方面微信封装的很好，开发者根本不用去配置路由，往往很多框架在路由方面配置很繁琐。

组件：

此次微信在组件提供方面也是非常全面，基本上满足项目需求，故而开发速度非常快，开发前可以认真浏览几次，开发效率会很好。

其它：

任何外部框架以及插件基本上无法使用，就算原生的 js 插件也很难使用，因为以前的 js 插件也基本上全部是一操作 dom 的形式存在，而微信应用号此次的架构是不允许操作任何 dom，就连以前开发者们习惯使用的动态设置的rem.js也是不支持的。

此次微信还提供了 WebSocket，就可以直接利用它做聊天，可以开发的空间非常大。

跟公众号对比博卡君发现，开发应用号组件化，结构化，多样化。新大陆总是充满着惊喜，更多的彩蛋等着大家来发现。

接下来开始搞一些简单的代码了！

1. 找到项目文件夹，导入你的编辑器里面。在这里，博卡君使用了 Sublime Text 编辑器。你可以根据自己的开发习惯选择自己喜欢的编辑器。

2. 接下来，你需要根据自己的项目内容调整项目结构。在范例项目中，「card_course」目录下面主要包含了「tabBar」页面以及该应用的一些配置文件。

3. 示例项目的「tabBar」是五个菜单按钮：

4. 找到「app.json」文件，用来配置这个五个菜单。在代码行中找到「tabBar」：

你可以根据实际项目需求更改，其中：

「Color」是底部字体颜色，「selectedColor」是切换到该页面高亮颜色，「borderStyle」是切换菜单上面的一条线的颜色，「backgroundColor」是底部菜单栏背景颜色。文字描述较为抽象，建议你一一调试并查看其效果，加深印象。
「list」下的代码顺序必须依次放置，不能随便更改。
「pagePath」之后的文件名内，「.wxml」后缀被隐藏起来了，这是微信开发代码中人性化的一点——帮你节约写代码的时间，无须频繁声明文件后缀。
「iconPath」为未获得显示页面的图标路径，这两个路径可以直接是网络图标。
「selectedIconPath」为当前显示页面高亮图标路径，可以去掉，去掉之后会默认显示为「iconPath」的图标。
「Text」为页面标题，也可以去掉，去掉之后纯显示图标，如只去掉其中一个，该位置会被占用。

注意：微信的底部菜单最多支持五栏（五个 icons），所以在你设计微信应用的 UI 和基本架构时就要预先考虑好菜单栏的排布。

5. 根据以上代码规则，博卡君做好了示例项目的基本架构，供你参考：

6. 「Json」文件配置好后，「card_course」的基本结构入上图所示，不需要的子集都可以暂时删除，缺少的子集则需要你主动新建。删除子集时记得顺带检查一下「app.json」里的相关内容是否已经一并删除。

注意：博卡君个人建议你新建一个「wxml」文件的同时，把对应的「js」和「wxss」文件一起新建好，因为微信应用号的配置特点就是解析到一个「wxml」文件时，会同时在同级目录下找到同文件名的「js」和「wxss」文件，所以「js」文件需及时在「app.json」里预先配置好。

编写「wxml」时，根据微信应用号提供的接口编码即可，大部分就是以前的「div」，而现在就用「view」即可。需要用其它子集时，可以根据微信提供的接口酌情选择。

使用「class」名来设置样式，「id」名在这里基本没有什么用处。主要操作数据，不操作「dom」。

7. 以上是示例项目首页的「wxml」编码。从图中就可以看出，实现一个页面代码量非常少。

8. 「Wxss」文件是引入的样式文件，你也可以直接在里面写样式，示例中采用的是引入方式：

9. 修改代码后刷新一次，可以看到未设背景的「view」标签直接变成了粉色。

注意：修改「wxml」和「wxss」下的内容后，直接 F5 刷新就能直接看到效果，修改「js」则需点击重启按钮才能看到效果。

10. 另外，公共样式可以在「app.wxss」里直接引用。

11. 「Js」文件需要在「app.json」文件的「page」里预先配置好。为了项目结构清晰化，博卡君在示例项目中的「index」首页同级目录新建其它四个页面文件，具体如下：

经过以上步骤，案例中的五个底部菜单就全部配置完毕了。

第三章：微信小程序项目结构以及配置

找到创建的 demo 文件夹，把项目导入到你的编辑器，这里使用的是 Sublime Text 编辑器。

这个时候需要根据自己的项目需求结构进行更改了，项目根目录下面是首页渲染的几个 tabBar 页面，以及 app 的一些配置文件，如名片盒项目的 tabBar 是 3 个切换菜单：

我们先找到 app.json 文件打开配置好这几个菜单，配置好 ”tabBar”，这个直接把配置文件改成你自己设计的即可。

App.json 里面有几个配置项：

Pages：这个是编写的 js 文件，后缀 .js 这里不需要使用，配置好正确路径即可正常应用到（应用不到在重启微信开发者工具会直接报 page 错误）。
Window：配置顶部的一些样式，文档介绍比较详细。
tabBar：底部的几项配置，见名知意。
networkTimeout：暂时没发现用处，建议看文档。
根据实际项目需求进行添加与更改。
iconPath 和 selectedIconPath：底部菜单按钮图片与得到切换点击高亮。
'text'：可以去掉，全部去掉会发现底部 tabar 高度会减少很多。

Json 文件配置好后，根据项目进行文件创建，

Demo：存放的是假数据，这一期的开发工具支持 require，假数据使用的是 .js 文件形式，

里面的数据结构 json 一致，把 data 暴露出去即可。

然后取数据 require 进来即可，这一点使用很方便；

Images：图片路径；

Page：除 tabar 以外的页面；

Servise：服务交付层（与后台联调真实数据时使用）；

Wxss：一些公共的 css 文件。

看到这里大家发现每个页面都被连带好三个不同的后缀。分别页面，css，js 目前只能依照这样，是微信应用号的一个规范吧。

Wxss 文件是引入你写的样式文件，也可以直接在里面写样式。

Js 文件需全部配置到 pages 里面才能生效。

第四章：微信小程序首页面开发

进行了各种准备与配置后，来到首页开发。首先需要实现首页效果图如下：

Template 名片很多，需要用模板。

这里需要微信提供的基础组件大致是 input（搜索框）、

action-sheet（右边是个底部下拉菜单，需要下拉菜单）、

Scroll-view (右边 ABC 跳转)、（这个目前实现还有点问题，正在攻克中）。

View 是块元素，整个搜索框的一个样式。

名片夹：由于该项目主打名片功能，故很多地方使用，所以需要把名片以 template 分离出来。
Template：定义一个模板，name 模板的名字其实是个作用域。
Block：循环控制，名片很多，必须用循环出来，和很多操作数据的前端框架循环差不多。
支持自定义属性 data，这里用作判断线上名片以及线下名片。

View 里面是一些数据引入，里面是支持三目运算符。

引入 template 时非常方便，is 和 name 一样，data 是 nameData 传递过来的数据填充。

一切都绑定数据为中心点。

取到数据具体操作根据你数据结构：

这里的数据结构和 json 数据结构一样，

这里如要传到页面的话即是

this.setData({
nameData:card_list_name.data.cards,
timeData:card_list_time.data.cards
});

因为页面遍历的是 nameData,timeData

可以看下打印出来的数据结构，根据你的结构进行解析与传递。

也可以看下这里对数据的一些操作。（这里须根据定义的 json 数据格式来操作的）

名片的样式由于很多页面需要使用放在 common.css 里面，这个 common.css 是所有页面都需要用到，一些初始化设置。它是在 pp.wxss 里面引用之后才能被映射到全局 APP。

搜索框：其中 bindChange 为输入框发生改变事件。微信提供的 bindchange 在支持方面还有小问题，目前是失去焦点才能触发到此事件的发生，待后续完善吧，先实现功能再说。

bindInputChange:function(e){
//发生搜索事情
var self = this; //this绑定，这个this指向微信的提供window
var Text = e.detail.value.toUpperCase();//取到输入的内容
if(Text==''){   //如果输入为空一些东西需要显示否则不显示
show_letter ='block';
}else{
        show_letter= 'none';
}
this.setData({
        show_letter:show_letter,
        showSheet:true
});
var res = nameData;   获取到传递的数据
if(data_type=='name'){
}else if(data_type=='time'){
        res= timeData;
};
for(var k in res){ //for-in循环取到data里面的cards
var data =res[k].cards;
for(var i =0;i<data.length;i ){ //循环取到需要搜索的关键字对比
If(data[i].userName!=null&& data[i].userName.indexOf(Text)!=-1){
data[i]['display']= 'block'; //存在就是赋值显示
}else{
data[i]['display']= 'none'; // 不存在赋值不显示
}
}
}
}

菜单栏：做到菜单栏，使用微信提供的下拉菜单组件 action-sheet，它被触发的条件在这里。

一切以绑定事件为起点：

bindButtonTapSheet:function(e){
//调取底部下拉菜单栏
}

还是得先布好局才能被调动。

Js 配置：

Data 初始化数据：

这里得取非，直接设置 false 调不出来: 调用事件。

调出来还得去掉它啊：如下相同即可

取消直接上事件即可。（分为菜单栏外部与底部）

//好了，就是这么简单。实现效果简单，体验效果确实非常不错。

还需要个 loading 效果（暂时没做动画，后期再考虑。）

Loading 布局

首页的最外层 view

根据微信的生命周期

Onload:function(e){
this.setData({
toastDisplay:”block”,
htmlWrapDisplay:”none”
})
},
onShow:function(e){
this.setData({
toastDisplay:”none”,
htmlWrapDisplay:”block”
})
}

加载条完成。

扫一扫，直接调用拍照功能，从这里看到微信提供的拍照 api 使用起来非常快速，只需根据需求配置即可。

点击扫一扫之后，在开发者工具即可看到如下效果。

做到这里说明下，dom 长度有限制，页面的结构太长，也是无法渲染的，暂且把公司排序暂时先去掉了。

第五章：微信小程序名片夹详情页开发

闲话不多说，先看下详情页的效果图：

备注下大致需求：顶部背后是轮播图，二维码按钮弹出模态框信息、点击微信栏、点击存入手机，地址栏需要地图展示，名片分享也是模态框指引。

首先是轮播图，autoplay 自动播放，interval 轮播的时间，duration 切换速度，可以根据自己需求去添加。

Delete：是删除按钮，加载进来是隐藏的，需用户点轮播图进去后，轮播图全屏显示才出来。
noClickImg 与 ClickImg：切换全屏与非全屏轮播图，绑定了点击事件 changeClick 来切换，只是改变样式即可。
Block：图片列表。
Number_img：当前轮播 index（currentNumber），与图片 length 集合（cardnum）。

其中 currentNumber：

//轮播图发生改变时改变数字
//初始化数据
Data:{
currentNumber:1
}
slidechange:function(e){
var number = e.detail.current;
this.setData({
currentNumber:number 1
})
},

这里可以看到全屏状态下当关闭按钮被点击后 getBackStyle，把 changeClick 切换到 imgFullScrenn 待命。

再次点击返回原样式，

切换后事件又走回到 getBackStyle 了，灵活运用。

刷新下开发者工具可以看到具体效果如下：

详情页可以看到信息基本都是样式一样，可以使用微信提供的循环 block。

下面是详情页里面的个人信息数据，

如果有信息就显示出来，没有数据的不显示，这里使用

//中文信息
var chinaMessage = res.card.groups[0].fields;
var personMessage= []
for(var i = 0;i<chinaMessage.length;i ){
personMessage.push(chinaMessage[i])

}
//为空或者null是不显示判断
for(var k in personMessage){
if(personMessage[k].value==null || personMessage[k].value==''){
personMessage[k]['display'] = 'none';
}else{
personMessage[k]['display'] = 'block';
}
}