如何在Visual Studio 2019中查看Serenity项目版本并升级到最新版

你可以通过以下3种常用方式在VS2019环境下快速确认版本：

• 方法1：查看已安装NuGet包
  右键解决方案 -> 选择「管理解决方案的NuGet包」-> 切换到「已安装」标签页，搜索Serenity关键词，所有官方Serenity相关包（如Serenity.Core、Serenity.Web）的版本号即为当前项目使用的版本，正常情况所有Serenity官方包版本是统一的。
• 方法2：查看项目配置文件
  打开项目根目录下的Directory.Build.props文件，找到<SerenityVersion>x.x.x.x</SerenityVersion>节点，节点内的值就是当前项目的Serenity版本号。
• 方法3：运行项目查看
  启动项目登录后台系统后，页面底部页脚位置默认会显示当前Serenity框架的版本标识，无需修改代码即可直接查看。

请按照以下步骤操作，升级前务必做好备份：

• 步骤1：前置备份
  先将整个项目文件夹完整备份，也可以提交所有本地修改到Git仓库，同时导出当前数据库的备份文件，避免升级出错无法回滚。
• 步骤2：更新NuGet依赖包
  右键解决方案 -> 选择「管理解决方案的NuGet包」-> 切换到「更新」标签页，搜索Serenity关键词，选中所有官方Serenity相关包，点击「更新」按钮等待所有包更新完成。
• 步骤3：更新静态资源
  打开项目的appsettings.json配置文件，将Serenity:UpdateResources参数设置为true，启动运行一次项目，框架会自动拉取匹配最新版本的前端静态资源（JS、CSS、模板文件等）。
• 步骤4：执行数据库迁移
  项目启动后会自动检测未执行的框架数据库迁移脚本，按照页面提示执行迁移即可，迁移完成后确认数据库结构无异常。
• 步骤5：验证适配
  测试项目所有自定义功能是否正常运行，如果出现API调用报错，参考框架版本变更说明修改对应废弃的API调用逻辑，所有功能验证通过后，将appsettings.json里的Serenity:UpdateResources改回false，避免每次启动重复拉取资源。

升级注意事项 #

• 如果当前项目版本和最新版差距超过2个大版本，建议分批次逐步升级，不要直接跨多个大版本操作，减少兼容性问题排查成本
• 升级后如果出现编译报错，优先检查所有Serenity相关NuGet包是否都更新到了同一版本，禁止出现不同Serenity包版本混用的情况
• 自定义开发的Serenity扩展、第三方插件需要单独验证和新版本的兼容性，如有问题需要同步更新适配代码

内容的提问来源于stack exchange，提问作者cal jones