实战：从零开始制作一个跑步微信小程序

admin

一、准备工作

首先注册一个小程序账号，得用一个没注册过公众号的邮箱注册。

注册过程中需要很多认证，比较繁琐。如果暂时只是开发测试，不进行提审、发布的话，只要完成营业执照号的填写就可以了，不需要完成微信认证。

注册完账号，并使用该帐号进行登录。

在主页面左边列表中点击设置，然后在设置页面中选开发设置，就可以看到AppID，用于登录开发工具。

主页面

设置页面

二、开发工具

可以到官网下载开发工具。

开发工具

开发工具编辑页面

三、开始项目

打开开发者工具，选择小程序选项，到达“添加项目”页面。

“添加项目”页面

这个时候将前面设置页面中的AppID填写此处。

如果项目目录中的文件是个空文件夹，会提示是否创建quick start 项目。

选择“是”，开发者工具会帮助我们在开发目录里生成一个简单的 Demo。

这个Demo拥有一个完整的小程序的大概框架。

框架

先看下一目录：

文件目录

• app.js: 小程序逻辑，生命周期，全局变量。
• app.json: 小程序公共设置，导航栏颜色等，不可以注释。
• app.wxss :小程序公共样式，类CSS。
  

小程序页面构成：

页面构成

每一个小程序页面是由同路径下同名的四个不同后缀文件的组成，如：index.js、index.wxml、index.wxss、index.json。

各文件介绍

微信小程序中的每一个页面的“路径+页面名”都需要写在 app.json 的 pages 中，且 pages 中的第一个页面是小程序的首页。

路径

这四个文件按照功能可以分成三个部分：

配置：json 文件。
逻辑层：js文件。
视图层：wxss.wxml文件。

在 iOS 上，小程序的 JavaScript 代码是运行在 JavaScriptCore 中。在 Android 上，小程序的 JavaScript 代码是通过 X5 内核来解析。

在开发工具上，小程序的 JavaScript 代码是运行在 NW.js（Chrome内核） 中。所以开发工具上的效果跟实际效果有所出入。

组件

微信提供了许多组件，主要分为八种:

• 视图容器
• 基础内容
• 表单组件
• 操作反馈
• 导航
• 媒体组件
• 地图
• 画布
  

包含view、scroll-view、button、form等普通常用的组件，也提供了地图map、画布canvas。

组件主要属于视图层，通过wxml来进行结构布局，类似于html。通过wxss修改样式，类似于css。

组件使用语法实例：

<!--普通视图--><view>这是一个普通视图</view><!--wxss样式修改--><view clas="mainView">样式修改过的视图</view>

更多的组件以及相关使用方法可以到官方文档-组件查看。

API

小程序中，大致提供以下几个部分的 API 接口：

• 网络
• 媒体
• 数据
• 位置
• 设备
• 界面
• 开发接口
  

其中网络请求的使用必须先到公众平台登录小程序账号，在设置页面那里，设置允许访问的域名，网络请求包含了普通的HTTP请求、支持上传、下载、Socket。基本上满足了我们开发中所需要的网络需求。

这些API属于逻辑层，写在JavaScript文件中。

使用实例:

wx.getLocation({   type: 'wgs84',   success: function(res) {       var latitude = res.latitude        var longitude = res.longitude        var speed = res.speed        var accuracy = res.accuracy }})

可以到官方文档-API查看其它API的使用方法。

编译运行

1.模拟器

可以在模拟器上看效果，上面提到了小程序的运行底层不同，效果在手机上运行也会有些差异。

模拟器

2.真机

在左边的选项栏中，选择项目，然后点预览会生产一个二维码，用管理员微信号扫一扫,就可以在真机上看实际效果。本例中，真机测试则扫描下面二维码。

实践：跑步小程序

真机运行截图（运行于iPhone7，微信版本：6.3.30）：

功能：能够计算里程、时间、实时获取跑步路径（有些粗糙）。

思路：主要使用了微信小程序的获取位置接口APIwx.getLocation()和地图组件map。

首先实现一个计时器进行计时，通过wx.getLocation()获取坐标，把获取到的坐标存在一个数组中，通过坐标每隔一段时间获取里程，进行累加得到总里程，同时也通过坐标点进行连线。

存在的问题：

