更新记录
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 生成)

收藏人数:
下载插件并导入HBuilderX
赞赏(0)
下载 0
赞赏 0
下载 35314
赞赏 159
赞赏
京公网安备:11010802035340号