CEF3提供了UI窗口生命周期接口CefLifeSpanHandler，借助这个接口来监听新窗口创建事件，并在创建前取消窗口创建，使用已有窗口来加载新链接。

class CefLifeSpanHandler : public virtual CefBaseRefCounted {
 public:
  ///由UI线程调用，调用时机是新浏览窗口创建前。
  // frame 弹出新窗口链接的源frame（即从哪个frame里的链接弹出新窗口）
  // target_url 目的链接
  // target_frame_name 目的frame名字
  // 返回true，则表示要取消窗口创建
  virtual bool OnBeforePopup(CefRefPtr browser,
                             CefRefPtr frame,
                             const CefString& target_url,
                             const CefString& target_frame_name,
                             WindowOpenDisposition target_disposition,
                             bool user_gesture,
                             const CefPopupFeatures& popupFeatures,
                             CefWindowInfo& windowInfo,
                             CefRefPtr& client,
                             CefBrowserSettings& settings,
                             CefRefPtr& extra_info,
                             bool* no_javascript_access) 
{
    frame->LoadURL(target_url); //在当前frame中加载链接
    return true; //返回true，取消窗口创建
}

class CefDownloadHandler : public virtual CefBaseRefCounted {
 public:
  /// 文件下载前调用
  // suggested_name  （建议的）文件保存名
  // callback  回调，用来通知下载动作继续进行。默认情况下，如果不主动调用这个回调，则会取消下载动作。
  virtual void OnBeforeDownload(
      CefRefPtr browser,
      CefRefPtr download_item,
      const CefString& suggested_name,
      CefRefPtr callback) = 0;

