Quasar CLI with Vite - @quasar/app-vite
SSR的升级指南
本页仅指将Quasar UI v1(使用Vue 2)的应用程序升级到Quasar UI v2(使用Vue 3)。
从Quasar v1升级到Quasar UI v2
Quasar v2的SSR模式几乎完全颠覆了之前的版本,大大改善了开发者的体验。由于Vue 3的架构要求,其中一些变化是必须的。
请注意,目前唯一支持Nodejs的服务器是[Expressjs](https://expressjs.com/)。
改进概述
- 引入了SSR中间件文件的概念,这也允许在开发时为它们提供HMR。这取代了旧的
index.js
和extension.js
。 - 完全相同的中间件现在可以在开发和生产构建中运行,而不仅仅是旧的"SSR扩展"。
- 你也可以为SSR中间件启用提示功能。
- 由于Vue 3的架构,你现在可以(而且需要!)为你的每个自定义Vue指令定义一个SSR转换(Quasar提供的Vue指令不在此范围内)。
- 对Typescript的开箱支持。
src-ssr
下的所有js文件现在都可以被改写成.ts。请务必阅读 使用Typescript的SSR 以了解更多信息。
/src-ssr文件夹
# 旧的结构
.
└── src-ssr/
└── index.js # 为应用程序服务的生产型 Node 网络服务器
└── extension.js # 生产和开发服务器的通用代码
# 新结构
.
└── src-ssr/
└── middlewares/ # SSR中间件文件
└── server.js # SSR webserver生产出口
执行升级
旧的index.js
和extension.js
已经被优秀的SSR中间件文件所取代。在进一步深入研究之前,最好能[阅读一下SSR中间件](/quasar-cli/developing-ssr/ssr-middleware)。
那么我们开始吧。
- 我们建议你把你当前的
src-ssr
文件夹的内容保存在其他地方。 - 删除并重新添加Quasar SSR模式(
$ quasar mode remove ssr
,$quasar mode add ssr
)。 - 在quasar.config.js > ssr > middlewares: []下声明中间件文件。 数组应该看起来像这样:
middlewares: [
'render' // 应该始终把这个作为最后一个。
]
- 然后你将不得不通过使用SSR中间件文件来移植旧的逻辑,这应该非常容易(因为你最终会把大部分旧的代码复制到中间件文件中)。
- 查看quasar.config.js > ssr属性。大多数旧属性已经被删除,并被[新属性](/quasar-cli-vite/developing-ssr/configuring-ssr#quasar-conf-js)取代。
- 检查新的
/src-ssr/server.js
文件。
还要记住,你在src-ssr/middlewares
文件夹中创建的文件也需要在quasar.conf.js > ssr > middlewares下声明。这是因为它们的顺序很重要,就像应用任何Expressjs中间件的顺序也很重要。你可以使用$ quasar new ssrmiddleware <name>
命令来加快进度。
始终保持原始的render
中间件在列表的最后一个。
提示
- 你可能想看看新配置的属性,可通过quasar.conf.js > ssr来查看。
- 你可能想看看ssrContext页面,它详细描述了你可以从中使用哪些属性。
- 你可能想看看SSR Webserver页面,它详细描述了server.js能为你做什么。