《微信小程序》初识微信小程序

小程序介绍

小程序技术发展史

  • 小程序并非凭空冒出来的一个概念。当微信中的 WebView 逐渐成为移动 Web 的一个重要入口时,微信就有相关的 JS API 了。
  • 小程序提供了一个简单、高效的应用开发框架和丰富的组件及API,帮助开发者在微信中开发具有原生 APP 体验的服务。
  • 2015年初,微信发布了一整套网页开发工具包,称之为 JS-SDK,开放了拍摄、录音、语音识别、二维码、地图、支付、分享、卡券等几十个API。给所有的 Web 开发者打开了一扇全新的窗户,让所有开发者都可以使用到微信的原生能力,去完成一些之前做不到或者难以做到的事情。
  • 小程序的主要开发语言是 JavaScript ,小程序的开发同普通的网页开发相比有很大的相似性。对于前端开发者而言,从网页开发迁移到小程序的开发成本并不高,但是二者还是有些许区别的。

小程序与普通网页开发的区别

  • 小程序的主要开发语言是 JavaScript ,小程序的开发同普通的网页开发相比有很大的相似性。对于前端开发者而言,从网页开发迁移到小程序的开发成本并不高,但是二者还是有些许区别的。

  • 网页开发渲染线程和脚本线程是互斥的,这也是为什么长时间的脚本运行可能会导致页面失去响应,而在小程序中,二者是分开的,分别运行在不同的线程中。网页开发者可以使用到各种浏览器暴露出来的 DOM API,进行 DOM 选中和操作。
    而如上文所述,小程序的逻辑层和渲染层是分开的,逻辑层运行在 JSCore 中,并没有一个完整浏览器对象,因而缺少相关的DOM API和BOM API。这一区别导致了前端开发非常熟悉的一些库,例如 jQuery、 Zepto 等,在小程序中是无法运行的。同时 JSCore 的环境同 NodeJS 环境也是不尽相同,所以一些 NPM 的包在小程序中也是无法运行的。

  • 网页开发者需要面对的环境是各式各样的浏览器,PC 端需要面对 IE、Chrome、QQ浏览器等,在移动端需要面对Safari、Chrome以及 iOS、Android 系统中的各式 WebView 。而小程序开发过程中需要面对的是两大操作系统 iOS 和 Android 的微信客户端,以及用于辅助开发的小程序开发者工具,小程序中三大运行环境也是有所区别的。

  • 如表1-1所示:

    在这里插入图片描述

网页开发者在开发网页的时候,只需要使用到浏览器,并且搭配上一些辅助工具或者编辑器即可。
小程序的开发则有所不同,需要经过申请小程序帐号、安装小程序开发者工具、配置项目等等过程方可完成。

  • 下面二维码可以使用微信客户端扫描体验小程序

    在这里插入图片描述

小程序平台注册

  • 开发小程序的第一步,你需要拥有一个小程序帐号,通过这个帐号你就可以管理你的小程序。
  • 申请帐号:https://mp.weixin.qq.com/wxopen/waregister?action=step1

在这里插入图片描述

在这里插入图片描述

在这里插入图片描述

在这里插入图片描述

在这里插入图片描述

  • 在这个小程序管理平台,你可以管理你的小程序的权限,查看数据报表,发布小程序等操作。
  • 登录 小程序后台 ,我们可以在菜单 “开发”-“开发设置” 看到小程序的 AppID 了 。
  • 小程序的 AppID 相当于小程序平台的一个身份证,后续你会在很多地方要用到 AppID (注意这里要区别于服务号或订阅号的 AppID)。
  • 有了小程序帐号之后,我们需要一个工具来开发小程序。

开发工具安装

  • 前往开发者工具下载页面 ,根据自己的操作系统下载对应的安装包进行安装:
    https://developers.weixin.qq.com/miniprogram/dev/devtools/download.html

在这里插入图片描述

在这里插入图片描述

在这里插入图片描述

在这里插入图片描述

在这里插入图片描述

第一个小程序

  • 新建项目选择小程序项目,选择代码存放的硬盘路径,填入刚刚申请到的小程序的 AppID,给你的项目起一个好听的名字,勾选 “不使用云服务” (注意: 你要选择一个空的目录才可以创建项目),点击新建,你就得到了你的第一个小程序了,点击顶部菜单编译就可以在微信开发者工具中预览你的第一个小程序。

    在这里插入图片描述