• 因为目前找不到在地图上画连线的方法，所以采用了在地图上贴小红点图的方法显示大概跑步路径，路径比较粗糙。
• 虽然采用了API里面的火星坐标gcj02类型，但是获取的坐标跟国际坐标差不多，依然存在着偏差。
  

核心代码：

我把全部代码放在github上：weChatApp-Run，可以下载来看看或者先star收藏，我以后还会进行一些优化更新。现在只是一个学习Demo，大家沟通学习，实际应用还需更多优化。

wxml文件布局代码：

1. <view class="head" style="flex-direction:row;">
   
2.     <image class="icon" src="/resources/joyrun.png" mode="aspectFill"/>
   
3.     <button bindtap="openLocation">打开位置</button>
   
4.     <button bindtap="starRun">开始跑步</button>
   
5.     <button bindtap="stopRun">暂停跑步</button>
   
6.     <text>\\n里程数：{{meters}}km</text>
   
7.     <text>\\n\\n时间：{{time}}</text>
   
8. </view>
   
9. 
   
10. <view class="mainView">
    
11.    <map
    
12.         class="mapView"
    
13.         style="width: 100%; height: 375px;"
    
14.         latitude="{{latitude}}"
    
15.         longitude="{{longitude}}"
    
16.         markers="{{markers}}"
    
17.         covers="{{covers}}"
    
18.         >
    
19.     </map>
    
20. 
    
21. </view>

复制代码

JavaScript文件逻辑代码：

1. var countTooGetLocation = 0;
   
2. var total_micro_second = 0;
   
3. var starRun = 0;
   
4. var totalSecond  = 0;
   
5. var oriMeters = 0.0;
   
6. /* 毫秒级倒计时 */
   
7. function count_down(that) {
   
8. 
   
9.     if (starRun == 0) {
   
10.       return;
    
11.     }
    
12. 
    
13.     if (countTooGetLocation >= 100) {
    
14.       var time = date_format(total_micro_second);
    
15.       that.updateTime(time);
    
16.     }
    
17. 
    
18.       if (countTooGetLocation >= 5000) { //1000为1s
    
19.         that.getLocation();
    
20.         countTooGetLocation = 0;
    
21.       }   
    
22. 
    
23. 
    
24. setTimeout
    
25.       setTimeout(function(){
    
26.         countTooGetLocation += 10;
    
27.     total_micro_second += 10;
    
28.         count_down(that);
    
29.     }
    
30.     ,10
    
31.     )
    
32. }
    
33. 
    
34. 
    
35. // 时间格式化输出，如03:25:19 86。每10ms都会调用一次
    
36. function date_format(micro_second) {
    
37.       // 秒数
    
38.       var second = Math.floor(micro_second / 1000);
    
39.       // 小时位
    
40.       var hr = Math.floor(second / 3600);
    
41.       // 分钟位
    
42.       var min = fill_zero_prefix(Math.floor((second - hr * 3600) / 60));
    
43.       // 秒位
    
44.     var sec = fill_zero_prefix((second - hr * 3600 - min * 60));// equal to => var sec = second % 60;
    
45. 
    
46. 
    
47.     return hr + ":" + min + ":" + sec + " ";
    
48. }
    
49. 
    
50. 
    
51. function getDistance(lat1, lng1, lat2, lng2) {
    
52.     var dis = 0;
    
53.     var radLat1 = toRadians(lat1);
    
54.     var radLat2 = toRadians(lat2);
    
55.     var deltaLat = radLat1 - radLat2;
    
56.     var deltaLng = toRadians(lng1) - toRadians(lng2);
    
57.     var dis = 2 * Math.asin(Math.sqrt(Math.pow(Math.sin(deltaLat / 2), 2) + Math.cos(radLat1) * Math.cos(radLat2) * Math.pow(Math.sin(deltaLng / 2), 2)));
    
58.     return dis * 6378137;
    
59. 
    
60.     function toRadians(d) {  return d * Math.PI / 180;}
    
61. }
    
62. 
    
63. function fill_zero_prefix(num) {
    
64.     return num < 10 ? "0" + num : num
    
65. }
    
66. 
    
67. //****************************************************************************************
    
68. //****************************************************************************************
    
69. 
    
