如何使用 IronPdfEngine
IronPdfEngine 是一个 gRPC 服务器,用于监督一系列 IronPDF 任务,包括 PDF 文档的创建、编辑和阅读。
如何在 Node.js 中使用 IronPdfEngine
- 安装 Node.js 库以使用 IronPdfEngine
- 使用 npm 安装并包含该库
- 通过相同的安装方式获取 Chrome 浏览器二进制文件
- 通过访问 ironPdfEngineVersion 属性检查版本需求
- 使用 IronPdfEngine 将 HTML 渲染为 PDF,其渲染器与 Chrome 浏览器相同
安装使用 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 作为子进程,并与之对话,直到应用程序关闭。
请注意
使用本地 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-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;
如何连接
假设 IronPdfEngine 在 123.456.7.8:33350
远程运行
[{i:(要远程运行 IronPdfEngine,请参阅"如何拉动和运行 IronPdfEngine.")}]
你只需告诉 IronPdf IronPdfEngine 的位置 (请确保可以访问该地址,而不是被防火墙阻挡).
在应用程序的初始阶段添加以下代码 (或在调用任何 IronPdf 方法之前).
IronPdfGlobalConfig.setConfig({
ironPdfEngineDockerAddress:"123.456.7.8:33350"
});
就这么简单! 之后,您的应用程序将连接远程 IronPdfEngine!
对于远程 IronPdfEngine,无需将 IronPdfEngine 作为依赖安装。您可以跳过标题为"方案 2(推荐)将 IronPdfEngine 作为依赖项安装."