MZTools小程序
参考
微信小程序开发文档(官方)
微信小程序开发文档(W3Cschool)
引言
概述
微信之父张小龙是这样描述小程序的: 小程序是一个不需要下载安装就可使 用的应用,它实现了应用触手可及的梦想, 用户扫一扫或者搜一下即可打开应用。 也体现了用完即走的理念, 用户不用关心是否安装太多应用的问题。 应用将无处 不在,随时可用,但又无需安装卸载。非常便捷。
微信小程序优势 1. 小——安装包小于 2M。 2. 快——用户体验更快,无需开启、登录、注册、认证等。 3. 成本低——研发维护成本更低 单一平台。 4. 微信用户体系大——日活跃用户达 8.99 亿。 5. 场景化快速应用。 6. 与公众号强强关联互动,形成内部自我闭环的小生态圈。 7. 支付方便—无需外接支付接口。
a. 小程序覆盖范围广,可以跨平台访问;同时能够快速的访问以便带来更 好的体验;亲场景亲服务,为线下服务提供了支持。 b. 灵活性强。由于微信客户可以在微信聊天中进入小程序,也可以在小程 序里随时切换回聊天,灵活快捷。当服务融入生活,场景被切换的足够 小足够轻的时候,小程序绝对是你触达最深,服务用户最好的工具。 c. 推广速度快。小程序通过聊天界面可以直接分享,也可以在线下投放二 维码进行推广,十分便捷有效。 d. 小程序与公众号等的结合。小程序与公众号之间存在着多重跳转关系, 可以形成一个紧密的联系,有利于扩大企业品牌影响力。 e. 轻应用。一般我们手机上都有很多高频使用的各种 APP,小程序的出现 大大的缓解了这一压力,很多高频使用的 APP都不在需要,无论对商家 或是用户都很方便。
本设计的任务和主要功能
使生活更便捷,提高生活办公的效率。主要有时间打卡天气预报、地图、进制转换、手电筒、扫码等功能。
开发环境的安装和配置
开发包及其工具介绍
微信小程序开发工具v1.0.0
为了帮助开发者简单和高效地开发和调试微信小程序,在原有的公众号网页调试工具的基础上,推出了全新的 微信开发者工具,集成了公众号网页调试和小程序调试两种开发模式。
使用公众号网页调试,开发者可以调试微信网页授权和微信JS-SDK 详情。
使用小程序调试,开发者可以完成小程序的 API 和页面的开发调试、代码查看和编辑、小程序预览和发布等功能。
为了更好的开发体验,从视觉、交互、性能等方面对开发者工具进行升级,推出了 1.0.0 版本。
微信小程序开发助手
“小程序开发助手” 是微信公众平台发布的官方小程序,帮助开发和运营人员在手机端更方便快捷地查看和预览小程序,扫描下面小程序码可立即体验。

使用者可以在小程序开发助手查看和预览与自己关联的所有小程序。小程序将会按照其更新时间自动排序,显示在最上面的小程序是最近有提交的小程序,例如开发者预览了新的代码,或者体验版有更新。
通过点击并展开小程序列表,使用者可以根据自己的身份,浏览到小程序的线上版本、体验版本或开发版本。如果使用者是小程序的管理者,可以浏览到全部三种版本;如果使用者身份是 “体验者”,则可以浏览到线上版本、体验版本,而不会浏览到任何开发版本。
如果一个小程序有多个开发者,则开发版本的列表将会显示每一个开发者提交预览的最新版本。
开发平台搭建步骤
https://developers.weixin.qq.com/miniprogram/dev/devtools/download.html下载小程序开发工具最新版本,安装使用。
程序逻辑架构
程序结构图
程序结构图如图3-1。