70. Page({
    
71.   data: {
    
72.     clock: '',
    
73.     isLocation:false,
    
74.     latitude: 0,
    
75.     longitude: 0,
    
76.     markers: [],
    
77.     covers: [],
    
78.     meters: 0.00,
    
79.     time: "0:00:00"
    
80.   },
    
81. 
    
82. //****************************
    
83.   onLoad:function(options){
    
84.     // 页面初始化 options为页面跳转所带来的参数
    
85.     this.getLocation()
    
86.     console.log("onLoad")
    
87.     count_down(this);
    
88.   },
    
89.   //****************************
    
90.   openLocation:function (){
    
91.     wx.getLocation({
    
92.       type: 'gcj02', // 默认为 wgs84 返回 gps 坐标，gcj02 返回可用于 wx.openLocation 的坐标
    
93.       success: function(res){
    
94.           wx.openLocation({
    
95.             latitude: res.latitude, // 纬度，范围为-90~90，负数表示南纬
    
96.             longitude: res.longitude, // 经度，范围为-180~180，负数表示西经
    
97.             scale: 28, // 缩放比例
    
98.           })
    
99.       },
    
100.     })
     
101.   },
     
102. 
     
103. 
     
104. //****************************
     
105.   starRun :function () {
     
106.     if (starRun == 1) {
     
107.       return;
     
108.     }
     
109.     starRun = 1;
     
110.     count_down(this);
     
111.     this.getLocation();
     
112.   },
     
113. 
     
114. 
     
115. //****************************
     
116.   stopRun:function () {
     
117.     starRun = 0;
     
118.     count_down(this);
     
119.   },
     
120. 
     
121. 
     
122. //****************************
     
123.   updateTime:function (time) {
     
124. 
     
125.     var data = this.data;
     
126.     data.time = time;
     
127.     this.data = data;
     
128.     this.setData ({
     
129.       time : time,
     
130.     })
     
131. 
     
132.   },
     
133. 
     
134. 
     
135. //****************************
     
136.   getLocation:function () {
     
137.     var that = this
     
138.     wx.getLocation({
     
139. 
     
140.       type: 'gcj02', // 默认为 wgs84 返回 gps 坐标，gcj02 返回可用于 wx.openLocation 的坐标
     
141.       success: function(res){
     
142.         console.log("res----------")
     
143.         console.log(res)
     
144. 
     
145.         //make datas
     
146.         var newCover = {
     
147.             latitude: res.latitude,
     
148.             longitude: res.longitude,
     
149.             iconPath: '/resources/redPoint.png',
     
150.           };
     
151.         var oriCovers = that.data.covers;
     
152. 
     
153.         console.log("oriMeters----------")
     
154.         console.log(oriMeters);
     
155.         var len = oriCovers.length;
     
156.         var lastCover;
     
157.         if (len == 0) {
     
158.           oriCovers.push(newCover);
     
159.         }
     
160.         len = oriCovers.length;
     
161.         var lastCover = oriCovers[len-1];
     
162. 
     
163.         console.log("oriCovers----------")
     
164.         console.log(oriCovers,len);
     
165. 
     
166.         var newMeters = getDistance(lastCover.latitude,lastCover.longitude,res.latitude,res.longitude)/1000;
     
167. 
     
168.         if (newMeters < 0.0015){
     
169.             newMeters = 0.0;
     
170.         }
     
171. 
     
172.         oriMeters = oriMeters + newMeters;
     
173.         console.log("newMeters----------")
     
174.         console.log(newMeters);
     
175. 
     
176. 
     
177.         var meters = new Number(oriMeters);
     
178.         var showMeters = meters.toFixed(2);
     
179. 
     
180.         oriCovers.push(newCover);
     
181. 
     
182.         that.setData({
     
183.           latitude: res.latitude,
     
184.           longitude: res.longitude,
     
185.           markers: [],
     
186.           covers: oriCovers,
     
187.           meters:showMeters,
     
188.         });
     
189.       },
     
190.     })
     
191.   }
     
192. 
     
193. })

复制代码

五、后语

本文是一个快速上手开发的介绍，细节介绍可以查看官方文档

(https://mp.weixin.qq.com/debug/wxadoc/dev/?t=20161107)

我的相关全部代码放在github上-weChatApp-Run

(https://github.com/alanwangmodify/weChatApp-Run)

原始地址：http://geek.csdn.net/news/detail/132848

kaneki880914

登录可见评论