抛砖引玉(3): 微信云开发最佳实际

概览

微信云开发是一个买通了微信生态的 BaaS (后端即服务) 平台，开发不便，快捷，计费敌对，适宜集体开发者，以及小团队应用。

它次要由 云数据库 , 云存储 , 云函数 , 用户身份验证 还有 云托管  组成，其中  云函数 / 云托管 就是咱们的后端服务了。

这篇文章也次要聊一聊它们工程化的最佳实际。

云函数

微信云开发里的云函数，实质上是领有微信人造鉴权 SCF。它也属于腾讯云 serverless 体系。所以 SCF 的最佳实际，局部也是通用的。

这里能够关注一下笔者的 serverless 专栏 Serverless 之我见 , 外面有许多基于 SCF 的最佳实际。

wx-server-sdk

应用云函数，根本肯定会装这个包，它解锁了 BaaS 下的那些额定的能力。

从装置后的 npm 包代码来看，它是一个 cloudbase 性能的场景定制版。

比方咱们的 WXContext 的获取，就是凭仗 serverless 容器环境中的 WX\_CONTEXT\_KEYS 环境变量，解析它来获取的。

那么从这点登程，咱们就可能本人去 mock 云函数里的微信的上下文机制。

小程序想要跨多个平台的，倡议事后对 wx-server-sdk 里的 cloud.getWXContext() 上下文获取机制进行形象，不然随着业务迭代，对微信上下文依赖加深，会造成肯定的迁徙艰难。

cloudbase 能力解锁

咱们晓得 微信开发者工具  开发小程序的体验始终不是很好。所以为了晋升开发体验，咱们通常会在 vscode 里写代码，而后再把工具当成一个 模拟器 和调试器 来应用。

云开发亦是 如此  (笑~)，这里咱们间接应用 @cloudbase/cli 来运维咱们的云函数，有了它，咱们就能脱离 微信IDE 和配置的限度 , 来帮忙咱们更好的实现工程化。

具体操作，能够进入微信开发者工具 > 云开发 > 费用治理 > 代金券 > 充值与账单，可能关上腾讯云的登录界面。在这个页面，就能够把云开发默认创立的腾讯云账号，和你本人的微信做关联。
关联胜利后，咱们既能够在 微信 IDE 里治理云开发 , 也可能在腾讯云控制台  云开发 Cloudbase 这个性能中进行治理。
这样除了微信本人的用户治理须要在小程序 IDE 内查看，其余都能够去腾讯云控制台进行操作。

云函数我的项目的目录构造

这里我给大家一个示例。

目录构造

图中几点提及一下:

• cloudbaserc.json 是 cloudbase cli 的配置文件。为什么会有一个 cloudbaserc.js呢？这个文件是笔者自定义的脚本，它会扫描 dist 下的函数代码，来生成 cloudbaserc.json。
• 这么做的起因是因为 json,yml 这类数据格式作为配置文件的表现力，比起代码，还是偏弱的，所以咱们须要动静生成的配置文件。
• .env,.env.dev,.env.prod 用来申明在不同 mode 中，失效的变量。
  比方 tcb fn deploy –mode dev 这样一条部署命令，它应用的就是 .env,.env.dev 文件merge 后的变量。这个机制与 vue cli 的 mode是相似的。
• 此时咱们就可能在 .env.dev,.env.prod 里申明本人的云环境 ID ENV\_ID=dev-xxxxx , 再在 cloudbaserc.json 申明 “envId”: “{{env.ENV\_ID}}”,，这样就能通过切换 mode 的形式去疾速治理不同的环境了。

src 与 dist

这个目录构造，前端的敌人们很相熟了, src 寄存着咱们的源代码，dist 是打包后理论失效的运行时代码。

2 个外部的构造和转化如图所示:

构造

这套机制算是 这三期 抛砖引玉 文章的一个总结。