图3-1 程序工程结构图
工程文件介绍
JSON 配置
项目的根目录有一个 app.json 和 project.config.json,此外在 pages/logs 目录下还有一个 logs.json。
小程序配置 app.json
app.json 是当前小程序的全局配置,包括了小程序的所有页面路径、界面表现、网络超时时间、底部 tab 等。QuickStart 项目里边的 app.json 配置内容如下:1
2
3
4
5
6
7
8
9
10
11
12{
"pages":[
"pages/index/index",
"pages/logs/logs"
],
"window":{
"backgroundTextStyle":"light",
"navigationBarBackgroundColor": "#fff",
"navigationBarTitleText": "WeChat",
"navigationBarTextStyle":"black"
}
}
配置各个项的含义:
- pages字段 —— 用于描述当前小程序所有页面路径,这是为了让微信客户端知道当前你的小程序页面定义在哪个目录。
- window字段 —— 定义小程序所有页面的顶部背景颜色,文字颜色定义等。
工具配置 project.config.json
通常大家在使用一个工具的时候,都会针对各自喜好做一些个性化配置,例如界面颜色、编译配置等等,当你换了另外一台电脑重新安装工具的时候,你还要重新配置。
考虑到这点,小程序开发者工具在每个项目的根目录都会生成一个 project.config.json,你在工具上做的任何配置都会写入到这个文件,当你重新安装工具或者换电脑工作时,你只要载入同一个项目的代码包,开发者工具就自动会帮你恢复到当时你开发项目时的个性化配置,其中会包括编辑器的颜色、代码上传时自动压缩等等一系列选项。
页面配置 page.json
这里的 page.json 其实用来表示 pages/logs 目录下的 logs.json 这类和小程序页面相关的配置。
如果整个小程序的风格是蓝色调,那么你可以在 app.json 里边声明顶部颜色是蓝色即可。实际情况可能不是这样,可能你小程序里边的每个页面都有不一样的色调来区分不同功能模块,因此我们提供了 page.json,让开发者可以独立定义每个页面的一些属性,例如刚刚说的顶部颜色、是否允许下拉刷新等等。
WXML 模板
从事过网页编程的人知道,网页编程采用的是 HTML+CSS+JS 这样的组合,其中 HTML 是用来描述当前这个页面的结构,CSS 用来描述页面的样子,JS 通常是用来处理这个页面和用户的交互。
同样道理,在小程序中也有同样的角色,其中 WXML 充当的就是类似 HTML 的角色。打开 pages/index/index.wxml,你会看到以下的内容:1
2
3
4
5
6
7
8
9
10
11
12<view class="container">
<view class="userinfo">
<button wx:if="{{!hasUserInfo && canIUse}}"> 获取头像昵称 </button>
<block wx:else>
<image src="{{userInfo.avatarUrl}}" background-size="cover"></image>
<text class="userinfo-nickname">{{userInfo.nickName}}</text>
</block>
</view>
<view class="usermotto">
<text class="user-motto">{{motto}}</text>
</view>
</view>
和 HTML 非常相似,WXML 由标签、属性等等构成。但是也有很多不一样的地方,我们来一一阐述一下:
- 1、标签名字有点不一样
往往写 HTML 的时候,经常会用到的标签是 div, p, span,开发者在写一个页面的时候可以根据这些基础的标签组合出不一样的组件,例如日历、弹窗等等。换个思路,既然大家都需要这些组件,为什么我们不能把这些常用的组件包装起来,大大提高我们的开发效率。
从上边的例子可以看到,小程序的 WXML 用的标签是 view, button, text 等等,这些标签就是小程序给开发者包装好的基本能力,我们还提供了地图、视频、音频等等组件能力。
- 2、多了一些
wx:if
这样的属性以及{\{ }}
这样的表达式
在网页的一般开发流程中,我们通常会通过 JS 操作 DOM (对应 HTML 的描述产生的树),以引起界面的一些变化响应用户的行为。例如,用户点击某个按钮的时候,JS 会记录一些状态到 JS 变量里边,同时通过 DOM API 操控 DOM 的属性或者行为,进而引起界面一些变化。当项目越来越大的时候,你的代码会充斥着非常多的界面交互逻辑和程序的各种状态变量,显然这不是一个很好的开发模式,因此就有了 MVVM 的开发模式(例如 React, Vue),提倡把渲染和逻辑分离。简单来说就是不要再让 JS 直接操控 DOM,JS 只需要管理状态即可,然后再通过一种模板语法来描述状态和界面结构的关系即可。
小程序的框架也是用到了这个思路,如果你需要把一个 Hello World 的字符串显示在界面上。
WXML 是这么写 :<text>{\{msg}}</text>
JS 只需要管理状态即可:this.setData({ msg: "Hello World" })
通过{\{ }}
的语法把一个变量绑定到界面上,我们称为数据绑定。仅仅通过数据绑定还不够完整的描述状态和界面的关系,还需要 if/else, for等控制能力,在小程序里边,这些控制能力都用 wx: 开头的属性来表达。
WXSS 样式
WXSS 具有 CSS 大部分的特性,小程序在 WXSS 也做了一些扩充和修改。
1、新增了尺寸单位。在写 CSS 样式时,开发者需要考虑到手机设备的屏幕会有不同的宽度和设备像素比,采用一些技巧来换算一些像素单位。WXSS 在底层支持新的尺寸单位 rpx ,开发者可以免去换算的烦恼,只要交给小程序底层来换算即可,由于换算采用的浮点数运算,所以运算结果会和预期结果有一点点偏差。
2、提供了全局的样式和局部样式。和前边 app.json, page.json 的概念相同,你可以写一个 app.wxss 作为全局样式,会作用于当前小程序的所有页面,局部页面样式 page.wxss 仅对当前页面生效。
3、此外 WXSS 仅支持部分 CSS 选择器。
JS 交互逻辑
一个服务仅仅只有界面展示是不够的,还需要和用户做交互:响应用户的点击、获取用户的位置等等。在小程序里边,我们就通过编写 JS 脚本文件来处理用户的操作。1
2<view>{{ msg }}</view>
<button bindtap="clickMe">点击我</button>
点击 button 按钮的时候,我们希望把界面上 msg 显示成 “Hello World”,于是我们在 button 上声明一个属性: bindtap ,在 JS 文件里边声明了 clickMe 方法来响应这次点击操作:1
2
3
4
5Page({
clickMe: function() {
this.setData({ msg: "Hello World" })
}
})
此外你还可以在 JS 中调用小程序提供的丰富的 API,利用这些 API 可以很方便的调起微信提供的能力,例如获取用户信息、本地存储、微信支付等。在前边的 QuickStart 例子中,在 pages/index/index.js 就调用了 wx.getUserInfo 获取微信用户的头像和昵称,最后通过 setData 把获取到的信息显示到界面上。
程序设计
主界面的设计
应用界面

