如何使用IronPdfEngine
IronPdfEngine是一個精心製作的gRPC伺服器,用於監管一系列IronPDF任務,包括創建、編輯和閱讀PDF文件。
如何在 Node.js 中使用 IronPdfEngine
- 安裝 Node.js 程式庫以使用 IronPdfEngine
- 通過使用 npm 安裝它來包含該庫
- 透過相同的安裝獲取 Chrome 二進制檔案。
- 通過訪問 ironPdfEngineVersion 屬性來檢查所需的版本
- 使用IronPdfEngine以與Chrome相同的渲染器將HTML渲染為PDF
安裝與 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 作為子進程啟動,並與其通信直到您的應用程序關閉。
請注意
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 with Remote IronPdfEngine
要使用遠程 IronPdfEngine,需要特定版本的 IronPdfEngine。比如說,如果 IronPdf for Node.js 版本 2024.2.2 需要 IronPdfEngine 版本 2024.2.2。不要使用 IronPdfEngine 版本 2024.2.1。訪問 ironPdfEngineVersion
屬性來檢查所需的版本。
const ironPdfEngineVersion = IronPdfGlobalConfig.ironPdfEngineVersion;
如何連接
假設 IronPdfEngine 遠端執行於 123.456.7.8:33350
請注意
您只需要告訴 IronPDF IronPdfEngine 在哪裡 (請確保地址可訪問,未被防火牆阻擋)在應用程式的初始階段加入這段程式碼 (或在調用任何 IronPDF 方法之前).
IronPdfGlobalConfig.setConfig({
ironPdfEngineDockerAddress:"123.456.7.8:33350"
});
就是這麼簡單! 之後,您的應用程式將連接到遠程 IronPdfEngine!
對於遠端 IronPdfEngine,不需要將 IronPdfEngine 安裝為依賴項。您可以跳過標題為 "選項 2(推薦)將 IronPdfEngine 安裝為依賴項.