跳至主要内容

Electron 内部机制：将 Node 用作库

·阅读时间：4 分钟
zcbenz
zcbenz

这是正在进行的一系列文章中的第二篇，该系列文章解释了 Electron 的内部机制。如果您还没有阅读，请查看有关事件循环集成的第一篇文章。

大多数人使用Node 用于服务器端应用程序，但由于 Node 丰富的 API 集和蓬勃发展的社区，它也非常适合嵌入式库。这篇文章解释了 Node 如何在 Electron 中用作库。

构建系统​

Node 和 Electron 都使用GYP 作为它们的构建系统。如果要将 Node 嵌入到应用程序中，也必须使用它作为构建系统。

不熟悉 GYP？在继续阅读这篇文章之前，请阅读本指南。

Node 的标志​

Node 源代码目录中的node.gyp 文件描述了 Node 的构建方式，以及许多GYP 变量控制着 Node 的哪些部分被启用以及是否打开某些配置。

要更改构建标志，需要在项目的 .gypi 文件中设置变量。Node 中的 configure 脚本可以为您生成一些常见的配置，例如运行 ./configure --shared 将生成一个 config.gypi，其中包含指示 Node 作为共享库构建的变量。

Electron 不使用 configure 脚本，因为它有自己的构建脚本。Node 的配置是在 Electron 根源代码目录中的common.gypi 文件中定义的。

在 Electron 中，Node 通过将 GYP 变量 node_shared 设置为 true 来链接为共享库，因此 Node 的构建类型将从 executable 更改为 shared_library，并且包含 Node main 入口点的源代码不会被编译。

由于 Electron 使用与 Chromium 一起提供的 V8 库，因此 Node 源代码中包含的 V8 库不会被使用。这是通过将 node_use_v8_platform 和 node_use_bundled_v8 都设置为 false 来完成的。

共享库或静态库​

当与 Node 链接时，有两种选择：可以将 Node 构建为静态库并将其包含在最终的可执行文件中，也可以将其构建为共享库并将其与最终可执行文件一起发布。

在 Electron 中，Node 在很长一段时间内都是作为静态库构建的。这使构建变得简单，能够进行最佳的编译器优化，并允许 Electron 在没有额外的 node.dll 文件的情况下进行分发。

然而，这种情况在 Chrome 切换到使用BoringSSL 之后发生了变化。BoringSSL 是 OpenSSL 的一个分支，它删除了几个未使用的 API，并更改了许多现有的接口。由于 Node 仍然使用 OpenSSL，因此如果将它们链接在一起，编译器将由于冲突的符号而生成许多链接错误。

Electron 无法在 Node 中使用 BoringSSL，也无法在 Chromium 中使用 OpenSSL，因此唯一的选择是切换到将 Node 构建为共享库，并在隐藏每个组件中的 BoringSSL 和 OpenSSL 符号。

此更改给 Electron 带来了几个积极的副作用。在此更改之前，如果使用原生模块，则无法在 Windows 上重命名 Electron 的可执行文件，因为可执行文件的名称在导入库中是硬编码的。在 Node 被构建为共享库之后，这种限制消失了，因为所有原生模块都与 node.dll 链接，而 node.dll 的名称不需要更改。

支持原生模块​

Node 中的原生模块 通过为 Node 定义一个入口函数来加载，然后从 Node 中搜索 V8 和 libuv 的符号。这对嵌入者来说有点麻烦，因为默认情况下，在将 Node 构建为库时，V8 和 libuv 的符号是隐藏的，原生模块将无法加载，因为它们找不到这些符号。

因此，为了使原生模块能够正常工作，在 Electron 中公开了 V8 和 libuv 符号。对于 V8，这是通过强制 Chromium 配置文件中的所有符号都被公开 来完成的。对于 libuv，这是通过设置 BUILDING_UV_SHARED=1 定义 来实现的。

在您的应用程序中启动 Node​

在完成构建和与 Node 链接的所有工作之后，最后一步是在您的应用程序中运行 Node。

Node 没有提供很多用于将其嵌入到其他应用程序中的公共 API。通常，您可以直接调用node::Start 和 node::Init 来启动一个新的 Node 实例。但是，如果您正在构建一个基于 Node 的复杂应用程序，则必须使用 node::CreateEnvironment 等 API 来精确控制每个步骤。

在 Electron 中，Node 以两种模式启动：在主进程中运行的独立模式，类似于官方的 Node 二进制文件；以及将 Node API 插入网页的嵌入模式。有关此内容的详细信息将在以后的文章中解释。