微信小程序云开发如何上手

时间:2023-12-13 20:15:20

简要介绍

微信小程序云开发,是基于 Serverless 的一站式后端云服务,涵盖函数、数据库、存储、CDN等服务,免后端运维。基于云开发可以免鉴权调用微信所有开放能力。

前提准备

创建环境

打开小程序项目,点击工具栏“云开发”进行开通:

微信小程序云开发如何上手

根据对话框提示,创建云环境:

微信小程序云开发如何上手

选择默认免费配额:

微信小程序云开发如何上手

“提交订单”,创建完成。

此后,就可以打开“云开发控制台”了:

微信小程序云开发如何上手

创建云函数

云函数是一段运行在云端的代码,无需管理服务器,在开发工具内编写、一键上传部署即可运行后端代码。

首先,配置小程序项目。编辑 project.config.json 添加 cloudfunctionRoot:

{
// ...
"cloudfunctionRoot": "./cloudfunction/",
"cloudfunctionTemplateRoot": "cloudfunctionTemplate"
}

并于根目录新建该目录 cloudfunction ,该目录图标会变成“云目录图标”。

然后,右键云函数根目录,“新建 Node.js 云函数”:

微信小程序云开发如何上手

输入云函数名称,就会创建好模板:

微信小程序云开发如何上手

使用云函数

编辑 index.js 修改成求和:

// 云函数入口文件
const cloud = require("wx-server-sdk"); cloud.init(); // 云函数入口函数
exports.main = async (event, context) => {
const wxContext = cloud.getWXContext(); return {
sum: event.a + event.b,
};
};
  • event 是触发云函数的事件。小程序端调用时,就是其请求参数。
  • return 返回云函数计算的结果。小程序端调用时,就是其响应内容。

Taro 调用云函数

Taro 是一个开放式跨端跨框架解决方案,支持使用 React/Vue/Nerv 等框架来开发 微信/京东/百度/支付宝/字节跳动/QQ 小程序/H5 等应用。

快速创建小程序应用,可见 Taro3 快速开始

Taro 使用云开发,首先需要初始化云环境:

import Taro from "@tarojs/taro";

Taro.cloud.init({
env: "gocoding-xxx",
});

其中 env 环境 ID ,可见“云开发控制台”的“设置”:

微信小程序云开发如何上手

然后,调用该云函数:

Taro.cloud
.callFunction({
name: "photo-lucky",
data: {
a: 1,
b: 2,
},
})
.then((res) => {
console.log(res);
})
.catch((err) => {
console.log(err);
});
  • name 是云函数的名称。
  • data 是请求参数,对应云函数的 event

部署云函数

右键云函数目录,选择“上传并部署”:

微信小程序云开发如何上手

编译运行小程序,可见打印结果:

微信小程序云开发如何上手

调试云函数

打开“云开发控制台”的“云函数”:

微信小程序云开发如何上手

打开“本地调试”,右侧选中“开启本地调试”:

微信小程序云开发如何上手

之后,小程序调用云函数就会进“本地调试”。

云开发服务

云函数模板中默认 requirewx-server-sdk,这是一个帮助我们在云函数中操作数据库、存储以及调用其他云函数的微信提供的库。关于 wx-server-sdk 的使用可见 在云函数中使用 wx-server-sdk

其他

云函数是 Node.js 应用,原想直接使用 TypeScript 开发并运行,可参考:

但其调试时默认主入口是 index.js,试了下配置,但没什么用。报错如下:

微信小程序云开发如何上手

所以,想用 TypeScript 的话,需要 tsc 编译发布出 js 后再调试。

参考

结语

欢迎关注 GoCoding 公众号,分享日常 Coding 中实用的小技巧、小知识!