在这里插入图片描述

  • 多开项目
  • 工具支持同时打开多个项目,每次打开项目时会从新窗口打开,入口有以下几种:
  • 从项目选择页打开项目,处于项目窗口时可以从菜单栏的项目 -> 查看所有项目打开项目选择页
  • 从菜单栏的最近打开项目列表中打开的项目会从新窗口打开
  • 管理项目
  • 对本地项目进行删除和批量删除
  • 编译预览
  • 点击工具上的编译按钮,可以在工具的左侧模拟器界面看到这个小程序的表现,也可以点击预览按钮,通过微信的扫一扫在手机上体验你的第一个小程序。
  • 主界面
  • 开发者工具主界面,从上到下,从左到右,分别为:菜单栏、工具栏、模拟器、目录树、编辑区、调试器 六大部分。

在这里插入图片描述

  • 菜单栏

  • 微信web开发者工具

    切换帐号:快速切换登录用户
    关于:关于开发者工具
    检查更新:检查版本更新
    开发者论坛:前往开发者论坛
    开发者文档:前往开发者文档
    调试:调试开发者工具、调试编辑器;如果遇到疑似开发者工具或者编辑器的 bug,可以打开调试工具查看是否有出错日志,欢迎在论坛上反馈相关问题
    更换开发模式:快速切换公众号网页调试和小程序调试
    退出:退出开发者工具

    项目:
    新建项目:快速新建项目
    打开最近:可以查看最近打开的项目列表,并选择是否进入对应项目
    查看所有项目:新窗口打开启动页的项目列表页
    关闭当前项目:关闭当前项目,回到启动页的项目列表页

    文件:
    新建文件
    保存
    保存所有
    关闭文件

    编辑:可以查看编辑相关的操作和快捷键

    工具:
    编译:编译当前小程序项目
    刷新:与编译的功能一致,由于历史原因保留对应的快捷键 ctrl(⌘) + R
    编译配置:可以选择普通编译或自定义编译条件
    前后台切换:模拟客户端小程序进入后台运行和返回前台的操作
    清除缓存:清除文件缓存、数据缓存、以及授权数据
    界面:控制主界面窗口模块的显示与隐藏

    设置:
    外观设置:控制编辑器的配色主题、字体、字号、行距
    编辑设置:控制文件保存的行为,编辑器的表现
    代理设置:选择直连网络、系统代理和手动设置代理
    通知设置:设置是否接受某种类型的通知

  • 用户头像右侧是控制主界面模块显示/隐藏的按钮。至少需要有一个模块显示。

  • 工具栏上提供了清缓存的快速入口。可以便捷的清除工具上的文件缓存、数据缓存、还有后台的授权数据,方便开发者调试。

  • 工具栏右侧是开发辅助功能的区域,在这里可以上传代码、版本管理、查看项目详情

    在这里插入图片描述

小程序项目结构介绍

  • 小程序包含一个描述整体程序的 app 和多个描述各自页面的 page。
  • 一个小程序主体部分由三个文件组成,必须放在项目的根目录,如下:

在这里插入图片描述

  • 一个小程序页面page由四个文件组成,分别是:

在这里插入图片描述

  • JSON 配置

    JSON 是一种数据格式,并不是编程语言,在小程序中,JSON扮演的静态配置的角色。
    我们可以看到在项目的根目录有一个 app.json 和 project.config.json,此外在 pages/logs 目录下还有一个 logs.json,我们依次来说明一下它们的用途。

  • JSON 语法

    这里说一下小程序里JSON配置的一些注意事项。
    JSON文件都是被包裹在一个大括号中 {},通过key-value的方式来表达数据。JSON的Key必须包裹在一个双引号中,在实践中,编写 JSON 的时候,忘了给 Key 值加双引号或者是把双引号写成单引号是常见错误。

    JSON的值只能是以下几种数据格式,其他任何格式都会触发报错,例如 JavaScript 中的 undefined。
    1.数字,包含浮点数和整数
    2.字符串,需要包裹在双引号中
    3.Bool值,true 或者 false
    4.数组,需要包裹在方括号中 []
    5.对象,需要包裹在大括号中 {}
    6.Null

    还需要注意的是 JSON 文件中无法使用注释,试图添加注释将会引发报错。

全局配置之app.json

  • 小程序根目录下的 app.json 文件用来对微信小程序进行全局配置,决定页面文件的路径、窗口表现、设置网络超时时间、设置多 tab 等。

  • 我们简单说一下这个配置各个项的含义:

    1. pages字段 —— 用于描述当前小程序所有页面路径,这是为了让微信客户端知道当前你的小程序页面定义在哪个目录。
    2. window字段 —— 定义小程序所有页面的顶部背景颜色,文字颜色定义等。
  • app.json文件内容为一个 JSON 对象,有以下配置项列表

    在这里插入图片描述

  • pages

    1. 用于指定小程序由哪些页面组成,每一项都对应一个页面的 路径(含文件名) 信息。文件名不需要写文件后缀,框架会自动去寻找对应位置的 .json, .js, .wxml, .wxss 四个文件进行处理。
    2. 数组的第一项代表小程序的初始页面(首页)。小程序中新增/减少页面,都需要对 pages 数组进行修改。
      如开发目录为:

