CEF项目Alloy引导程序的移除与迁移指南

背景介绍

CEF(Chromium Embedded Framework)项目在M125版本中对其Alloy运行时进行了重大重构，将其拆分为样式和引导程序两个独立组件。这一变化使得开发者现在可以在使用Chrome引导程序的同时创建Alloy样式的浏览器窗口。随着M128版本的发布，Alloy引导程序已被正式标记为废弃并最终移除。

技术演进

在M125版本之前，CEF支持两种引导程序：Chrome引导程序和Alloy引导程序。Alloy引导程序主要用于外部(原生)父窗口和无窗口(离屏)渲染等场景。从M125开始，开发者可以在使用Chrome引导程序的情况下创建Alloy样式的浏览器，这为最终移除Alloy引导程序代码铺平了道路。

迁移路径

窗口化应用迁移

对于使用Alloy样式的窗口化应用，建议迁移到Chrome样式，因为它提供了更丰富的默认功能。迁移方法很简单，只需在调用CefInitialize之前设置CefSettings.chrome_runtime = true即可。

保持Alloy样式的迁移

如果需要在保持Alloy样式的同时迁移到Chrome引导程序，则需要以下步骤：

1. 在调用CefInitialize之前设置CefSettings.chrome_runtime = true
2. 根据具体使用场景进行额外配置：
   • 外部父窗口：在调用CefBrowserHost::CreateBrowser之前设置CefWindowInfo.runtime_style = CEF_RUNTIME_STYLE_ALLOY
   • 无窗口渲染：Alloy样式为默认选项
   • Views框架：在CefWindowDelegate::GetWindowRuntimeStyle和CefBrowserViewDelegate::GetBrowserRuntimeStyle中返回CEF_RUNTIME_STYLE_ALLOY

行为差异

Chrome引导程序+Alloy样式的组合与原来的Alloy引导程序在以下方面存在显著差异：

1. 默认支持Chrome错误页面
2. DevTools弹出窗口仅支持Chrome样式(不支持无窗口模式)
3. 不再支持Alloy扩展API(M128版本已移除)，Chrome样式浏览器/窗口支持Chrome扩展API

已知问题

在Chrome引导程序+Alloy样式的组合中，开发者需要注意以下已知问题：

1. 文档画中画API无法针对单个浏览器禁用，开发者可以选择让API调用失败或使用默认Alloy样式打开窗口
2. 某些资源路径设置可能需要额外处理
3. 无窗口渲染模式下，主方法需要运行在TID_UI线程上

测试建议

开发者可以使用CEF示例应用程序(Windows/MacOS上的cefclient，Linux上的cefsimple)来测试不同配置组合。通过添加各种命令行标志可以启用或禁用特定功能，例如：

• --enable-chrome-runtime：启用Chrome引导程序
• --disable-chrome-runtime：禁用Chrome引导程序(使用Alloy引导程序)
• --use-alloy-style：启用Alloy样式
• --off-screen-rendering-enabled：启用无窗口渲染
• --use-native：使用外部(原生)父窗口

总结

CEF项目移除Alloy引导程序是框架演进的重要一步，这一变化使得架构更加清晰，同时保持了向后兼容性。开发者需要根据自身应用的特点选择合适的迁移路径，特别注意不同样式和引导程序组合的行为差异。对于遇到的特定问题，可以通过命令行参数或API调用来进行针对性处理。