跨平台应用开发进阶(六十三)：微信小程序开发

文章目录

- 一、前言
- 二、开发物料准备
- - 2.1 个性化小程序
  - 2.2 开发时如何调用API
  - 2.3 微信小程序开发常用组件库
  - - 2.3.1 WeUI
    - 2.3.2 Vant Weapp
    - 2.3.3 iView Weapp
    - 2.3.4 ColorUI
    - 2.3.5 Wux Weapp
    - 2.3.6 TaroUI
    - 2.3.7 MinUI
- 三、创建一个UNI-APP项目
- 四、进行调试
- - 4.1 启动微信开发者工具
  - 4.2 调试UNI-APP页面
  - 4.3 调试uni-app组件
- 五、微信小程序发布准备
- - 5.1 配置小程序关联信息(微信公众号关联小程序)
  - 5.2 配置小程序主体信息
  - 5.3 配置服务器域名
  - 5.4 发布上线流程
- 六、总结
- 七、拓展阅读

一、前言

随着微信小程序越来越普及，开发人员们也在不断地寻求更高效且方便的开发方式。uni-app是一款由DCloud开发的跨平台工具，可以同时支持小程序、H5、App等多种平台的开发。那么，当使用uni-app开发微信小程序时，怎么进行调试呢？下面就来详细介绍一下。

小程序的运行环境分成渲染层和逻辑层，其中 WXML 模板和 WXSS 样式工作在渲染层，JS 脚本工作在逻辑层。

小程序的渲染层和逻辑层分别由2个线程管理：渲染层的界面使用了WebView 进行渲染；逻辑层采用JsCore线程运行JS脚本。一个小程序存在多个界面，所以渲染层存在多个WebView线程，这两个线程的通信会经由微信客户端（下文中也会采用Native来代指微信客户端）做中转，逻辑层发送网络请求也经由Native转发，小程序的通信模型下图所示。
在这里插入图片描述
注意事项⚠️：

微信客户端在打开小程序之前，会把整个小程序的代码包下载到本地。
多数 API 的回调都是异步，需要处理好代码逻辑的异步问题。

二、开发物料准备

在使用uni-app进行微信小程序开发之前，需要先安装微信开发者工具。因为微信小程序使用的是微信开发者工具来进行开发和调试的。在安装完成后，可以创建一个新的小程序项目，即可得到一个appid以便进行开发。

或者通过 Hbuildx 创建微信小程序，并调用微信开发者工具进行开发调试。

2.1 个性化小程序

什么是个性化小程序呢？就是不同的Tabbar，不同的导航栏，展示和普通小程序不一样的效果，这个中间凸起的Tabbar 我们可以使用Uview里边的Tabbar，也可以自己去定义一个tabbar。

2.2 开发时如何调用API

相信大家都知道开发微信小程序需要配置服务器域名，而且服务器域名必须是 https:// 开头，拥有SSL证书，域名经过备案等等… 难道我们开发时就要提前设置好吗？

也不一定，如果我们公司，或者客户在起初并没有给到我们域名的时候，我们可以微信开发者工具里，勾选不校验合法域名、web-view(业务域名)、TLS版本以及HTTPS证书，然后利用我们的局域网 IP 地址就可以轻松进行开发，这是你就要分开环境了，我们的开发环境和生产环境！

2.3 微信小程序开发常用组件库

2.3.1 WeUI

WeUI是一套同微信原生视觉体验一致的基础样式库，由微信官方设计团队为微信内网页和微信小程序量身设计，令用户的使用感知更加统一。

优点：引入简单，建议简单项目和新手使用。
缺点：组件较少。

效果地址

开发文档

GitHub地址

2.3.2 Vant Weapp

Vant Weapp 是有赞移动端组件库 Vant 的小程序版本，两者基于相同的视觉规范，提供一致的 API 接口，助力开发者快速搭建小程序应用。

最近一次更新版本v1.10.0，日期2021-12-21，有专门的维护团队和社区。

推荐原因：Vant 是有赞前端团队开源的移动端组件库，于 2017 年开源，已持续维护多年时间。Vant 对内承载了有赞所有核心业务，对外服务十多万开发者，是业界主流的移动端组件库之一。

目前 Vant 官方提供了 Vue 2 版本、Vue 3 版本和微信小程序版本，并由社区团队维护 React 版本和支付宝小程序版本。50+组件

优点：组件丰富。
缺点：因为版本更新，造成官网上存在部分内容更新不及时，对新手不太友好。

GitHub地址

开发文档/效果地址

2.3.3 iView Weapp

iView Weapp是由 TalkingData 发布的组件库，一套高质量的微信小程序 UI 组件库。

最近一次更新版本2.0.0，日期2018-07-28

GitHub 地址

开发文档

效果地址需要在开发文档地址中通过微信小程序的方式体验。

