如何将基于Awesomium的旧WPF应用重构为使用CEF？

针对你的WPF应用迁移需求，我建议优先使用CefSharp——它是CEF的成熟.NET封装，完美适配WPF场景，能最大限度降低迁移成本，尤其是你已有现成Web界面的情况下。下面是分步的最佳实现方案：

1. 彻底移除Awesomium依赖 #

• 先卸载项目中所有Awesomium相关的NuGet包（如果是通过NuGet安装的），或者删除手动添加的Awesomium程序集引用。
• 清理代码文件中的using Awesomium.Core;、using Awesomium.Windows.Controls;等命名空间引用。
• 遍历XAML文件，删除所有Awesomium控件的命名空间声明（比如xmlns:awesomium="clr-namespace:Awesomium.Windows.Controls;assembly=Awesomium.Windows.Controls"），以及对应的<awesomium:WebControl>标签。

2. 引入CefSharp WPF组件 #

• 通过NuGet安装CefSharp.Wpf包：在NuGet包管理器中搜索并安装，注意选择与你的.NET Framework版本兼容的版本（比如.NET Framework 4.7.2+可以用最新稳定版，旧版本需匹配对应兼容的CefSharp版本）。
• 在应用启动时初始化CEF：打开App.xaml.cs，重写OnStartup方法，添加初始化代码：

  protected override void OnStartup(StartupEventArgs e)
  {
      var settings = new CefSettings();
      // 可根据需求配置缓存路径、日志级别等
      settings.CachePath = Path.Combine(Environment.GetFolderPath(Environment.SpecialFolder.LocalApplicationData), "YourAppName", "CefCache");
      
      // 必须在UI线程初始化
      if (!Cef.Initialize(settings))
      {
          MessageBox.Show("CEF初始化失败，应用将退出");
          Shutdown();
          return;
      }
      
      base.OnStartup(e);
  }
  

• 别忘了在应用退出时清理CEF：在OnExit方法中添加Cef.Shutdown();。

3. 替换Awesomium控件为CefSharp控件 #

• 在需要嵌入Web页面的XAML中，添加CefSharp的命名空间：

  xmlns:cefSharp="clr-namespace:CefSharp.Wpf;assembly=CefSharp.Wpf"
  

• 将原来的<awesomium:WebControl>替换为<cefSharp:ChromiumWebBrowser>，并调整属性：
  • Awesomium的Source属性对应CefSharp的Address属性，或者用Load(string url)方法。
  • 原来的WebControl事件（比如DocumentReady）对应CefSharp的FrameLoadEnd事件，注意事件参数略有不同。

4. 迁移JS与.NET的交互逻辑 #

这是迁移中最需要注意的部分，因为Awesomium和CefSharp的JS绑定机制略有差异：

• Awesomium中创建JS绑定的代码（比如webControl.CreateObject("appBridge");），替换为CefSharp的JavascriptObjectRepository：

  // 假设你的.NET交互类是AppBridge
  chromiumWebBrowser.JavascriptObjectRepository.Register("appBridge", new AppBridge(), isAsync: false);
  

• 如果Web页面中有调用Awesomium特定JS API的代码（比如window.awesomium相关），需要修改为CefSharp兼容的写法——不过如果你的Web界面只是通用HTML/JS，这一步可能不需要调整。

5. 逐个测试引用Awesomium的页面 #

因为你有10-20个页面依赖Awesomium，建议逐个替换后测试：

• 验证页面导航、资源加载是否正常。
• 测试JS与.NET的交互功能（比如点击页面按钮调用WPF方法，或者WPF主动调用页面JS）。
• 处理弹窗场景：Awesomium的PopupWindow事件对应CefSharp的IPopupHandler，实现该接口可以自定义新窗口的行为（比如在新的WPF窗口中打开CefSharp控件）。

6. 清理与优化 #

• 删除所有残留的Awesomium代码、配置文件。
• 根据应用需求调整CEF的配置：比如启用GPU加速、设置渲染进程数量、配置代理等，提升性能和稳定性。

内容的提问来源于stack exchange，提问作者Aistis Ramonas