Chromium CDP 开发（十三）：为自己的Domain建立CustomCDPHandler

引言

在开发 Chromium CDP（Chrome DevTools Protocol）时，除了创建 PDL 和 JSON 文件来定义自定义的 CDP Domain 和指令外，还需要编写对应的 Handler 实现文件，以便使这些自定义指令能够被正确执行。本章将详细介绍如何为自定义的 CDP Domain 创建和实现 Handler 文件 custom_cdp_handler.h 和 custom_cdp_handler.cc，并将其集成到 Chromium 构建系统中。此外，我们还将讨论如何将 Handler 注册到 chrome_devtools_session，以便通过 CDP 系统控制和访问自定义的指令。通过这些步骤，开发者可以让自定义的 CDP 指令和事件在 Chromium 中真正可用。

编写实现文件

在准备好pdl 和 json 文件后我们就具备了自定义生命CDP Domain和指令的能力，接下来我们需要的就是建立handler 实现文件来让CDP真正可用

首先我们在chrome\browser\devtools\protocol 下建立 custom_cdp_handler.h 和 custom_cdp_handler.cc

文件内容如下

custom_cdp_handler.h文件如下

// Copyright 2017 The Chromium Authors
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.
#ifndef CHROME_BROWSER_DEVTOOLS_PROTOCOL_CUSTOM_CDP_HANDLER_H_
#define CHROME_BROWSER_DEVTOOLS_PROTOCOL_CUSTOM_CDP_HANDLER_H_

#include "chrome/browser/devtools/protocol/custom_cdp.h"


class CustomCdpHandler : public protocol::CustomCDP::Backend {
  public:
    CustomCdpHandler(protocol::UberDispatcher* dispatcher,
                    const std::string& target_id);

    CustomCdpHandler(const CustomCdpHandler&) = delete;
    CustomCdpHandler& operator=(const CustomCdpHandler&) = delete;

    ~CustomCdpHandler() override;


    protocol::Response CdpVersion() override;
};

#endif  // CHROME_BROWSER_DEVTOOLS_PROTOCOL_WINDOW_MANAGER_HANDLER_H_

custom_cdp_handler.cc文件如下

#include "chrome/browser/devtools/protocol/custom_cdp_handler.h"


CustomCdpHandler::CustomCdpHandler(protocol::UberDispatcher* dispatcher,const std::string& target_id) {
  // Dispatcher can be null in tests.
  if(dispatcher){
    protocol::CustomCDP::Dispatcher::wire(dispatcher, this);
  }
}

CustomCdpHandler::~CustomCdpHandler(){
}

protocol::Response CustomCdpHandler::CdpVersion(){
  return protocol::Response::Success();
}

然后把两个文件加入到 chrome\browser\devtools\BUILD.gn 的 static_library("devtools") 里面的 sources 部分参与编译

注册Handler到 chrome_devtools_session

当我们的把CustomCDPHandler编写完毕后还需要把CustomCDPHandler注册进chrome_devtools_session上才能让CDP系统控制和访问CustomCDPHandler

我们找到 chrome\browser\devtools\chrome_devtools_session.h

这里先用占位类进行一个占位

声明一个变量寄宿我们的Handler实例

我们找到 chrome\browser\devtools\chrome_devtools_session.cc

先引入头文件

测试我们的CDP

启动浏览器

获取websocket

发送指令

看到响应证明自定义domain 成功

总结

通过本章的内容，我们完成了自定义 CDP Domain 的 Handler 文件 custom_cdp_handler.h 和 custom_cdp_handler.cc 的编写，实现了基本的指令处理功能，并将其集成到 Chromium 构建系统中。我们还成功将 Handler 注册到 chrome_devtools_session，确保自定义指令能够通过 CDP 系统正常运行。最后，我们测试了自定义指令并成功获取响应，证明自定义的 CDP Domain 及其指令已正确生效，为后续功能的扩展提供了坚实的基础。