它的劣势在于，让多个云函数处于一种 ‘ 游离态 ’, 这种状态既保证多个云函数之间，公共逻辑代码的复用，又保障了每一个云函数，作为一个独自的 Nodejs 利用 的独立性。

比方在图上可知：

• 单个函数，可能决定本人的openapi 权限 (config.json)。
• 也能保障，在共用 node\_module 的根底上，一个云函数有权决定，哪些 npm 包是本人非凡公有的 (依附本人 pkg.json 申明与node\_module 递归向上查找)。
• 也有权决定函数中，哪些须要打包，哪些不须要。并在云端把缺失的依赖装置好 (依附独立的external 选项)。

打包 serverless 源码

对于 serverless 为什么须要打包，和怎么打包这 2 个问题，这里笔者之前写了一篇文章:

serverless 升高冷启动工夫的摸索 – 服务端打包 node\_modules

阐释了打包 服务端 Nodejs 的必要性和可行性，以及遇到打包后启动失败的状况应该如何去做。

因为这里的云函数实质上也是SCF, 所以在计划上也是通用的。

注: 大的二进制文件，可通过上传层函数，绑定给云函数来应用

cloudbase cli 取代 微信 IDE 部署

在 微信IDE 里，通常咱们右键点击上传并部署就胜利了。

cli 也是一行命令的事件 tcb fn deploy [options] [name]

同时它也可能解锁更多进阶的性能。

应用 cli 的益处有许多: 相比于在 UI 界面上操作，cli更有效率，也可能更好的工程化咱们的我的项目。

扩大: 甚至咱们可能针对 tcb 这样的命令，做二次封装（有点相似于咱们前端里高阶组件的概念），来达到原先 cli 做不到的事件。

debug

说了这么多，咱们应该如何进行本地调试呢？

原先咱们依赖微信 IDE 的本地 / 云端调试性能，当初能够依附本地仿造的微信上下文，参数，还有本地调试命令 tcb fn run [options] 进行调试。

因为咱们事后编译了，所以此时须要打出 sourcemap，并给它映射对正确的源代码门路，这样咱们只须要在src 里的源代码打断点，就可能实时命中了。

云端测试原先就是个比拟残次的性能，重大依赖日志，当初也不例外。还是要依靠 SCF 近程单实例调试，或者 Web IDE，体验才会稍好一些。

数据迁徙

这里咱们独自创立了一个 migration 我的项目，在本地去执行数据迁徙的脚本。

Q: 为什么不在云函数里触发进行数据迁徙？

A: 因为没有必要, 且调试麻烦。本地咱们通过小程序在腾讯云中的 SecretId 和 SecretKey，可能间接连进微信云开发里的云数据库进行操作。

具体做法还是以 @cloudbase/manager-node 和 @cloudbase/node-sdk 为主，进行汇合和索引的治理，还有数据的迁徙。

微信云托管

应用容器部署的云托管，相对来说，应用更加的自在，不便，而且上下文的机制，也通过 申请 header，传给咱们的利用，这一块不限度语言，最佳实际就有很多了。

云托管就比拟适宜偏中型的业务场景，毕竟它是常驻运行，没有云函数的冷启动问题。同时也因为它是常驻运行, 也代表这它的免费，相比来说会比云函数要贵一些。

附 云托管与云函数的比照

后记

本篇文章，次要探讨的是小程序云开发中的 工程化 问题，内容上尽可能的缩小了代码的实现(笔者已实现)，偏重在于大量的概念。

如果您有急躁看完，并存在不了解之处，欢送告知笔者进行进一步的文章欠缺。又或者您有更好的计划，也欢送与笔者进行探讨，一起提高成长。

附录

微信小程序开启云函数配置: project.config.json中 cloudfunctionRoot, 这个计划开发体验个别。

抛砖引玉(1)：一种改善微信云开发 , 开发者体验的思路

抛砖引玉(2): Cloudbase Framework 助力改善微信云开发的体验