在这里插入图片描述

  • window

    用于设置小程序的状态栏、导航条、标题、窗口背景色。

    在这里插入图片描述

  • tabBar

    如果小程序是一个多 tab 应用(客户端窗口的底部或顶部有 tab 栏可以切换页面),可以通过 tabBar 配置项指定 tab 栏的表现,以及 tab 切换时显示的对应页面。

    在这里插入图片描述

​ 其中 list 接受一个数组,只能配置最少 2 个、最多 5 个 tab。tab 按数组的顺序排序,每个项都是一个对象,其属性值如下:

在这里插入图片描述

  • networkTimeout

在这里插入图片描述

  • 其他配置

  • debug
    可以在开发者工具中开启 debug 模式,在开发者工具的控制台面板,调试信息以 info 的形式给出,其信息有 Page 的注册,页面路由,数据更新,事件触发等。可以帮助开发者快速定位一些常见的问题。

  • functionalPages
    插件所有者小程序需要设置这一项来启用插件功能页。

  • subpackages
    启用分包加载时,声明项目分包结构。

  • workers
    使用 Worker 处理多线程任务时,设置 Worker 代码放置的目录

  • requiredBackgroundModes
    申明需要后台运行的能力,类型为数组。目前支持以下项目:
    audio: 后台音乐播放
    location: 后台定位

  • plugins
    声明小程序需要使用的插件

  • preloadRule
    声明分包预下载的规则。

  • resizable
    在 iPad 上运行的小程序可以设置支持屏幕旋转。
    在 PC 上运行的小程序,用户可以按照任意比例拖动窗口大小,也可以在小程序菜单中最大化窗口

  • usingComponents
    在此处声明的自定义组件视为全局自定义组件,在小程序内的页面或自定义组件中可以直接使用而无需再声明。

  • permission
    小程序接口权限相关设置。字段类型为 Object。

  • sitemapLocation
    指明 sitemap.json 的位置;默认为 ‘sitemap.json’ 即在 app.json 同级目录下名字的 sitemap.json 文件

  • useExtendedLib
    指定需要引用的扩展库。目前支持以下项目:
    kbone: 多端开发框架
    weui: WeUI 组件库

  • entranceDeclare
    聊天位置消息用打车类小程序打开

  • darkmode
    微信iOS客户端 7.0.12 版本、Android客户端 7.0.13 版本正式支持 DarkMode,可通过配置"darkmode": true表示当前小程序可适配 DarkMode,所有基础组件均会根据系统主题展示不同的默认样式,navigation bar 和 tab bar 也会根据开发者的配置自动切换。

  • themeLocation
    自定义 theme.json 的路径,当配置"darkmode":true时,当前配置文件为必填项。

全局配置之sitemap.json

  • 微信现已开放小程序内搜索,开发者可以通过 sitemap.json 配置,或者管理后台页面收录开关来配置其小程序页面是否允许微信索引。

  • 当开发者允许微信索引时,微信会通过爬虫的形式,为小程序的页面内容建立索引。当用户的搜索词条触发该索引时,小程序的页面将可能展示在搜索结果中。 爬虫访问小程序内页面时,会携带特定的 user-agent:mpcrawler 及场景值:1129。需要注意的是,若小程序爬虫发现的页面数据和真实用户的呈现不一致,那么该页面将不会进入索引中。

  • sitemap.json 有以下属性:

    在这里插入图片描述

  • 所有页面都会被微信索引(默认情况)

  • 配置 path/to/page 页面不被索引,其余页面允许被索引

  • 配置 path/to/page 页面被索引,其余页面不被索引

工具配置project.config.json

  • 通常大家在使用一个工具的时候,都会针对各自喜好做一些个性化配置,例如界面颜色、编译配置等等,当你换了另外一台电脑重新安装工具的时候,你还要重新配置。

  • 考虑到这点,小程序开发者工具在每个项目的根目录都会生成一个 project.config.json,你在工具上做的任何配置都会写入到这个文件,当你重新安装工具或者换电脑工作时,你只要载入同一个项目的代码包,开发者工具就自动会帮你恢复到当时你开发项目时的个性化配置,其中会包括编辑器的颜色、代码上传时自动压缩等等一系列选项。

  • 可以在项目根目录使用 project.config.json 文件对项目进行配置。

    在这里插入图片描述

  • setting 中可以指定以下设置

    在这里插入图片描述

