1. IronPDF
2. 操作指南
3. 使用IronPdfEngine

如何使用 IronPdfEngine

IronPdfEngine 是一個 gRPC 伺服器，專門用於管理 IronPDF 的各種任務，包括創建、編輯和閱讀 PDF 文件。

開始使用 IronPDF

立即在您的專案中使用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 作為子進程，並與之通信，直到您的應用程式關閉。

Node.js 版 IronPDF 與本地 IronPdfEngine

選項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。請不要使用 IronPdfEngine 版本 2024.2.1。可以訪問 ironPdfEngineVersion 屬性來檢查所需的版本。

const ironPdfEngineVersion = IronPdfGlobalConfig.ironPdfEngineVersion;

const ironPdfEngineVersion = IronPdfGlobalConfig.ironPdfEngineVersion;

如何連接

假設 IronPdfEngine 在 123.456.7.8:33350 遠程運行。

您只需告訴 IronPdf 其中的 IronPdfEngine 位置(請確保地址可訪問，未被防火牆阻擋).

在您的應用程序的初始階段添加此代碼(或在調用任何 IronPDF 方法之前).

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

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

就是這麼簡單! 在此之後，您的應用程式將連接到遠程 IronPdfEngine。!

對於遠端IronPdfEngine，無需將IronPdfEngine安裝為依賴項。 您可以跳過名為的部分。選項 2（推薦）將 IronPdfEngine 安裝為依賴項.