如何使用IronPdfEngine

Darrius Serrant
Darrius Serrant
2024年二月25日
更新 2024年十二月10日
分享:
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

优点

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

幻灯片

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

方案 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

适用于 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 与 Remote IronPdfEngine

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

const ironPdfEngineVersion = IronPdfGlobalConfig.ironPdfEngineVersion;
JAVASCRIPT

如何连接

假设IronPdfEngine在123.456.7.8:33350远程运行

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

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

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

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

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

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

Darrius Serrant
全栈软件工程师(WebOps)

达瑞乌斯·塞兰特拥有迈阿密大学计算机科学学士学位,目前在Iron Software担任全栈WebOps营销工程师。从小对编码的热爱使他认为计算机既神秘又易接近,成为创意和解决问题的完美媒介。

在Iron Software,达瑞乌斯乐于创造新事物并简化复杂概念,使其更易于理解。作为我们在职开发者之一,他还自愿教授学生,将他的专业知识传授给下一代。

对达瑞乌斯而言,他的工作之所以令人满足,是因为它具有价值并产生了真正的影响。