页面配置page,json

  • 这里的 page.json 其实用来表示 pages/logs 目录下的 logs.json 这类和小程序页面相关的配置。
  • 如果你整个小程序的风格是蓝色调,那么你可以在 app.json 里边声明顶部颜色是蓝色即可。实际情况可能不是这样,可能你小程序里边的每个页面都有不一样的色调来区分不同功能模块,因此我们提供了 page.json,让开发者可以独立定义每个页面的一些属性,例如刚刚说的顶部颜色、是否允许下拉刷新等等。
  • 每一个小程序页面也可以使用同名 .json 文件来对本页面的窗口表现进行配置,页面中配置项会覆盖 app.json 的 window 中相同的配置项。
  • 页面的.json只能设置 window 相关的配置项,以决定本页面的窗口表现,所以无需写 window 。

在这里插入图片描述

在这里插入图片描述

WXML模板

  • 从事过网页编程的人知道,网页编程采用的是 HTML + CSS + JS 这样的组合,其中 HTML 是用来描述当前这个页面的结构,CSS 用来描述页面的样子,JS 通常是用来处理这个页面和用户的交互。
  • 同样道理,在小程序中也有同样的角色,其中 WXML 充当的就是类似 HTML 的角色。打开 pages/index/index.wxml,你会看到以下的内容:

在这里插入图片描述

  • 和 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 只需要管理状态即可,然后再通过一种模板语法来描述状态和界面结构的关系即可。

WXSS样式

  • WXSS 具有 CSS 大部分的特性,小程序在 WXSS 也做了一些扩充和修改。
  • 新增了尺寸单位。在写 CSS 样式时,开发者需要考虑到手机设备的屏幕会有不同的宽度和设备像素比,采用一些技巧来换算一些像素单位。WXSS 在底层支持新的尺寸单位 rpx ,开发者可以免去换算的烦恼,只要交给小程序底层来换算即可,由于换算采用的浮点数运算,所以运算结果会和预期结果有一点点偏差。
  • 提供了全局的样式和局部样式。和前边 app.json, page.json 的概念相同,你可以写一个 app.wxss 作为全局样式,会作用于当前小程序的所有页面,局部页面样式 page.wxss 仅对当前页面生效。
  • 一个服务仅仅只有界面展示是不够的,还需要和用户做交互:响应用户的点击、获取用户的位置等等。在小程序里边,我们就通过编写 JS 脚本文件来处理用户的操作。
  • 点击 button 按钮的时候,我们希望把界面上 msg 显示成 “Hello World”,于是我们在 button 上声明一个属性: bindtap ,在 JS 文件里边声明了 clickMe 方法来响应这次点击操作:
  • 响应用户的操作就是这么简单,更详细的事件可以参考文档 WXML - 事件 。
    此外你还可以在 JS 中调用小程序提供的丰富的 API,利用这些 API 可以很方便的调起微信提供的能力,例如获取用户信息、本地存储、微信支付等。

util.js

  • 提供公共方法的工具文件,如果你没有用到。可以删掉!
    在小程序中,定义了一项工具文件utils,此文件的js旨在本文件之内有效,当其他子页面想调用其中的js方法或者变量时,需要两步骤:

    1. 在utils被调用的js文件中,面向对象的方式模型输出:
      module.exports={要调用的函数名称:要调用的函数名称 };

    2. 在要调用的js文件中模块化引入utils的js文件

      var object=require(“utils被调用的js文件地址”)

  • 0
    点赞
  • 0
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
OneNet 微信小程序是由中国移动推出的一款用于物联网应用开发的工具。它基于微信小程序的开发框架,结合了中国移动的物联网平台 OneNet,提供了丰富的物联网功能和接口。 OneNet 微信小程序可以实现设备接入和控制、数据采集和展示、消息推送等一系列物联网应用的开发。与传统的物联网应用开发相比,OneNet 微信小程序具有以下几个优势: 首先,OneNet 微信小程序的开发门槛较低,使用的是微信小程序的开发框架,开发者可以使用熟悉的前端开发技术进行开发。同时,OneNet 提供了丰富的开发文档和示例,为开发者提供了便捷的开发环境。 其次,OneNet 微信小程序与微信生态系统的无缝对接,可以直接通过微信小程序实现设备的远程控制和数据采集。用户只需要在微信小程序中注册设备并进行绑定,即可通过手机随时随地对设备进行控制和监测。 再次,OneNet 微信小程序支持多种数据展示方式,包括图表、列表和地图等,用户可以根据实际需要选择最合适的展示形式。同时,OneNet 提供了数据分析和报表功能,可以对设备的历史数据进行分析和展示,帮助用户更好地了解设备的运行状态和趋势。 总而言之,OneNet 微信小程序是一款功能强大且易于开发的物联网应用开发工具,为开发者和用户提供了便捷的物联网应用开发和使用体验。

“相关推荐”对你有帮助么?

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值