如何使用IronPdfEngine

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

IronPdfEngine 是一个 gRPC 服务器,专门设计用来管理 IronPDF 的多种任务,包括创建、编辑和阅读 PDF 文档。

开始使用IronPDF

立即在您的项目中开始使用IronPDF,并享受免费试用。

第一步:
green arrow pointer


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

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

npm i @ironsoftware/ironpdf
npm i @ironsoftware/ironpdf
SHELL

优点

  • 您的应用程序包将会很小。
  • 可以部署在多个平台上

幻灯片

  • 首次运行需要连接互联网。
  • 启动时间慢

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

IronPdf Node.js 允许您添加 IronPdfEngine 作为依赖项。 这些IronPdfEngine依赖项将IronPdfEngine捆绑到一个.zip文件中,并将自动提取并使用。

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

请注意
ironpdfironpdf-engine-xxx-xxx 的依赖版本必须相同。

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

适用于 Windows x64

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

适用于 Windows x86

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

适用于 Linux x64

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

适用于 macOS x64

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

用于 macOS arm

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

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

优点

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

幻灯片

  • 您的应用程序包将会很大。
  • 需要指定目标平台。

IronPdf for Node.js 与 Remote IronPdfEngine

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

const ironPdfEngineVersion = IronPdfGlobalConfig.ironPdfEngineVersion;
js
JAVASCRIPT

如何连接

假设IronPdfEngine在123.456.7.8:33350远程运行

请注意
若要远程运行IronPdfEngine,请参考 "如何提取和运行IronPdfEngine”。

您只需告诉IronPDF IronPdfEngine的位置(请确保该地址可访问,不被防火墙阻挡)。

在您的应用程序的初始阶段(或者在调用任何IronPDF方法之前)添加此代码。

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

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

对于远程IronPdfEngine,无需将IronPdfEngine安装为依赖项。 您可以跳过标题为“选项 2(推荐)安装 IronPdfEngine 作为依赖项”的部分。