CefSharp迁移DotNetBrowser全攻略，漏洞修复 CentOS x86_64 OpenSSH 升级操作文档。

背景与动机

CefSharp 和 DotNetBrowser 都是基于 Chromium 的 .NET 浏览器控件，常用于桌面应用程序的嵌入式浏览器开发。CefSharp 作为开源项目广受欢迎，但存在一些局限性，如内存泄漏、线程模型复杂、许可证限制等。DotNetBrowser 作为商业解决方案，提供了更稳定的 API、更好的技术支持以及更灵活的许可证选项。迁移至 DotNetBrowser 可以解决 CefSharp 的常见问题，同时提升性能和可维护性。

---

迁移步骤

安装与配置 DotNetBrowser

DotNetBrowser 通过 NuGet 包分发，安装过程与 CefSharp 类似。在项目中添加 DotNetBrowser 和 DotNetBrowser.WinForms（或 DotNetBrowser.WPF）包。
配置许可证密钥是必需的，可通过以下代码在应用程序启动时设置：

DotNetBrowser.License.LicenseManager.SetLicenseKey("your-license-key");

DotNetBrowser 默认使用独立模式（每个实例独立进程），无需像 CefSharp 那样手动初始化 CEF。

替换浏览器控件

在 WinForms 或 WPF 中，将原有的 ChromiumWebBrowser 替换为 BrowserView：

// WinForms 示例
var browserView = new BrowserView();
this.Controls.Add(browserView);

DotNetBrowser 的 Browser 类是核心，通过 BrowserView 绑定到 UI。与 CefSharp 不同，DotNetBrowser 的 API 设计更接近标准 .NET 规范。

处理导航与事件

CefSharp 的事件模型（如 FrameLoadEnd）在 DotNetBrowser 中对应为 Navigation.Finished：

browser.Navigation.Finished += (sender, e) => {
    Console.WriteLine("Page loaded: " + e.Url);
};

DotNetBrowser 的事件命名更直观，例如 LoadingFinished 替代 FrameLoadEnd，减少混淆。

执行 JavaScript

DotNetBrowser 通过 MainFrame.ExecuteJavaScript 执行脚本，返回值处理更直接：

var result = await browser.MainFrame.ExecuteJavaScript<string>("document.title");

相较于 CefSharp 的 EvaluateScriptAsync，DotNetBrowser 的方法更简洁。

资源管理与清理

DotNetBrowser 不需要手动处理 CEF 的 Cef.Shutdown。通过 Dispose 释放资源：

browser.Dispose();

内存管理更高效，避免了 CefSharp 中常见的进程残留问题。

---

关键差异与注意事项

线程模型

DotNetBrowser 的 API 调用默认线程安全，无需像 CefSharp 那样频繁使用 InvokeOnUIThread。大部分操作可直接在任意线程执行。

进程模型

DotNetBrowser 支持独立进程和内存渲染模式，后者适合低资源环境。配置通过 EngineOptions 实现：

var engine = EngineFactory.Create(new EngineOptions.Builder {
    RenderingMode = RenderingMode.OffScreen
}.Build());

调试支持

DotNetBrowser 提供内置的远程调试工具，端口默认 9222。通过 Chrome DevTools 直接连接，比 CefSharp 的调试更稳定。

性能优化

DotNetBrowser 的加载速度和内存占用通常优于 CefSharp。建议测试多页面场景下的内存使用情况，调整 Engine 实例的复用策略。

---

迁移后的验证

1. 功能测试：确保所有导航、JS 交互和回调功能正常。
2. 性能测试：对比页面加载时间和内存占用，尤其是长时间运行的应用程序。
3. 异常处理：检查 DotNetBrowser 的异常类型（如 LicenseException），替换原有的 CefSharp 错误处理逻辑。

---

总结

迁移至 DotNetBrowser 可以显著提升嵌入式浏览器的稳定性和开发体验。尽管涉及 API 调整，但清晰的文档和一致的 .NET 设计模式能降低迁移成本。对于需要商业支持或高性能场景的项目，DotNetBrowser 是 CefSharp 的理想替代方案。