在Chromium 88中如何添加供JavaScript调用、挂载到window.external的C++函数
Chromium 88 定制浏览器:JS调用自定义C++能力的源码修改与window.external挂载指南
注:该问题对应的技术实现说明更新于2020年11月27日,匹配Chromium 88的源码版本特性。
需修改/新增的核心源码文件
基于Chromium 88的标准目录结构,涉及的核心修改点按模块拆分如下:
- 渲染进程Blink绑定层
third_party/blink/renderer/modules/external/external.idl:原生window.external的JS接口定义文件third_party/blink/renderer/modules/external/external.cc:window.external对应的C++实现类third_party/blink/renderer/core/frame/local_dom_window.cc:window对象初始化时绑定external实例的逻辑
- 跨进程通信层
content/public/common/renderer.mojom:渲染进程与浏览器进程的Mojo通信接口定义content/renderer/render_frame_impl.cc:渲染帧侧的消息路由转发逻辑content/browser/renderer_host/render_frame_host_impl.cc:浏览器进程侧的渲染帧消息接收入口
- 业务逻辑层
- 可根据需求新建自定义消息处理类(如
custom_native_message_handler.cc/.h),仅需在对应模块的BUILD.gn中添加编译规则即可参与编译
- 可根据需求新建自定义消息处理类(如
window.external挂载自定义C++函数的完整实现流程
Chromium 88的多进程架构决定了JS运行在渲染进程,原生C++业务逻辑通常运行在浏览器进程,两者通过Mojo通道通信,具体步骤如下:
- 定义JS侧可见的接口声明
打开原生external.idl文件,参照现有方法的IDL语法,新增要暴露给JS的自定义方法。例如要实现让JS调用window.external.postMessageToBrowser(content),就直接在IDL中声明该方法的入参、返回值类型,Blink编译时会自动生成对应的V8绑定胶水代码,无需手写底层V8适配逻辑。注意:IDL中使用的类型必须是Web IDL规范支持的原生类型(字符串、数字、布尔值等),不能直接传入自定义C++类实例。
- 补全渲染进程侧的转发逻辑
在external.cc中实现刚才在IDL里声明的方法:不要在这里直接写业务逻辑,仅需要获取当前渲染帧的Mojo通信通道,把JS传入的参数序列化后通过通道发送到浏览器进程即可。实现时要持有渲染帧的弱引用,避免页面销毁后悬空指针导致渲染进程崩溃。 - 完善Mojo跨进程接口定义
在对应的mojom文件中新增自定义的通信方法,指定入参的序列化规则,绑定到对应渲染帧的消息路由上,确保消息能准确从渲染进程投递到浏览器进程的对应处理模块。 - 实现浏览器进程侧的业务逻辑
在render_frame_host_impl.cc或自定义的消息处理类中,实现Mojo接口的接收方法——这部分就是真正的C++业务逻辑实现空间:收到网页发来的消息后,可以调用系统API、读写本地文件、触发浏览器自定义功能,也可以反向通过Mojo通道向网页推送消息。 - 增加安全校验逻辑
必须在调用入口加页面来源校验:仅放行在白名单内的页面源才能调用自定义C++接口,避免任意第三方网页触发原生能力造成安全风险。 - 编译规则适配
把新增的源文件、IDL文件加到对应模块的BUILD.gn编译列表中,重新执行gn生成流程完成全量编译。
避坑提示:Chromium 88已基本淘汰旧的同步IPC机制,跨进程调用尽量使用异步Mojo实现,避免同步等待导致渲染进程无响应,不要照搬CEF或老版本Chromium的单进程绑定实现逻辑。
内容的提问来源于stack exchange,提问作者windowswind
相关产品推荐
相关产品推荐

