更新记录

1.0.0(2026-11-20) 下载此版本

2026.11.20


平台兼容性

云端兼容性

支付宝云 腾讯云 阿里云
× √ √

wwh2024-hello 插件使用说明

一、基本信息

项目 内容
插件ID wwh2024-hello
作者ID wwh2024
插件类型 uniCloud 云函数模板(unicloud-template-function)
当前版本 1.0.0
授权方式 免费
云服务商 阿里云(aliyun)、腾讯云(tcb)
是否采集数据 无
是否包含广告 无
所需系统权限 无

二、目录结构

wwh2024-hello/
├── package.json                              # 插件清单
├── readme.md                                 # 插件简介与示例
├── changelog.md                              # 更新日志
├── 插件使用说明.md                            # 本文件
└── uniCloud/
    └── cloudfunctions/
        └── wwh2024-hello/                     # 云函数目录
            ├── index.js                       # 云函数入口(main 函数)
            └── package.json                   # 云函数配置(dependencies)

三、云函数参数与返回

1. 问候 action:hello

入参

参数 类型 必填 说明
name String 否 称呼,缺省为"朋友"

返回示例

{
  "success": true,
  "message": "你好,同学!欢迎使用 wwh2024-hello 云函数。",
  "data": { "name": "同学", "time": 1732090000000 }
}

2. 两数相加 action:add

入参

参数 类型 必填 说明
a Number 否 加数,缺省 0
b Number 否 加数,缺省 0

返回示例

{
  "success": true,
  "result": 8,
  "data": { "a": 3, "b": 5, "sum": 8 }
}

入参不是数字时返回:

{ "success": false, "message": "参数 a、b 必须为数字" }

四、前端调用步骤

1. 关联服务空间

在 HBuilderX 中打开你的 uni-app 工程,顶部菜单 项目 → uniCloud → 关联云服务空间(需先在 uniCloud 控制台创建阿里云或腾讯云空间)。

2. 导入插件

将 wwh2024-hello 目录复制到工程的 uni_modules/ 下,最终路径:

你的工程/
└── uni_modules/
    └── wwh2024-hello/

导入后,云函数会出现在 uniCloud → cloudfunctions 下。

3. 上传部署云函数

在 HBuilderX 中右键云函数 wwh2024-hello → 上传部署,等待部署完成。

4. 页面代码调用

// 问候
uni.callFunction({
  name: 'wwh2024-hello',
  data: { action: 'hello', name: '同学' }
}).then(res => {
  console.log(res.result.message)
}).catch(err => {
  console.error('调用失败', err)
})

// 两数相加
uni.callFunction({
  name: 'wwh2024-hello',
  data: { action: 'add', a: 3, b: 5 }
}).then(res => {
  console.log(res.result.result) // 8
})

五、自定义改造

  • 新增 action:在 index.js 的 switch 中增加一个 case;
  • 修改返回字段:直接编辑对应分支的 return 对象;
  • 安装第三方依赖:在云函数目录 package.json 的 dependencies 中声明后,右键云函数 → 安装依赖。

六、常见问题

Q:调用提示云函数不存在? A:确认已右键 wwh2024-hello 云函数执行"上传部署",且工程已关联正确的服务空间。

Q:uni.callFunction 报网络/空间错误? A:检查服务空间是否已创建并关联;云服务商类型要与空间一致。

Q:插件内的 uniCloud 目录为什么没有 -aliyun 后缀? A:uni_modules 插件内的 uniCloud 目录不带厂商后缀,导入工程后由 HBuilderX 自动合并到对应厂商空间。

(注:部分内容由豆包 AI 生成)

隐私、权限声明

1. 本插件需要申请的系统权限列表:

无

2. 本插件采集的数据、发送的服务器地址、以及数据用途说明:

无

3. 本插件是否包含广告,如包含需详细说明广告表达方式、展示频率:

无

许可协议

MIT协议

暂无用户评论。