在本章中，我们将深入探讨如何使用 N-API 在 Deno 中进行原生模块的开发。N-API 是 Node.js 提供的一种 API，用于创建原生插件，这些插件可以与 JavaScript/TypeScript 代码无缝集成。尽管 Deno 最初并未设计为支持 Node.js 的原生模块，但通过一些额外的工作和社区贡献，我们可以在 Deno 中使用 N-API。
什么是 N-API？
N-API 是一种独立于 V8、JavaScriptCore、ChakraCore 等 JavaScript 引擎的 C API 层。它的主要目的是允许开发者编写可移植的原生插件，这些插件可以在不同的 JavaScript 运行时环境中工作，包括 Deno。这使得开发者可以重用现有的 Node.js 模块或库，并将它们集成到 Deno 应用程序中。
安装必要的工具
在开始之前，确保你已经安装了以下工具：
- Deno：最新版本的 Deno。
- C 编译器：如 GCC 或 Clang，具体取决于你的操作系统。
- Node-gyp：用于构建 N-API 模块的工具。虽然 Deno 不直接使用 Node-gyp，但它可以帮助你在开发过程中快速生成和测试 N-API 模块。
安装 Deno
如果你还没有安装 Deno，可以通过以下命令安装：
deno install -A https://deno.land/x/denon@3.5.1/cli.ts
请注意，上面的命令只是一个示例，实际安装过程可能因你的环境而异。通常，你可以直接访问 Deno 官方网站获取最新的安装指南。
安装 C 编译器
对于 macOS 用户，可以使用 Homebrew 来安装 GCC：
brew install gcc
对于 Linux 用户，可以使用包管理器来安装 GCC：
sudo apt-get update sudo apt-get install build-essential
对于 Windows 用户，建议使用 MinGW-w64 来获得一个兼容的编译环境。
安装 Node-gyp
为了简化 N-API 模块的开发过程，你可以安装 Node-gyp：
npm install -g node-gyp
创建第一个 N-API 模块
接下来，我们将创建一个简单的 N-API 模块，并在 Deno 中使用它。
创建项目结构
首先，创建一个新的文件夹并初始化一个新的 npm 项目：
mkdir deno-napi-example cd deno-napi-example npm init -y
然后，在项目根目录下创建一个名为 binding.gyp 的文件，这是 Node-gyp 使用的配置文件。在这个文件中，我们将定义我们的 N-API 模块的基本信息：
{
"targets": [
{
"target_name": "example",
"sources": [ "src/example.cc" ]
}
]
}接着，在 src 目录下创建一个 example.cc 文件，这是我们实际编写原生代码的地方：
-- -------------------- ---- ------- -------- -------- ------------ -------------- ------------------- ----- - --------- --- - ----------- ------ ---------------------- ------ ---- -------- - ------------ -------------- ---- ------------ -------- - ---------------------------------- ------------ ------------------------ ----------- ------ -------- - ------------------------ -----
构建 N-API 模块
现在，我们可以使用 Node-gyp 来构建这个模块：
node-gyp configure node-gyp build
构建完成后，你会在 build/Release 目录下找到生成的 .node 文件。
在 Deno 中使用 N-API 模块
Deno 本身不直接支持加载 .node 文件，因此我们需要使用第三方库来实现这一点。这里我们使用 deno-napi：
deno install -A https://deno.land/x/deno_napi/mod.ts
然后，你可以创建一个 main.ts 文件来加载和使用这个模块：
import { load } from "https://deno.land/x/deno_napi/mod.ts";
const modulePath = "./build/Release/example.node";
await load(modulePath);
// 加载完成后，可以直接使用导出的函数
console.log(Deno["example"].sayHello());运行这个脚本：
deno run --allow-all main.ts
你应该能看到输出 Hello from Deno!，这意味着我们成功地在 Deno 中使用了一个 N-API 模块！
总结
本章介绍了如何在 Deno 中使用 N-API 创建和加载原生模块。尽管 Deno 并不直接支持 Node.js 的原生模块系统，但我们可以通过一些额外的工作和使用第三方库来实现这一目标。希望这些步骤能帮助你在 Deno 项目中引入复杂的原生功能。
接下来的章节将深入探讨更多关于 Deno 和 N-API 的细节，包括错误处理、性能优化以及如何调试这些原生模块。