知晓程序注：

我们相信，小程序的形态也非常适合线下场景使用。如何针对线下场景做出一个小程序？

今天，我们要给大家分享的是，一个涉及地图应用的运动类小程序开发手记。相信能给专注线下业务的小程序开发者带来一些启发。

文 | alanwangmodify

准备工作

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

注册过程中需要很多认证，比较繁琐。如果暂时只是试水、没有发布的打算，那么只要完成基本信息填写就可以，不需要完成微信认证。

之后，就可以在公众平台使用注册的帐户进行登录。

然后，在主页面左边列表中点击设置，再设置页面中选开发设置，就可以看到 AppID。

AppID 可以用于在开发工具中进行登记，使用开发工具的高级功能。你可以到官网下载开发工具。

开始项目

打开开发者工具，选择小程序选项，然后直接点击「添加项目」按钮。我们可以在这个步骤，填入刚才注册的时候使用的 AppID。

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

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

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

1. 框架

我们首先看一下官方提供的 Demo 含有的目录：

小程序页面构成类似这样：

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

微信小程序中的每一个页面的路径和页面文件名，都需要写在 app.json 的 pages 中，且 pages 数组中的第一个页面是小程序的首页。

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

在 iOS 上，小程序的逻辑代码运行于 JavaScriptCore 中，而在 Android 上，这个任务则是交给 X5 内核来完成。

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

2. 组件

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

这其中，包含了 view、scroll-view、button、form 等普通常用的组件，也提供了地图 map、画布 canvas 等特殊屏幕元素。

组件主要属于视图层，通过 WXML 来进行结构布局，类似于 HTML。样式则通过 WXSS 来定义和修改，它的语法和使用都近似 CSS。

组件使用语法实例：

这是一个普通视图

样式修改过的视图

更多的组件以及相关使用方法可以到官方文档中的「组件」一节查看

3. API

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

其中，网络请求的使用，必须先到公众平台设置白名单域名。

网络请求接口包含了普通的 HTTPS 请求，支持上传、下载、Socket，基本上满足了我们开发中所需要的网络需求。

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

使用实例：

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. 真机调试

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

实战：跑步小程序

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

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

存在的问题：

我已经把全部代码放在 GitHub 上，大家可以下载来看看或者先 Star 起来，我以后还会进行一些优化更新。现在只是一个学习 Demo，大家沟通学习，实际应用还需更多优化。

原文链接：http://www.jianshu.com/p/6e826464d52c

开源代码地址：https://github.com/alanwangmodify/weChatApp-Run

知晓程序（微信号 zxcx0101）是爱范儿旗下专注于小程序生态的公众号。我们提供最全面、新鲜的小程序资讯（消息、观点、指南、活动）和服务，在这里你能了解到关于小程序的一切。