图4-1 应用界面
信息界面

图4-2 登陆及信息界面
关键代码讲解
小程序构架配置
1 | { |
pages声明页面信息,windows声明小程序整体UI风格,tabBar声明底部切换标签。
时间打卡
1 | //获取应用实例 |
天气预报
1 | var bmap = require('../../utils/bmap-wx.min.js'); |
调用百度地图API的天气接口获取天气数据存入数组,在WXML中绑定数据显示。
地图
1 | var QQMapWX = require('../../utils/qqmap-wx-jssdk.min.js'); |
调用腾讯地图API获取当前位置经纬度信息及周边信息,在WXML页绑定数据进行动态更新。搜索框调用小程序自带地图进行搜索定位。
进制转换
1 | var vB = ''; |
用parseInt()函数将输入的各数据转换为10进制,再用toString()函数转换为其它各进制显示,理论支持2-32进制所有的进制转换。
手电筒
1 | var bgColor = 'black'; |
调用wx.setScreenBrightness()接口设置屏幕亮度及动态变换屏幕背景色实现手电筒功能,由于小程序官方不支持直接打开后置闪光灯,暂时只提供屏幕手电筒功能。
扫码
1 | Page({ |
调用wx.scanCode()接口实现扫码功能。
程序测试
真机体验可在微信搜索“MZTools”或关注公众号“MengZeATY”进入小程序菜单或微信扫描下方二维码。

图5-1 MZTools小程序码
时间打卡


天气预报

图5-2 天气预报测试

图5-3 天气预报接口返回数据包
地图

图5-4 地图测试

图5-5 地图搜索界面
图5-6 地图接口返回数据包

图5-7 地图搜索测试

图5-8 地图周边界面
进制转换

图5-9 进制转换测试
手电筒

图5-10 手电筒关闭状态

图5-11 手电筒开启状态
扫码

图5-12 扫码返回结果

小结
MZTools工具集v2.20版本计划功能已全部实现,除地图周边显示外,其他功能均已达到预期要求,更加熟悉了小程序的一些常用组件及小程序官方API的使用技巧,同时加深了对WEB前端的理解和应用。
更多更完善的功能将在MZTools的v3.0版本推出,计划新增微信运动、罗盘指南针、单位转换、科学计算器、图音视媒体文件的支持开发等功能。
参考文献
[1] Tencent,小程序开发者社区[DB/OL],https://developers.weixin.qq.com,2018.10.15
[2] Tencent,小程序开发者文档[EB/OL] ,https://developers.weixin.qq.com/miniprogram/dev/index.html?t=18101612,2018.10.15