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

2021-05-06 14:37:14 浏览数 (1)

简要介绍

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

前提准备

  • 微信开发者工具: https://developers.weixin.qq.com/miniprogram/dev/devtools/download.html

创建环境

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

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

选择默认免费配额:

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

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

创建云函数

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

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

代码语言:javascript复制
{
  // ...
  "cloudfunctionRoot": "./cloudfunction/",
  "cloudfunctionTemplateRoot": "cloudfunctionTemplate"
}

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

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

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

使用云函数

编辑 index.js 修改成求和:

代码语言:javascript复制
// 云函数入口文件
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 使用云开发,首先需要初始化云环境:

代码语言:javascript复制
import Taro from "@tarojs/taro";

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

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

然后,调用该云函数:

代码语言:javascript复制
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, https://developers.weixin.qq.com/miniprogram/dev/wxcloud/guide/functions/wx-server-sdk.html 。

其他

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

  • Node.js QuickStart: https://basarat.gitbook.io/typescript/nodejs

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

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

参考

  • 云开发: https://developers.weixin.qq.com/miniprogram/dev/wxcloud/basis/getting-started.html
  • Taro3 快速开始: http://yyixx.com/docs/frontend/taro3

0 人点赞