From c70497f4770889efcad14fa91423c2b772c47f09 Mon Sep 17 00:00:00 2001 From: wanganxp Date: Sun, 19 Jul 2020 08:42:46 +0800 Subject: [PATCH] Update quickstart.md --- docs/uniCloud/quickstart.md | 27 ++++++++++++++++++--------- 1 file changed, 18 insertions(+), 9 deletions(-) diff --git a/docs/uniCloud/quickstart.md b/docs/uniCloud/quickstart.md index a9c5e0e58..43d8d1475 100644 --- a/docs/uniCloud/quickstart.md +++ b/docs/uniCloud/quickstart.md @@ -67,27 +67,34 @@ exports.main = async (event, context) => { ## 运行和调试云函数@rundebug -编写云函数后，在项目管理器里右键点击该云函数的目录，在弹出菜单中可选择“上传部署云函数”、“上传并运行测试云函数”。前者仅完成部署，后者会在部署后同时运行，并打印日志出来。自2.8.1版本起HBuilderX支持云函数本地运行。如下图所示： +编写云函数后，在项目管理器里右键点击该云函数的目录，在弹出菜单中可选择“本地运行云函数”、“上传部署云函数”、“上传并运行云函数”。 -![](https://img.cdn.aliyun.dcloud.net.cn/uni-app/uniCloud/uniCloud-run-function.png) +- 本地运行云函数：即在HBuilderX自带的node环境中运行选中的云函数。云函数连接的数据库和云存储，仍然在云端。（从HBuilderX 2.8.1起支持） +- 上传部署云函数：将云函数部署到uniCloud服务空间，不会运行。（快捷键Ctrl+u） +- 上传并运行云函数会：先上传云函数，并在云端立即执行该云函数。在部署后同时运行，并打印日志出来。有延时，调试时不如本地运行云函数快捷。 -在云函数对应的目录右键可以配置运行测试参数，如下图，选择之后会生成一个形如`${函数名}.param.json`的文件，此文件内容会在云函数`上传并运行`时作为参数传入云函数内。详细用法可参考：[配置运行测试参数](https://uniapp.dcloud.net.cn/uniCloud/quickstart?id=runparam) +在云函数编辑器里，按`Ctrl+r`运行快捷键（或点工具栏的运行），可看到运行云函数的若干菜单。`Ctrl+r`然后回车或选`0`，即可高效的在控制台看到运行结果和日志输出。如下图所示： -在云函数编辑器里，按`Ctrl+r`运行快捷键，或点工具栏的运行，还会直接看到上传并运行云函数的快捷指令。`Ctrl+r`然后回车或选`0`，即可高效的在控制台看到运行结果和日志输出。 +![](https://img.cdn.aliyun.dcloud.net.cn/uni-app/uniCloud/uniCloud-run-function.png) 云函数目前无法断点debug，只能打印`console.log`看日志。 ![](https://img.cdn.aliyun.dcloud.net.cn/uni-app/uniCloud/uniCloud-run-function-2.png) -## 本地运行云函数@runlocal +运行云函数时，如需要给云函数传参，除了在前端传参外，在调试阶段，可以通过配置json文件来传测试参数。 + +在云函数对应的目录右键可以配置运行测试参数，如下图，选择之后会生成一个形如`${函数名}.param.json`的文件，此文件内容会在云函数`上传并运行`时作为参数传入云函数内。详细用法可参考：[配置运行测试参数](https://uniapp.dcloud.net.cn/uniCloud/quickstart?id=runparam) + -自2.8.1版本起HBuilderX支持云函数本地运行，调试云函数更加方便快捷。此外还可以方便批量导入数据及文件，不再受云函数超时限制（云函数上传文件到云存储只有腾讯云支持）。 +## 本地运行云函数注意事项@runlocal -**目前只支持本地运行，本地调试还在开发中** +自2.8.1版本起HBuilderX支持云函数本地运行，调试云函数更加方便快捷。此外还可以方便批量导入数据及文件，不再受云函数超时限制。 + +**目前只支持本地运行，debug断点还在开发中** #### 使用方式 -在要本地运行的云函数上右键选择本地运行 +在项目管理器选择要本地运行的云函数，右键选择本地运行。或者打开这个云函数，按`ctrl+r`回车。 - 如果没有安装本地运行插件，按照提示安装即可 - 如需配置运行参数请参考[配置运行测试参数](https://uniapp.dcloud.net.cn/uniCloud/quickstart?id=runparam) @@ -98,7 +105,7 @@ exports.main = async (event, context) => { **时区问题** -云函数内使用的时区是utc+0，本地运行时使用的是本机时间。在使用时间戳时两者没有差异，但如果要获取年、月、日、小时要注意时区的差异。 +uniCloud云端的云函数使用的时区是utc+0，本地运行时使用的是本机时间，中国一般是+8。在使用“时间戳”时两者没有差异，但如果要获取年、月、日、小时要注意时区的差异。 以下方式可以获取指定时区的年、月、日、小时，可以参考一下 @@ -120,6 +127,8 @@ const hour = getOffsetDate(8).getHours() 请务必注意云函数在本地运行时依然是连接的云端数据库与存储 +云函数上传文件到云存储只有腾讯云支持。当然也可以在前端直接上传文件，此时阿里云腾讯云均支持。 + **Nodejs版本** 服务空间所使用的nodejs版本为8.9，本地运行时使用的本地nodejs可能与服务空间的nodejs版本并不一致，在本地测试之后部署到云端也务必测试一下兼容性。 -- GitLab