如何使用IronPdfEngine

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

IronPdfEngine是一個精心製作的gRPC伺服器,用於監管一系列IronPDF任務,包括創建、編輯和閱讀PDF文件。

Node.js 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 作為子進程啟動,並與其通信直到您的應用程序關閉。

請注意
每個版本的 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 依賴項。

[{我(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 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;
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 安裝為依賴項.