背景

   cef是一种跨平台的框架，属于chrome内核，可以用来显示web相关页面。目前在咚咚工作台上使用，显示聊天框，历史消息，插件页面等等。之前只是在win平台上使用，在今年开发mac版本商家咚咚过程中，完成了mac版本的适配，积累了一些在两个平台上的使用方法，避免以后再踩坑。

一. 库和资源文件

  基本的库文件包含了多个文件夹和资源文件，这些是运行cef时必须要依赖的，因此需要打包在安装包中。

表1.1 cef依赖文件  

  以上是cef运行时所依赖的所有文件，其中include和libcef_dll, 可以组合生成一个lib静态库，一般名称为libcef_dll_wrapper.lib，在其它模块中需要依赖该cef头文件时，导入lib库即可。

  在升级cef版本的过程中，只需要替换替换对应的文件夹中的文件，就可以升级到对应的版本，目前最新的100以上的版本，基本都是这些固定的文件格式。

  如果添加了新的文件或者依赖库，则需要添加对应的库和资源。

二. 文件路径查找

 资源文件，需要设定路径才能找到对应的文件，在CefSettings指定对应的路径。

表2.1 cef资源路径设置

 2.1 对于资源路径，win版本可以放到同一目录下面，例如在安装目录下，新建一个CEF目录，专门用来放置资源文件：

  2.2 dll库则在主安装目录下面：

 2.3 mac版本的目录文件基本是固定的：

 Chromium Embedded Framework.framework

 一般可以放置到app包的顶层或者Frameworks目录下面

 以上的路径，都需要明确指定绝对路径，即完整的访问路径资源，不能使用相对路径，比如../../../之类的，因此在程序内部，需要专门封装查找资源路径的方法，这样在应用安装到用户电脑上，才能准确找到对应的资源。

 若资源文件无法找到，则在后续的初始化，第一步就会报错，只有找到文件，才能进行后续的步骤。

三. 主进程初始化

 主进程初始化分为多个步骤：

3.1 加载cef动态库

  如果将libcef库放置在标准目录下面，即win是exe同级目录，则无需查找动态库，系统可以自行查找到，如果放到其它目录，则需要采用动态加载库的方式。

  mac可以使用cef提供的标准方法：

  CefScopedLibraryLoader library_loader;

  library_loader.LoadInMain()

  来直接加载主进程库。

  若采用显示路径来加载的方式，可以指定

  Chromium Embedded Framework.framework下面的Chromium Embedded Framework，整个的完整路径

  然后使用cef提供的方法：cef_load_library，加载指定路径下的主进程文件。

  加载主库必须成功，失败则直接返回，后续一切步骤都依赖主进程的加载完成。

3.2 获取启动参数

  启动的时候，都需要使用CefMainArgs，来获取命令行的参数

表3.1 cef获取启动命令

   接着生成 CefRefPtr<ClientApp> app，这个类继承自cef的基本app类：CefApp

   继承ClientApp，来生成主进程方法：

   app = new ClientAppBrowser();

3.3 设置其它参数

   设置日志级别：settings.log_severity

   日志目录：settings.log_file

   浏览器版本和说明：settings.user_agent

   调试时的端口：settings.remote_debugging_port

3.4 主进程初始化

   直接调用CefInitialize(main_args, settings, app.get(), sandbox_info)

   传入命令，设置选项，app实例，sandbox的内容，通常来说sandbox为空，不启用即可

   返回成功可以进行后续步骤，失败表示主进程启动异常，后续也无法显示页面。

四.渲染进程生成

   渲染进程，可以采用和主进程合并模式，也可以采用单独的进程。一般比较大型或者复杂的项目，都需要单独的进程，并为了不同的页面，还需要启动多个子进程。

   启动流程和主进程类似，先加载子进程路径，再获取命令行参数，继承CefApp启动实例，最后再初始化。

   进程名称，win可以自己定义，mac有严格限制，必须以xxx Helper结尾，否则找不到对应的渲染子进程。

表1.1 cef子进程名称

4.1 子进程的路径，理论上可以设置到专门的目录下面，但也可以让系统去默认路径查找，即和主应用同级别即可。

   加载cef资源的时候，win版本在主应用同级别的exe，不用专门的方法去加载。

   mac版本需要使用cef的专用方法：

   CefScopedLibraryLoader library_loader;

   library_loader.LoadInHelper()

   若是需要专门的路径，则仍然使用cef_load_library去加载库的绝对路径，加载成功后，才能正常初始化子进程。