  /// 用来通知下载状态信息，包括下载进度、总大小、已完成大小、是否完成等；这个方法可能会被调用多次，以用来持续更新下载状态
 // download_item  下载项，下载的状态信息保存在这里。
 // callback  回调，用来取消/暂停/恢复/下载。默认情况下，如果不主动调用这个回调，则会继续下载。
  virtual void OnDownloadUpdated(CefRefPtr browser,
                                 CefRefPtr download_item,
                                 CefRefPtr callback) {}
};

需要注意的是，上面两个方法都有一个download_item参数，这个参数是不能在上面两个方法的作用域外使用的。

定义一个变量，用来控制是使用默认UA还是Android UA

static bool s_UerAgentAndroid = false;

添加右键菜单

// 添加菜单枚举
enum client_menu_ids {
    CLIENT_ID_SHOW_DEVTOOLS = MENU_ID_USER_FIRST,
  ...
  ....
    CLIENT_ID_UserAnget,
};

// 修改菜单项和菜单事件处理
void ClientHandler::OnBeforeContextMenu(CefRefPtr browser,
                                        CefRefPtr frame,
                                        CefRefPtr params,
                                        CefRefPtr model) {
    ......
    ......
    //添加菜单项
    model->AddItem(CLIENT_ID_UserAnget, s_UerAgentAndroid ? "默认UA":"Android UA");
  if (delegate_)
    delegate_->OnBeforeContextMenu(model);
}

bool ClientHandler::OnContextMenuCommand(CefRefPtr browser,
                                         CefRefPtr frame,
                                         CefRefPtr params,
                                         int command_id,
                                         EventFlags event_flags) {
  CEF_REQUIRE_UI_THREAD();

  switch (command_id) {
     ......
     ......
     //菜单事件处理
    case CLIENT_ID_UserAnget:
          s_UerAgentAndroid = !s_UerAgentAndroid;
          browser->Reload(); // 修改UA后重新加载网页
          return true;
    default:  // Allow default handling, if any.
      return ExecuteTestMenu(command_id);
  }
}

下面就是对每一个请求修改HTTP报文的User-Agent。CEF3会将网页所有资源请求事件通知给CefRequestHandler或其子类处理，其OnBeforeResourceLoad是在http请求发出前的处理点，修改相应内容，代码如下

cef_return_value_t ClientHandler::OnBeforeResourceLoad(
    CefRefPtr browser,
    CefRefPtr frame,
    CefRefPtr request,
    CefRefPtr callback) {
    ......
    ......
    if (s_UerAgentAndroid) {
       //设置UA字段
        request->SetHeaderByName("User-Agent", "Mozilla/5.0 (Android5.1.1)", true);
    }
  return resource_manager_->OnBeforeResourceLoad(browser, frame, request,
                                                 callback);
}

我们要做的就是仿照这个菜单，添加新的菜单项。
根据关键字搜索，可以找到client_handler.cpp文件，有两函数OnBeforeContextMenu、OnContextMenuCommand，用来处理菜单项。修改这两个函数，增加新的菜单项，例如重新加载当前页面。

///
enum client_menu_ids {
  CLIENT_ID_SHOW_DEVTOOLS = MENU_ID_USER_FIRST,
  ....
  CLIENT_ID_TESTMENU_RADIOITEM3,
  CLIENT_ID_RELOAD_PAGE /// 添加一个菜单项枚举
};

void ClientHandler::OnBeforeContextMenu(CefRefPtr browser,
                                        CefRefPtr frame,
                                        CefRefPtr params,
                                        CefRefPtr model) {
        ///在菜单显示前，处理菜单项
        ....
          model->AddItem(CLIENT_ID_RELOAD_PAGE, "重新加载页面");
       ....

}

bool ClientHandler::OnContextMenuCommand(CefRefPtr browser,
                                         CefRefPtr frame,
                                         CefRefPtr params,
                                         int command_id,
                                         EventFlags event_flags){
  ///对应菜单项的响应处理
    switch (command_id) {
    case CLIENT_ID_RELOAD_PAGE:
       browser->Reload();
      return true;
     case CLIENT_ID_SHOW_DEVTOOLS:
     .....
     ...
     }
}

至此，添加右键菜单的需求实现了。
再回过来看看ClientHandler，看它的定义

class ClientHandler : public CefClient,
                      public CefContextMenuHandler,
                      public CefDisplayHandler,
                      public CefDownloadHandler,
                      public CefDragHandler,
                      public CefFocusHandler,
                      public CefKeyboardHandler,
                      public CefLifeSpanHandler,
                      public CefLoadHandler,
                      public CefRequestHandler,
                      public CefResourceRequestHandler 

ClientHandler采用多继承方式，把上下文菜单、显示状态、下载、拖拽、焦点、键盘等浏览器事件集中起来处理，如果我们要修改相关需求，改变ClientHandler的对应实现就可以了。

那么ClientHandler是在什么时候注册到事件循环中的？通过断点查看调用栈，大致的过程如下：

CefBrowserHost::CreateBrowser() 创建浏览器窗口
-> CefClientCppToC::Wrap()
-> CefClientCppToC::CefClientCppToC() 设置浏览器的事件处理句柄
-> 进入消息循环
-> 分发消息事件
-> client_get_context_menu_handler() 处理上下文菜单事件
-> CefContextMenuHandlerCppToC::Wrap()
-> CefContextMenuHandlerCppToC::CefContextMenuHandlerCppToC() 设置上下文菜单的过程处理句柄（显示前、点击、消失等）
-> context_menu_handler_on_before_context_menu() c函数 显示前处理
-> ClientHandler::OnBeforeContextMenu() c++函数 显示前处理

然后，点击Configure按钮，配置IDE参数

正常情况下，下图到参数是自动生成的

点击Generate按钮，生成IDE工程文件

打开IDE工程文件，直接以Debug模式运行cefclient这个项目，可以看到一个十分简单的浏览器页面出现了

我不选择手动构建，一是因为没有合适的硬件资源，二是构建好的二进制产品可以很方便的从这里下载。
https://cef-builds.spotifycdn.com/index.html

上面这个网站提供包括32/64位以及RAM架构的CPU下的Linux/MacOS/Windows平台的构建产品；
提供的版本有两种，一种是稳定版本（Current Stable Build (Preferred)），一种是Beta版本（Current Beta Build (For Testing)）。

本文选择的是MacOS-64-Standard Distribution版本，https://cef-builds.spotifycdn.com/cef_binary_97.1.7%2Bg45ce543%2Bchromium-97.0.4692.99_macosx64.tar.bz2