DCloud_UNI_CHB
DCloud_UNI_CHB
  • 发布:2021-09-29 13:48
  • 更新:2024-11-07 09:50
  • 阅读:24440

uni-app提供开箱即用的SSR支持

分类:uni-app

SSR(服务端渲染)可以给SPA站点带来两大核心优势:

  • 更好的SEO
  • 更快的首屏渲染

很多uni-app开发者都在积极尝试SSR,但大多没入门就放弃了,原因在于SSR颇高的技术门槛。

vue.js 官网在介绍 SSR 章节时的描述如下:

本指南将会非常深入,并且假设你已经熟悉 Vue.js 本身,并且具有 Node.js 和 webpack 的相当不错的应用经验。

故很多uni-app开发者在社区中呼吁DCloud官方提供更为简洁、开箱即用的 uni-app SSR 方案。

uni-app团队近期在完成 vue 3.0 的全平台升级后,基于vue 3.0 + uniCloud,发布了开箱即用的 SSR 支持,我们称其为uniCloud版SSR

这是一个uniCloud版的SSR示例:news.dcloud.io是基于uni-app & uniCloud 开发的新闻系统。通过审查元素会发现,新闻列表数据包含在服务端下发的源码中,而不是客户端Ajax请求所得。

uniCloud版的SSR实现的较为简单,且和HBuilderX做了深度集成,你可以按照如下步骤快速上手:

步骤一:调整代码适配服务端运行环境

  1. 生命周期:uni-app的生命周期钩子函数中,页面onLoad、组件beforeCreatecreated 会在服务器端渲染 (SSR) 过程中被调用,你需要检查原项目代码中获取数据的时机;
  2. 特定平台API:若直接使用了如 windowdocument,这类仅浏览器支持的全局变量,则会在云端 Node.js 中执行时抛出错误;
  3. 数据预取:<uniCloud-db>组件天然支持SSR,无需调整代码,推荐使用<uniCloud-db>查询数据库。如果你未使用<uniCloud-db>组件,则可使用serverPrefetch来实现服务器端数据获取,使用@dcloudio/uni-app提供的ssrRef或Vue.js官方的Vuex来实现状态同步;

更多详细信息及示例代码,参考:https://uniapp.dcloud.net.cn/collocation/ssr

步骤二:编译发行

通过HBuilderX的发行菜单->网站 PC-Web或手机H5、勾选ssr、勾选将编译后的资源部署在uniCloud前端网页托管

这个过程,对开发者来说很简单,只需要点击按钮即可,实际上HBuilderX在背后做了大量工作,包括:

  1. 编译uni-app项目,分别生成Server BundleClient Bundle
  2. Client Bundle上传到uniCloud前端网页托管中
  3. Server Bundle作为uni-ssr云函数资源,编译并上传到uniCloud服务空间

步骤三:配置 uni-ssr 云函数的URL化路径

uni-ssr云函数绑定自定义域名,然后在浏览器中访问该域名,你就可以获得服务端渲染的页面了。

至此,uniCloud版SSR开发部署工作结束,是不是比原来简单多了?

总结

Vue.js 官网及社区很多文档,介绍SSR时都会提到,SSR是把双刃剑,优点缺点都很明显(2优3缺,缺大于优)。但经过HBuilderX & uniCloud加持的SSR,则完美解决了SSR的部分缺点,将其由缺转优,变成4优1缺,实现优大于缺。具体对比如下:

欢迎大家使用uniCloud版SSR

关联阅读:uni-app官网ssr介绍

47 关注 分享
一抱一个胖猪猪 jaqi l***@163.com 2***@qq.com 1***@139.com 1***@qq.com 6***@qq.com 7***@qq.com 2***@qq.com 4***@qq.com 1***@126.com 9***@qq.com 2***@qq.com 3***@qq.com Jerry_2020 2***@qq.com z***@163.com c***@dingtalk.com 1***@qq.com 1***@qq.com 5***@qq.com 3***@qq.com 1***@qq.com 蒋大海 4***@qq.com 魏贤军 y***@163.com i***@zhian.cc [已删除] 1***@163.com 徐凤英 石兰英 苏耜 s***@qq.com w***@gmail.com 3***@qq.com b***@gmail.com r***@selte.net 1***@qq.com q***@qq.com 7***@qq.com m***@126.com 2***@qq.com 3***@qq.com 1***@qq.com 喜欢技术的前端 HRK_01

要回复文章请先登录注册

t***@gmail.com

t***@gmail.com

还有这个no_matching_function_for_path /,全默认发行
2023-04-28 01:40
t***@gmail.com

t***@gmail.com

根本不行啊,Cannot find module './server/entry-server.js'
2023-04-28 01:25
uni学习中

uni学习中

news的示例代码在哪里下载?
2023-04-25 10:09
ippz

ippz

不需要SSR,H5怎么取消加上去的<a>标签
2023-02-08 09:24
鹤祥晖

鹤祥晖

可以部署到自己独立的windows服务器,有相关的教程吗
2022-12-01 15:41
DCloud_UNI_CHB

DCloud_UNI_CHB (作者)

回复 h***@qq.com :
单独发帖,把具体情况说明一下
2022-08-16 15:38
h***@qq.com

h***@qq.com

根本无法使用啊~~动态请求根本无法进行,是否给个完整示例吗
2022-08-15 18:56
ijiangruyi

ijiangruyi

SSR能自托管吗
2022-07-28 17:13
8***@qq.com

8***@qq.com

回复 DCloud_UNI_CHB :
哦哦哦 好的。 最近打算开发一个SSR的 pc端和H5项目。 有案例么
2022-07-11 11:05
mvlyforever

mvlyforever

### 为什么查看ssr的文档,进去不太对呢?
2022-07-09 09:07