diff --git a/docs/collocation/ssr.md b/docs/collocation/ssr.md index 6de82ecdb9030432c90e6a5accf8034503dc723f..7724ef73dbab88f6ffc49915b39e0baa045fa6ab 100644 --- a/docs/collocation/ssr.md +++ b/docs/collocation/ssr.md @@ -165,9 +165,31 @@ export default { #### 发行与部署@distribute -- 部署到`uniCloud` - * 开通[uniCloud](https://unicloud.dcloud.net.cn)以及[前端网页托管](https://uniapp.dcloud.net.cn/uniCloud/hosting) - * 配置`vite.config.js`中的`base`为`前端网页托管`地址 +发行ssr会得到两部分内容,云端部分和静态资源部分。在uniCloud内部署需要将云端部分部署到云函数内,静态资源部分部署在前端网页托管内。 + +##### 部署到`uniCloud`@distribute-unicloud + +**前置步骤** + +- 开通[uniCloud](https://unicloud.dcloud.net.cn)以及[前端网页托管](https://uniapp.dcloud.net.cn/uniCloud/hosting) +- 云函数绑定自定义url化域名,参考文档:[云函数Url化](https://uniapp.dcloud.net.cn/uniCloud/http) +- 前端网页托管绑定自定义域名,参考文档:[前端网页托管配置域名](https://uniapp.dcloud.net.cn/uniCloud/hosting?id=domain) +- 将前两步部署的域名都配置在跨域配置内,即允许云函数跨域访问前端网页托管内的资源,也允许前端网页托管跨域访问云函数。参考文档:[H5中使用uniCloud的跨域处理](https://uniapp.dcloud.net.cn/uniCloud/quickstart?id=useinh5) +- 从插件市场导入[uni-ssr](https://ext.dcloud.net.cn/plugin?id=5338)到项目内 + +**编译发行** + +> 自动部署 + +需要HBuilderX版本`3.2.7`及以上版本 + +- 通过`HBuilderX`的`发行菜单->网站 PC-Web或手机H5`、勾选`ssr`、勾选`将编译后的资源部署在uniCloud前端网页托管` +- 配置`uni-ssr`的云函数URL化路径,请参考文档:[云函数URL化](https://uniapp.dcloud.net.cn/uniCloud/http) + +> 手动发行部署 + +- 配置`vite.config.js`中的`base`为`前端网页托管`地址 + ```js import { defineConfig @@ -181,13 +203,21 @@ export default defineConfig({ ], }) ``` - * 编译: - > cli工程:`npm run build:h5:ssr`或通过`HBuilderX 3.1.16及以上版本`的`发行菜单->网站 PC-Web或手机H5`、勾选`ssr` + +- 编译: + + cli工程:`npm run build:h5:ssr`或通过`HBuilderX 3.1.16及以上版本`的`发行菜单->网站 PC-Web或手机H5`、勾选`ssr` + + 非cli工程:通过`HBuilderX 3.1.16及以上版本`的`发行菜单->网站 PC-Web或手机H5`、勾选`ssr` ![以ssr模式发行](https://vkceyugu.cdn.bspapp.com/VKCEYUGU-f184e7c3-1912-41b2-b81f-435d1b37c7b4/d7574ced-e253-4b73-8187-86d6a8811364.jpg) - * 部署静态资源到[前端网页托管](https://uniapp.dcloud.net.cn/uniCloud/hosting) - > 将编译后的`dist/build/h5/client`中的资源上传至前端网页托管,推荐使用免费的阿里云服务空间 - * 部署`uni-ssr`云函数 - > 从插件市场导入[uni-ssr](https://ext.dcloud.net.cn/plugin?id=5338),将编译后的`dist/build/h5/server`目录拷贝至`uni-ssr`云函数根目录,并上传。备注:阿里云的云函数绑定自定义域名功能正在调试中,现阶段推荐使用腾讯云版本的云函数。 - * 配置`uni-ssr`的云函数URL化路径,请参考文档:[云函数URL化](https://uniapp.dcloud.net.cn/uniCloud/http) \ No newline at end of file +- 部署静态资源到[前端网页托管](https://uniapp.dcloud.net.cn/uniCloud/hosting) + + 将编译后的`dist/build/h5/client`中的资源上传至前端网页托管,推荐使用免费的阿里云服务空间 + +- 部署`uni-ssr`云函数 + + 将编译后的`dist/build/h5/server`目录拷贝至`uni-ssr`云函数根目录,并上传。 + +- 配置`uni-ssr`的云函数URL化路径,请参考文档:[云函数URL化](https://uniapp.dcloud.net.cn/uniCloud/http) \ No newline at end of file diff --git a/docs/uniCloud/quickstart.md b/docs/uniCloud/quickstart.md index 94b1267fa1190556270f25d0075fdc1c2da47b7b..8a4847df98dc033d0f508bbcd39b0f54c2e1d330 100644 --- a/docs/uniCloud/quickstart.md +++ b/docs/uniCloud/quickstart.md @@ -233,9 +233,10 @@ exports.main = async (event, context) => { "h5": { "launchtype" : "remote" // h5平台连接云端云函数 }, - "provider" : "aliyun", // 如果项目仅关联一个服务空间无需此参数 - "type" : "uniCloud" // 标识此项配置为uniCloud配置,必填 - } + "provider": "aliyun", // 如果项目仅关联一个服务空间无需此参数 + "type": "uniCloud", // 标识此项配置为uniCloud配置,必填 + "systemLog": false // 设置为false之后关闭云函数控制台的系统日志(主要是云函数入参、返回值,错误信息不会关闭) + } ] } @@ -471,7 +472,9 @@ H5前端js访问云函数,涉及跨域问题,导致前端js无法连接云 **注意** -- 目前阿里云跨域配置不对云存储及前端网页托管生效,表现为云存储中图片绘制到canvas会[污染画布](https://developer.mozilla.org/zh-CN/docs/Web/API/Canvas_API/Tutorial/Using_images#Using_other_canvas_elements),前端网页托管的网页不可在iframe中使用 +`2021年9月16日`之前阿里云跨域配置不对云存储及前端网页托管生效,表现为云存储中图片绘制到canvas会[污染画布](https://developer.mozilla.org/zh-CN/docs/Web/API/Canvas_API/Tutorial/Using_images#Using_other_canvas_elements),前端网页托管的网页不可在iframe中使用。 + +`2021年9月16日`之后阿里云跨域配置可以对前端网页托管生效,**仅对前端网页托管的自定义域名生效,不对默认域名生效,如何绑定自定义域名请参考:[前端网页托管绑定自定义域名](uniCloud/hosting.md?id=domain)**,设置之后可能需要几分钟才会生效。如果你在之前已经设置了跨域域名和前端网页托管的自定义域名,需要重新设置一次跨域域名才能生效。 ## cli项目中使用uniCloud diff --git a/docs/uniCloud/release.md b/docs/uniCloud/release.md index aa20773284ffceefa532f990c107b507ca651cd4..054d4faed4efe0afb840b2a1af905404fd91ddb4 100644 --- a/docs/uniCloud/release.md +++ b/docs/uniCloud/release.md @@ -1,5 +1,8 @@ 注:本更新日志仅限uniCloud,包括uniCloud web控制台、uniCloud 云端运行环境。这些更新不跟随HBuilderX发版更新。 +#### 2021-09-16 + + 阿里云 调整 跨域配置对前端网页托管自定义域名生效 [详情](https://uniapp.dcloud.net.cn/uniCloud/quickstart?id=useinh5) + #### 2021-09-01 + 【重要】clientDB 新增 支持使用 getTemp 对主表、副表过滤后再联表查询,大幅提升联表查询性能 [详情](https://uniapp.dcloud.net.cn/uniCloud/clientdb?id=lookup-with-temp) + 阿里云 新增 redis扩展能力,加速云函数响应 [详情](https://uniapp.dcloud.net.cn/uniCloud/redis)