1. IronPDF
  2. 開始使用
  3. 使用IronPDFEngine

如何使用 IronPdfEngine

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

IronPdfEngine 是一個 gRPC 伺服器，旨在管理一系列IronPDF任務，包括建立、編輯和讀取 PDF 文件。

如何在Node.js中使用IronPdfEngine

  1. 安裝Node.js庫以使用 IronPdfEngine。
  2. 使用 npm 安裝該庫，即可將其包含進來。
  3. 透過相同的安裝方式取得 Chrome 二進位。
  4. Check the version needed by accessing the `ironPdfEngineVersion` property.
  5. 使用 IronPdfEngine 將 HTML 渲染成 PDF，其渲染效果與 Chrome 渲染器完全相同。

IronPDF Node.js和 IronPdfEngine

Node.js版IronPDF需要IronPdfEngine 才能運作。 Node.js程式碼只是對 IronPdfEngine gRPC 的一個 API 遮罩。 因此，當您在IronPDF for Node.js中呼叫任何方法時，神奇的事情就會在 IronPdfEngine 內部發生！

預設情況下， Node.js版IronPDF會將 IronPdfEngine 作為子進程啟動，與其通信，直到應用程式關閉為止。

注意：每個版本的Node.js版IronPDF都需要特定版本的 IronPdfEngine。不支援跨版本相容。

適用於Node.js的IronPDF和本地 IronPdfEngine

方案一：運行時下載 IronPdfEngine

預設情況下，在JavaScript專案中安裝IronPDF後，首次執行時， IronPDF將偵測您的平台（例如 Windows x64）並從網路下載正確的 IronPdfEngine 二進位檔案。

npm install @ironsoftware/ironpdf
npm install @ironsoftware/ironpdf
SHELL

優點： 您的申請包會很小。

  • 可部署在多個平台上。

缺點：

  • 前幾次運行需要連接網路。 啟動速度慢。

選項 2(建議)：將 IronPdfEngine 安裝為依賴項

IronPDF for 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
    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

優點： 啟動速度更快。 安裝依賴項後，無需連接網路。

缺點： 您的申請文件會很大。

  • 需要指定目標平台。

適用於Node.js的IronPDF和遠端 IronPdfEngine

要使用遠端 IronPdfEngine，需要特定版本的 IronPdfEngine。 例如，如果Node.js版本的IronPDF 2024.2.2 需要 IronPdfEngine 2024.2.2 版本，請勿使用 IronPdfEngine 2024.2.1 版本。存取 ironPdfEngineVersion 屬性以檢查所需的版本。

const ironPdfEngineVersion = IronPdfGlobalConfig.ironPdfEngineVersion;
const ironPdfEngineVersion = IronPdfGlobalConfig.ironPdfEngineVersion;
JAVASCRIPT

如何連接

假設 IronPdfEngine 在遠端運行於 123.456.7.8:33350。

請參閱"如何拉取和運行 IronPdfEngine "。

要連接，您只需指定 IronPdfEngine 的位置(請確保地址可訪問，未被防火牆阻止)。 在應用程式的初始階段，或在呼叫任何IronPDF方法之前，請新增此程式碼。

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

就這麼簡單！ 之後，您的應用程式將連接到遠端 IronPdfEngine！

對於遠端 IronPdfEngine，無需將 IronPdfEngine 作為依賴項安裝。 您可以跳過標題為"選項 2（建議）將 IronPdfEngine 安裝為依賴項"的部分。

常見問題解答

IronPDFEngine在Node.js中有什么用？

IronPDFEngine是Node.js中的gRPC服务器，用于管理PDF任务，如创建、编辑和渲染，提供無缝的PDF處理体验。

如何安装適用于Node.js的IronPDF？

您可以使用npm命令 npm install @Iron Software/ironpdf 安装適用于Node.js的IronPDF。

IronPDFEngine的本地和远程設置有何区别？

本地設置涉及在運行時下载IronPDFEngine或将其作為依赖項安装，提供更快的启動時间。远程設置连接到托管在远程的IronPDFEngine，消除了本地安装的需求。

如何确保IronPDF和IronPDFEngine版本之间的兼容性？

Node.js的每個IronPDF版本都需要特定版本的IronPDFEngine。使用ironPdfEngineVersion属性检查所需版本并确保两個版本匹配。

将IronPDFEngine作為依赖項安装有什么好處？

将IronPDFEngine作為依赖項安装可以加快启動時间，并在安装後不需要互聯網访問，尽管它会增加應用程序包大小。

如何连接远程的IronPDFEngine？

要连接远程的IronPDFEngine，使用IronPDFGlobalConfig.setConfig指定服务器地址，确保其可访問且不被防火墙阻止。

運行時下载IronPDFEngine是否需要互聯網访問？

是的，運行時首次下载IronPDFEngine時需要互聯網访問，这也会导致启動時间较长。

远程使用IronPDFEngine是否需要安装？

不，使用远程IronPDFEngine時，不需要本地安装它作為依赖項。

IronPDFEngine可以在不同平台上使用嗎？

是的，IronPDFEngine可以部署在多個平台上。平台特定的npm命令可用于Windows、Linux和macOS上的安装。

IronPDF 是否相容於 .NET 10？它支援哪些環境？

是的，IronPDF 完全相容於 .NET 10（以及 .NET 9、8、7 等）。它支援 C#、VB.NET 和 F#，並且可以在 Windows、Linux、macOS 等平台上運行，包括 Docker 和雲端環境，因此適用於 .NET 10 的 Web、桌面、主機或雲端專案。

Curtis Chau
Curtis Chau
  立即與工程團隊聊天
技術作家

Curtis Chau 擁有卡爾頓大學計算機科學學士學位，專注於前端開發，擅長於 Node.js、TypeScript、JavaScript 和 React。Curtis 熱衷於創建直觀且美觀的用戶界面，喜歡使用現代框架並打造結構良好、視覺吸引人的手冊。

除了開發之外，Curtis 對物聯網 (IoT) 有著濃厚的興趣，探索將硬體和軟體結合的創新方式。在閒暇時間，他喜愛遊戲並構建 Discord 機器人，結合科技與創意的樂趣。

準備好開始了嗎？
版本： 2026.3 剛剛發布
Still Scrolling Icon

還在捲動嗎？

想要快速證明？
執行範例 觀看您的 HTML 變成 PDF。