快速开始

第 1 步：创建目录和云函数文件

1. 在本地创建一个空的文件夹，作为项目的根目录。
2. 进入项目根目录，创建 functions 文件夹。
3. 在 functions 下创建 hello_world 文件夹，包含 index.js 与 package.json 两个文件。

此时目录结构如下：

└── functions    └── hello_world        ├── index.js        └── package.json

index.js 内容如下：

exports.main = async function () {  return "Hello World!";};

package.json 内容如下：

{  "name": "hello_world",  "version": "1.0.0",  "main": "index.js"}

第 2 步：发布云函数

命令行工具

1. 安装并登录 CLI 工具；
2. 在项目根目录运行以下命令，并且使用默认配置：

cloudbase fn deploy hello_world -e <env-id>

小程序开发者工具

您需要先下载并安装 小程序开发者工具。

如果您是首次在微信小程序中使用云开发，请参考 第一个云开发小程序。

在微信小程序中首次使用云函数请参看操作指引 我的第一个云函数。

第 3 步：调用云函数

调用云函数有两种方法：

• 使用云开发 SDK；
• 使用 HTTP 访问服务。

使用 SDK 调用云函数

Web

//初始化SDK实例const cloudbase = require("@cloudbase/js-sdk");const app = cloudbase.init({  env: "xxxx-yyy"});app  .callFunction({    // 云函数名称    name: "hello_world",    // 传给云函数的参数    data: {      a: 1    }  })  .then((res) => {    console.log(res);  })  .catch(console.error);

小程序

wx.cloud  .callFunction({    // 云函数名称    name: "hello_world",    // 传给云函数的参数    data: {      a: 1,      b: 2    }  })  .then((res) => {    console.log(res.result); // 3  })  .catch(console.error);

Node.js

const cloudbase = require("@cloudbase/node-sdk");const app = cloudbase.init({  env: "xxxx-yyy"});app  .callFunction({    // 云函数名称    name: "hello_world",    // 传给云函数的参数    data: {      a: 1    }  })  .then((res) => {    console.log(res);  })  .catch(console.error);

使用 HTTP 调用云函数

执行以下命令创建一条 HTTP 服务路由，路径为 /hello，指向的云函数为 hello_world：

cloudbase service create -p hello -f hello_world -e <env-id>

随后便可以通过 https://<env-id>.service.tcloudbase.com/hello 调用云函数，并获得返回结果。

第 4 步（可选）：在云函数内使用 Node.js SDK

首先，我们在 functions/hello_world/ 路径下，执行以下命令，安装 Node.js SDK：

npm install --save @cloudbase/node-sdk

将 functions/hello_world/index.js 内容改为：

const cloudbase = require("@cloudbase/node-sdk");exports.main = async function () {  if (cloudbase) {    return "Happy Hack With Cloudbase!";  }};

然后我们重新部署云函数：

cloudbase fn deploy hello_world -e <env-id>

在云函数的调用结果里，我们便可以看到结果：

app  .callFunction({    name: "hello_world"  })  .then((res) => {    console.log(res.result); // 'Happy Hack With Cloudbase!'  });