如何使用 IronPdfEngine

This article was translated from English: Does it need improvement?
Translated
View the article in English

IronPdfEngine 是一个 gRPC 服务器,用于监督一系列 IronPDF 任务,包括 PDF 文档的创建、编辑和阅读。

用于PDF的Node.js库

安装使用 npm

 npm i @ironsoftware/ironpdf

IronPdf Node.js 和 IronPdfEngine

IronPdf for Node.js 需要 IronPdfEngine才能运行。Node.js 代码只是 IronPdfEngine gRPC 的一个 API 屏蔽。因此,当你调用 IronPdf for Node.js 中的任何方法时,魔法将在 IronPdfEngine 中发生!

默认情况下,IronPdf for Node.js 会生成 IronPdfEngine 作为子进程,并与之对话,直到应用程序关闭。

请注意
每个版本的 IronPdf for Node.js 都需要特定版本的 IronPdfEngine。不支持跨版本。

使用本地 IronPdfEngine 的 Node.js 版 IronPdf

选项 1 在运行时下载 IronPdfEngine

默认情况下,在您的 Java 项目中安装 IronPdf 后,第一次运行时,IronPdf 会检测您的平台 (例如,Windows x64) 并从互联网上下载正确的 IronPdfEngine 二进制文件。

npm i @ironsoftware/ironpdf

优点

  • 您的申请文件包很小。
  • 可在多种平台上部署

缺点

  • 首次运行需要上网
  • 启动时间慢

选项 2 (推荐) 将 IronPdfEngine 作为依赖安装

IronPdf Node.js 允许你将 IronPdfEngine 添加为依赖项。这些 IronPdfEngine 依赖项会将 IronPdfEngine 绑定到 .zip 文件中,并自动解压缩和使用。

你可以选择安装一个或多个 IronPdfEngine 依赖项。

请注意
ironpdf "和 "ironpdf-engine-xxx-xxx "依赖版本必须相同。

ironpdf-engine-xxx-xxx`依赖版本并不是指内部 IronPdfEngine 的版本。

适用于 Windows x64

npm install @ironsoftware/ironpdf-engine-windows-x64

适用于 Windows x86

npm install @ironsoftware/ironpdf-engine-windows-x86

适用于 Linux x64

npm install @ironsoftware/ironpdf-engine-linux-x64

适用于 macOS x64

npm install @ironsoftware/ironpdf-engine-macos-x64

用于 macOS arm

npm install @ironsoftware/ironpdf-engine-macos-arm64

请注意
每个依赖项都相当庞大,全部安装不是个好主意。

优点

  • 更快的启动时间。
  • 安装依赖项后无需访问互联网。

缺点

  • 申请材料会比较多。
  • 需要特定的目标平台。

IronPdf for Node.js 与远程 IronPdfEngine

要使用远程 IronPdfEngine,需要特定版本的 IronPdfEngine。例如,IronPdf for Node.js 版本 2024.2.2 需要 IronPdfEngine 版本 2024.2.2。请勿使用 2024.2.1 版 IronPdfEngine。访问 ironPdfEngineVersion 属性,检查所需版本。

const ironPdfEngineVersion = IronPdfGlobalConfig.ironPdfEngineVersion;
JAVASCRIPT

如何连接

假设 IronPdfEngine 在 123.456.7.8:33350 远程运行

[{i:(要远程运行 IronPdfEngine,请参阅"如何拉动和运行 IronPdfEngine.")}]

你只需告诉 IronPdf IronPdfEngine 的位置 (请确保可以访问该地址,而不是被防火墙阻挡).

在应用程序的初始阶段添加以下代码 (或在调用任何 IronPdf 方法之前).

IronPdfGlobalConfig.setConfig({
    ironPdfEngineDockerAddress:"123.456.7.8:33350"
});
JAVASCRIPT

就这么简单! 之后,您的应用程序将连接远程 IronPdfEngine!

对于远程 IronPdfEngine,无需将 IronPdfEngine 作为依赖安装。您可以跳过标题为"方案 2(推荐)将 IronPdfEngine 作为依赖项安装."