2.3.4 ColorUI

鲜亮的高饱和色彩，专注视觉的小程序css组件库。

GitHub 地址

展示地址

开发文档参考: 暂未找到官网地址，有一篇使用教程推荐https://blog.csdn.net/miao_yf/article/details/102971767 配合 https://www.kancloud.cn/als24/color/1141392

2.3.5 Wux Weapp

80+ 丰富的组件，能够满足移动端开发的基本需求。
最近一次版本更新是v3.8.8，日期：2021-04-12

GitHub 地址

开发文档

2.3.6 TaroUI

Taro 是一款基于 Taro 框架开发的多端UI 组件库。一套组件可以在微信小程序，支付宝小程序，百度小程序，H5 多端适配运行（ReactNative 端暂不支持）,但需要学习Taro编译工具。

使用 Taro，我们可以只书写一套代码，再通过 Taro 的编译工具，将源代码分别编译出可以在不同端（微信小程序、H5、RN等）运行的代码。

GitHub 地址

开发文档/效果地址

2.3.7 MinUI

MinUI 是基于微信小程序自定义组件特性开发而成的一套简洁、易用、高效的组件库，适用场景广，覆盖小程序原生框架，各种小程序组件主流框架等。

三、创建一个UNI-APP项目

下一步就是创建一个uni-app项目。可以在DCloud官网上下载uni-app的开发工具，并进行安装。在安装完成后，可以通过“新建项目”来创建一个新的uni-app项目。其中，需要注意选择小程序作为平台，同时输入之前得到的appid和项目名称等相关信息。

① 配置manifest.json文件，配置微信小程序AppID。

在这里插入图片描述
微信小程序AppID 哪里来？登录微信公众平台，开发管理 --> 开发设置中

在这里插入图片描述

或者通过申请测试号生成微信小程序测试appid。

② 运行微信小程序需要配置配置开发者工具路径，这样 Hbuildx 才知道去哪里打开微信开发者工具。

在这里插入图片描述

③ Hbuildx 配置到此结束，还需要配置微信开发者工具，不然是会运行失败的。

开启微信开发者工具中的服务端口：

在这里插入图片描述

四、进行调试

4.1 启动微信开发者工具

在完成以上两个步骤之后，就可以打开微信开发者工具进行调试了。点击微信开发者工具中的“小程序开发”选项，并选择在之前创建的UNI-APP项目的根目录下进行调试。

4.2 调试UNI-APP页面

在微信开发者工具中，可以直接在左侧进行文件的编辑和保存。并且，当uni-app页面的代码发生变化时，开发者工具会自动地进行更新。此外，可以在右上角的“真机调试”选项中，选择需要进行调试的机型和网络类型等信息。

在这里插入图片描述

4.3 调试uni-app组件

当在uni-app页面中进行组件的调试时，需要注意一些问题。首先，在组件中的代码调试时，可以使用DevTools中提供的一些工具来进行操作，例如“编辑组件”选项可以直接进入组件的编辑页面。其次，在使用vue组件时，需要注意组件名的大小写问题。因为微信小程序只支持小写字母来表示组件名称。

五、微信小程序发布准备

到这里我相信基础的小程序开发部分大家都已经很了解了，那么小程序马上上线需要哪些资料呢？

5.1 配置小程序关联信息(微信公众号关联小程序)

为什么要说配置小程序关联公众号呢？

因为在开发的过程中，遇到过一个客户问怎么获取用户的 UnionID ，但是我们的小程序并没有关联过任何公众号，公众平台，所以要提前确认一下需求；

获取 UnionID 的条件？

如果开发者拥有多个移动应用、网站应用、和公众帐号（包括小程序），可通过 UnionID 来区分用户的唯一性，因为只要是同一个微信开放平台帐号下的移动应用、网站应用和公众帐号（包括小程序），用户的 UnionID 是唯一的。换句话说，同一用户，对同一个微信开放平台下的不同应用，UnionID是相同的。

在这里插入图片描述

5.2 配置小程序主体信息

为什么要提前配置小程序主体信息呢？看下图

在这里插入图片描述

上面的截图是我们的一个已经上线的小程序，小程序发布后，非个人类帐号可通过认证方式改名。所以我们在上线前最好把能配置的都配置一下，避免上线以后再去更改审核时间长、需要资料多等麻烦事儿！

5.3 配置服务器域名

上面说了我们在开发时候可以通过 IP 来调用后端大哥的 API，那么上线以后肯定是不行了；因每个微信小程序需要事先设置通讯域名，小程序只可以跟指定的域名进行网络通信。包括普通 HTTPS 请求（wx.request）、上传文件（wx.uploadFile）、下载文件（wx.downloadFile) 和 WebSocket 通信（wx.connectSocket）。

在这里插入图片描述