CefSharp项目迁移至chromiumembeddedframework.runtime NuGet包指南

背景介绍

CefSharp是一个基于Chromium Embedded Framework(CEF)的.NET封装库，它允许开发者在.NET应用程序中嵌入完整的网页浏览器功能。随着技术的发展，CefSharp项目正在进行重要的包依赖关系调整，将原有的cef.redist包迁移至新的chromiumembeddedframework.runtime包。

迁移原因

此次迁移主要基于以下几个技术考量：

1. 统一包管理：项目已经在新版.NET Core包中使用chromiumembeddedframework.runtime，现在需要统一所有平台的包引用方式
2. 存储限制：原有的MyGet存储空间已达到500MB上限，需要减少重复内容
3. 现代化支持：新包结构更适合支持.NET Core 3.1及.NET 5/6/7/8+等现代框架

迁移影响

此次变更属于破坏性变更(breaking change)，主要影响以下方面：

• 使用旧版cef.redist.x64和cef.redist.x86包的项目
• 仍在使用packages.config方式管理NuGet包的项目

迁移步骤

对于新项目

直接引用最新的CefSharp.Wpf、CefSharp.WinForms或CefSharp.OffScreen包即可，系统会自动处理依赖关系。

对于现有项目

1. 升级主包：首先升级项目中的主包引用（如CefSharp.Wpf、CefSharp.WinForms等）
2. 检查冗余包：升级后检查项目中是否仍存在cef.redist.x64或cef.redist.x86引用
3. 移除旧包：确认可以安全移除旧版cef.redist包（这些包通常会有较旧的版本号）

技术细节

新的包依赖关系将使用以下两个核心包：

• chromiumembeddedframework.runtime.win-x64
• chromiumembeddedframework.runtime.win-x86

虽然包名和结构有所变化，但实际包含的文件内容与旧包完全相同，只是组织方式更适合现代.NET项目结构。新包中的.props和.targets文件设计为向后兼容，大多数项目无需额外配置即可正常工作。

注意事项

1. 对于仍在使用packages.config的项目，建议考虑迁移至PackageReference方式管理NuGet包
2. 迁移过程中如果遇到问题，可检查项目文件中是否残留旧包的引用
3. 新包的自动部署和构建系统集成方式与旧包基本一致

总结

此次迁移是CefSharp项目现代化进程中的重要一步，开发者应及时更新项目依赖以确保获得最新的功能和安全更新。虽然变更涉及底层依赖包，但由于保持了文件内容的兼容性，大多数项目可以平滑过渡。