当前位置：首页 > 行业动态 > 正文

如何使用CEF JS向C++发送消息？

admin
行业动态
2024-12-04
3840

CEF JS向C发送消息，需使用特定的接口或方法，如SendMessage或PostMessage。

在现代软件开发中，跨语言通信是一个常见的需求，CEF（Chromium Embedded Framework）作为一个开源的浏览器框架，允许开发者将Chromium浏览器嵌入到自己的应用程序中，而JavaScript作为一种广泛使用的脚本语言，经常需要与底层的C/C++代码进行交互，本文将详细介绍如何在CEF环境下，通过JavaScript向C/C++发送消息。

如何使用CEF JS向C++发送消息？第1张

CEF与JS交互

CEF提供了一个丰富的API，使得JavaScript可以方便地与C/C++进行交互，这种交互通常通过CEF的消息传递机制来实现，包括IPC（进程间通信）和任务调度等。

环境准备

在进行实际开发之前，确保你已经安装了以下工具和库：

1、Chromium Embedded Framework (CEF): [官方下载地址](https://bitbucket.org/chromiumembedded/cef/downloads/)

2、C++编译器: 如GCC, Clang, MSVC等

3、Python: 用于运行CEF自带的工具脚本

4、Node.js: 可选，用于构建前端页面

创建一个简单的CEF应用

我们需要创建一个基本的CEF应用程序，以下是一个简单的示例，展示如何初始化一个CEF窗口并加载一个HTML文件。

// main.cpp
#include "include/cef_app.h"
#include "include/cef_client.h"
#include "include/cef_browser.h"
#include "include/cef_command_line.h"
// MyApp 类，继承自 CefApp
class MyApp : public CefApp {
 public:
  // 重写 OnBeforeCommandLineProcessing 方法
  virtual void OnBeforeCommandLineProcessing(const CefString& process_type, CefRefPtr<CefCommandLine> cmd_line) override {
    // 在这里可以添加命令行参数
  }
};
int main(int argc, char* argv[]) {
  // 创建命令行解析器
  CefRefPtr<CefCommandLine> command_line = CefCommandLine::CreateCommandLine();
  // 初始化 CEF
  CefMainArgs main_args(argc, argv);
  int exit_code = CefExecuteProcess(main_args, nullptr, nullptr);
  if (exit_code >= 0) {
    return exit_code;
  }
  // 创建应用程序对象
  CefRefPtr<MyApp> app = new MyApp();
  // 执行应用程序消息循环
  return CefExecuteProcess(main_args, app, nullptr);
}

编译和运行

为了编译这个示例，你需要编写一个CMakeLists.txt 文件或者使用其他构建系统，以下是一个简单的CMakeLists.txt 示例：

cmake_minimum_required(VERSION 3.5)
project(cef_example)
设置 C++ 标准
set(CMAKE_CXX_STANDARD 11)
set(CMAKE_CXX_STANDARD_REQUIRED ON)
查找 CEF 库
find_package(CEF REQUIRED)
添加可执行文件
add_executable(cef_example main.cpp)
链接 CEF 库
target_link_libraries(cef_example CEF::CEF)

在项目根目录下运行以下命令来构建和运行应用程序：

mkdir build && cd build
cmake ..
make
./cef_example

JavaScript与C++通信

要在JavaScript和C++之间进行通信，我们通常使用CEF提供的消息传递机制，下面是一个完整的示例，展示如何通过JavaScript向C++发送消息。

步骤1：定义一个C++类来处理JavaScript消息

我们需要定义一个C++类来处理从JavaScript发送过来的消息，这个类需要继承自CefV8Handler。

// my_v8_handler.h
#pragma once
#include "include/cef_v8.h"
class MyV8Handler : public CefV8Handler {
 public:
  explicit MyV8Handler(CefRefPtr<CefBrowser> browser) : browser_(browser) {}
  // 处理 JavaScript 调用 native 方法
  virtual bool Execute(const CefString& name,
                      CefRefPtr<CefV8Value> params,
                      CefRefPtr<CefV8Value> callback,
                      int execution_context_id) override {
    if (name == "sendMessageToCpp") {
      if (params->IsObject()) {
        // 获取 JavaScript 传递的消息
        CefRefPtr<CefV8Value> message = params->GetKey("message");
        if (message->IsString()) {
          std::string message_str = message->GetStringValue();
          // TODO: 处理消息
          std::cout << "Received message from JS: " << message_str << std::endl;
          return true;
        }
      }
    }
    return false;
  }
 private:
  CefRefPtr<CefBrowser> browser_;
};

步骤2：在浏览器创建时绑定V8处理器

在浏览器创建时将MyV8Handler 绑定到浏览器实例上，这通常在CefClient::OnAfterCreated 方法中完成。

// my_client.h
#pragma once
#include "include/cef_client.h"
#include "my_v8_handler.h"
class MyClient : public CefClient {
 public:
  explicit MyClient() : v8_handler_(nullptr) {}
  // 当浏览器被创建后调用此方法
  virtual void OnAfterCreated(CefRefPtr<CefBrowser> browser) override {
    v8_handler_ = new MyV8Handler(browser);
    browser->GetMainFrame()->AddMessageListener(v8_handler_);
  }
 private:
  CefRefPtr<MyV8Handler> v8_handler_;
};

步骤3：在主程序中使用自定义客户端

在主程序中设置自定义的CefClient。

// main.cpp (更新后的代码)
#include "include/cef_app.h"
#include "include/cef_client.h"
#include "include/cef_browser.h"
#include "include/cef_command_line.h"
#include "my_client.h"
#include "my_v8_handler.h"
// MyApp 类，继承自 CefApp
class MyApp : public CefApp {
 public:
  // 重写 OnBeforeCommandLineProcessing 方法
  virtual void OnBeforeCommandLineProcessing(const CefString& process_type, CefRefPtr<CefCommandLine> cmd_line) override {
    // 在这里可以添加命令行参数
  }
  // 重写 GetClientHandler 方法，返回自定义的客户端对象
  virtual CefRefPtr<CefClient> CreateClient() override {
    return new MyClient();
  }
};
int main(int argc, char* argv[]) {
  // 创建命令行解析器
  CefRefPtr<CefCommandLine> command_line = CefCommandLine::CreateCommandLine();
  // 初始化 CEF
  CefMainArgs main_args(argc, argv);
  int exit_code = CefExecuteProcess(main_args, nullptr, nullptr);
  if (exit_code >= 0) {
    return exit_code;
  }
  // 创建应用程序对象
  CefRefPtr<MyApp> app = new MyApp();
  // 执行应用程序消息循环
  return CefExecuteProcess(main_args, app, nullptr);
}

JavaScript端代码

在HTML文件中，可以通过window.postMessage 方法向C++发送消息，以下是一个简单的HTML示例：

<!DOCTYPE html>
<html>
<head>
  <title>CEF Example</title>
</head>
<body>
  <h1>Hello, CEF!</h1>
  <button id="sendMessageButton">Send Message to C++</button>
  <script type="text/javascript">
    document.getElementById('sendMessageButton').addEventListener('click', function() {
      // 发送消息到 C++
      window.postMessage({ message: 'Hello from JavaScript!' }, '*');
    });
  </script>
</body>
</html>

通过以上步骤，我们已经成功实现了一个简单的CEF应用程序，其中JavaScript能够通过window.postMessage 向C++发送消息，并且C++能够接收并处理这些消息，这种机制为复杂的前后端交互提供了基础，可以根据具体需求进一步扩展功能。

常见问题解答（FAQs）

Q1: 如何在JavaScript中调用C++函数？

A1: 你可以通过window.nativeFunctionName 的方式在JavaScript中调用C++暴露出来的函数，确保在C++中正确实现了Execute 方法，并在MyV8Handler 中注册相应的函数名。

virtual bool Execute(const CefString& name, ...) override {
  if (name == "someNativeFunction") {
    // 实现函数逻辑
    return true;
  }
  return false;
}

然后在JavaScript中调用：