本页仅指将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中间件文件
    └── directives/ # Vue指令的SSR转换

执行升级

旧的index.js和extension.js已经被优秀的SSR中间件文件所取代。在进一步深入研究之前，最好能[阅读一下SSR中间件]（/quasar-cli/developing-ssr/ssr-middleware）。

那么我们开始吧。

1. 我们建议你把你当前的src-ssr文件夹的内容保存在其他地方。
2. 删除并重新添加Quasar SSR模式（$ quasar mode remove ssr, $quasar mode add ssr）。
3. 在quasar.config.js > ssr > middlewares: []下声明中间件文件。 数组应该看起来像这样：

middlewares: [
  ctx.prod ? 'compression' : '',
  'render' // 应该始终把这个作为最后一个。
]

4. 然后你将不得不通过使用SSR中间件文件来移植旧的逻辑，这应该非常容易（因为你最终会把大部分旧的代码复制到中间件文件中）。
5. 查看quasar.config.js > ssr属性。大多数旧属性已经被删除，并被[新属性]（/quasar-cli/developing-ssr/configuring-ssr#quasar-conf-js）取代。

还要记住，你在src-ssr/middlewares文件夹中创建的文件也需要在quasar.conf.js > ssr > middlewares下声明。这是因为它们的顺序很重要，就像应用任何Expressjs中间件的顺序也很重要。你可以使用$ quasar new ssrmiddleware <name>命令来加快进度。

始终保持原始的render中间件在列表的最后一个。

提示

• 你可能想看看新配置的属性，可通过quasar.conf.js > ssr来查看。
• 你可能想看看ssrContext页面，它详细描述了你可以从中使用哪些属性。
• 你可能想看看SSR生产输出页面，它详细描述了production-export.js/ts能为你做什么。