4.2 在最后初始化时，可以直接调用cef的方法：

   CefExecuteProcess(main_args, app, nullptr)

   返回值大于0，表示启动子进程已经成功，可以开启渲染页面等操作。

   返回值小于0，表示启动子进程失败，页面将无法进行渲染，但是不影响主进程的正常运行。

   子进程实现的最好方式，是将所有的依赖文件，都集成在同一个模块工程中，不依赖其它的模块，这样在编译运行的时候，就不会由于依赖过多导致各种错误。

五. 消息循环

   不同的系统版本中，采用不同的消息循环模式，需要和主应用的消息循环合作运行。

5.1 在win版本中，可以通过设置multi_threaded_message_loop为true的参数，开启浏览器多线程模式。能够和主应用的主消息循环并行处理运行。

 如图所示，win应用中，在main方法中需要开启主界面的消息循环，这里的消息循环就一直在UI主线程中运行，直到应用退出，消息循环主线程才会结束退出。

 另外在cef的浏览器主进程中，也同时开启多线程消息循环，此时Browser独享自己的消息循环线程，和主消息循环互不影响，可以实时的收到界面的点击响应和显示web界面等。

5.2 在mac版本中，有两种cef消息循环方式

   第一种：直接将主应用的消息循环设置为cef的消息循环，即所有的消息接收和传递，都在CefRunMessageLoop()中进行，此时cef的消息循环占据了主导地位，主界面的按钮点击等操作，都需要cef抛出并提交给主线程。

   第二种：当mac中采用了Qt等框架时，它本身有自己的消息主循环，而cef在mac中无法再开启自己的消息主循环，也不支持采用多线程机制单独运行。因此采用了将cef消息循环嵌入到Qt的消息循环中的方式，相当于时间片分割方式，到了定时时间，去专门处理cef的事件响应。

 主循环消息启动后，生命周期跟随主应用，一直到应用退出才会结束。此时定一个时间片分割，时间自定义，可以50帧也就是每隔20ms处理一次。

 当定时周期到的时候，就执行cef的消息循环处理，在CefDoMessageLoopWork()中去处理cef的具体事件响应。

 另外在cef本身的回调中，也可以使用onScheduleMessageLoopWork()中拿到事件，然后到cef事件循环中去处理。

 这样主循环和cef自己的的循环，就不断运行起来，在用户使用时，感觉不到这个细微的延时差距，主界面和cef界面基本都是在同时响应。

六.窗口适配

 在界面显示过程中，打开网页或者本地页面时，通常需要重新修改窗口尺寸。在不同的版本需要不同的处理方式：

表6.1 cef窗口适配

 在创建一个浏览器窗口时，需要调用SetAsChild设置浏览器的子窗口，这里首先获取当前生成的窗口id，可以直接用CefWindowHandle来进行转换。

 在重绘窗口大小的时候，需要移动窗口，调整高和宽，这里cef没有提供通用的方法，只能使用不同平台的原生方法，因此调用了操作系统的系统接口。

 获取窗口可以直接使用cef内部封装好的GetWindowHandle，这个是通用的接口，需要在UI线程中调用，但是在一些特殊的web窗口中，需要使用GetOpenerWindowHandle来获取非pop窗口的句柄，从而操作窗口界面正常显示。

七.版本区分

 7.1 操作系统版本区分可以直接使用开源库的方法：

  win系统：Q_OS_WIN

  mac系统：Q_OS_MAC

  当需要区分使用不同操作系统的接口，或者调用对应系统的原生方法时，需要使用该宏定义进行区分处理。

 7.2 cef版本区分，可以使用cef_version中的定义：

  #define CEF_VERSION_MAJOR 106

  #define CEF_VERSION_MINOR 1

  #define CEF_VERSION_PATCH 0

  #define CEF_COMMIT_NUMBER 2678

  通常来说，若应用程序中，同时存在多个cef版本，比如89，106等，主要是主版本号不同，则直接判断CEF_VERSION_MAJOR的数值即可，另外的三个小版本可以不做过多关注，若大版本相同，则需要进行小版本的详细区分。

  不同的cef大版本，接口基本是一样的，但是当相差几十个版本的cef库时，则会出现接口参数变更，或者名称变化，新增部分接口等差异点，则需要在不同版本进行对应的处理和适配。

结尾

   使用cef在win和mac上用的同一套文件，利用Qt的宏定义对平台进行了区分，利用cef版本对不同版本进行兼容，因此同样的源代码文件，在两个平台都可以运行，不同的cef版本也可以同时运行，比较方便维护升级。

   后续可以继续完善，形成更多不同的功能，并进一步拆分成独立的模块，让大家少走一些弯路。