IronPdfEngineの使い方

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

IronPdfEngineは、PDFドキュメントの作成、編集、および読み取りを含む多様なIronPDFタスクを監督するために設計されたgRPCサーバーです。

PDF用 Node.js ライブラリ

でインストール npm

 npm i @ironsoftware/ironpdf

IronPDF for 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を必要とします。クロスバージョンはサポートされていません。

ローカルIronPdfEngineを使用したIronPdf for Node.js

オプション 1 ランタイムで IronPdfEngine をダウンロード

デフォルトでは、IronPdfをJavaプロジェクトにインストールした後、最初の実行時にIronPdfがプラットフォームを検出します。 (例えば、Windows x64) インターネットから適切なIronPdfEngineバイナリをダウンロードします。

npm i @ironsoftware/ironpdf

長所

  • アプリケーションパッケージは小さくなります。
  • 多くのプラットフォームにデプロイ可能

欠点

  • 初回の実行時にはインターネットアクセスが必要です
  • 起動時間の遅延

オプション2(推奨):依存関係としてIronPdfEngineをインストールする

IronPdf Node.jsは、IronPdfEngineを依存関係として追加することができます。 これらのIronPdfEngine依存関係は、IronPdfEngineを.zipファイルにバンドルし、self抽出して自動的に使用します。

以下のIronPdfEngine依存関係の1つまたは複数をインストールすることができます。

次の内容にご注意ください。
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

次の内容にご注意ください。
各依存関係は非常に大きいため、それらをすべてインストールするのは良い考えではありません。

長所

  • より速い起動時間。
  • 依存関係がインストールされた後は、インターネットアクセスは必要ありません。

欠点

  • あなたのアプリケーションパッケージは大きくなります。
  • ターゲットプラットフォームを指定する必要があります。

Node.js 用 IronPDF とリモート 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をインストールする."