Chromium CDP 开发（十）：Chromium 中增加自己的Domain

1. 引言

在深入了解了 Chromium CDP（Chrome DevTools Protocol）的开发过程之后，接下来我们将探讨如何创建一个自定义的 CDP Domain。通过为特定功能创建自己的 CDP Domain，可以避免对已有的 CDP 进行侵入式修改，从而更好地组织和管理新增的指令与事件。在本章中，我们将详细讲解如何分离出独立的 PDL 文件、JSON 配置文件以及对应的 Handler 文件，构建一个全新的、自定义的 CDP Domain。

通过构建自定义 Domain，开发者可以清晰地划分新的功能模块，并且有效提升维护性与开发效率。

2. 为何需要建立自己的 Domain

建立自定义的 CDP Domain 是为了确保我们的扩展功能能够有序地集成到现有的 Chromium CDP 体系中，而不会对原有的指令和事件产生冲突。每个已有的 Domain 都有其明确的功能范围和作用域。如果我们在这些已有的 Domain 中不断增加新的指令和事件，势必会影响原有功能的稳定性和可维护性。因此，最合适的做法是创建一个独立的 Domain，将我们自定义的指令和事件与现有功能分隔开来。

自定义 Domain 的好处在于：

独立性：自定义 Domain 与现有的 CDP 功能模块独立，避免了功能混淆。

可维护性：所有新增功能集中在自定义的 Domain 中，便于后续的维护和扩展。

安全性：降低修改已有 Domain 造成意外错误的风险。

可扩展性：随着功能需求的增加，自定义 Domain 可以灵活扩展，适应新的开发需求。

3. 建立自己的 Domain 需要做哪些工作

要构建一个新的 CDP Domain，我们需要创建并配置几个核心文件。根据之前章节的内容，我们知道 CDP 的关键文件包括 PDL 文件、访问配置文件（JSON），以及实现文件（Handler 文件）。接下来，我们将详细说明如何为自定义的 Domain 创建和配置这些文件。

3.1 方法描述文件：PDL 文件

PDL（Protocol Description Language）文件是定义 CDP 指令和事件的核心文件。每个新的 Domain 都需要有独立的 PDL 文件来描述其方法、参数、返回值以及事件。PDL 文件是 CDP 功能的基础，通过这个文件，协议的结构化描述可以被自动转化为相应的 C++ 头文件和类型定义。

文件路径示例：

third_party\blink\public\devtools_protocol\my_custom_domain.pdl

在此文件中，我们将定义自定义的指令和事件。例如，假设我们需要实现一个新的定时器功能，就可以在 PDL 文件中定义相关指令，如 startTimer、stopTimer，以及定时器触发的事件 timerFired。

3.2 访问配置文件：JSON 文件

inspector_protocol_config.json 是负责管理 CDP 访问权限和功能的配置文件。每个定义在 PDL 文件中的指令和事件，都需要在这个 JSON 文件中进行注册，才能在浏览器中使用。为确保自定义 Domain 的指令和事件能够被识别和调用，我们需要在这个文件中为新创建的 Domain 配置访问权限。

文件路径示例：

chrome\browser\devtools\inspector_protocol_config.json

在配置文件中，我们需要为新 Domain 添加指令和事件的声明。这样，浏览器的 DevTools 工具才能正确解析并调用自定义的指令和事件。

3.3 实现文件：Handler 文件

Handler 文件是负责处理 CDP 指令和事件逻辑的 C++ 文件。每个 Domain 都会有对应的 Handler 文件，用于响应来自客户端的指令，执行相应的操作，并返回结果。我们需要为自定义的 Domain 创建一个新的 Handler 文件，并在其中实现所有自定义指令的具体逻辑。

文件路径示例：

chrome\browser\devtools\protocol\my_custom_domain_handler.h

chrome\browser\devtools\protocol\my_custom_domain_handler.cc

在 Handler 文件中，我们将实现所有在 PDL 文件中定义的指令。以定时器功能为例，我们将在 my_custom_domain_handler.cc 中实现 startTimer 和 stopTimer 的功能逻辑，并通过事件机制定期发送 timerFired 事件。