Node.jsでIronPdfEngineを使う方法

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

@ironsoftware/ironpdfをインストール後、追加でパッケージを必要としません。 最初の実行で、IronPDFはホストプラットフォーム（例: Windows x64）を検出し、インターネットから一致するIronPdfEngineバイナリをダウンロードします。

 npm i @ironsoftware/ironpdf

利点:

• アプリケーションパッケージを小さく維持します。
• プラットフォーム固有の設定なしで複数のプラットフォームにデプロイします。

欠点:

• 初回実行時にインターネットアクセスが必要です。
• バイナリが取得される間、初回実行時の起動時間が遅くなります。

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

Node.js用IronPDFは、特定のプラットフォーム用のIronPdfEngineバイナリをバンドルする専用のエンジンパッケージをサポートしています。 ランタイムのダウンロードを排除するために、メインライブラリと並行してこれらのパッケージの一つ以上をインストールします。

ironpdf-engine-xxx-xxxパッケージは同じバージョンでなければなりません。 エンジンパッケージのバージョン番号は、内部エンジンビルドではなく、IronPDFのリリースを指します。}]

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 arm64:

npm install @ironsoftware/ironpdf-engine-macos-arm64

利点:

• より速い起動—ランタイムでのダウンロードは不要です。
• 依存関係がインストールされた後はインターネットアクセス不要。

欠点:

• 大きなアプリケーションパッケージサイズ。
• ビルド時にターゲットプラットフォームを指定する必要があります。

必要なエンジンバージョンを確認するにはどうしますか？

エンジンのバージョンはNode.jsパッケージのバージョンと一致する必要があります。 どのバージョンを取得するかを確認するためにironPdfEngineVersionプロパティを読み取ってください。

:path=/static-assets/ironpdf-nodejs/content-code-examples/get-started/use-ironpdfengine-8.js

const ironPdfEngineVersion = IronPdfGlobalConfig.ironPdfEngineVersion;
console.log(`Required IronPdfEngine version: ${ironPdfEngineVersion}`);

指定されたDockerイメージタグに印刷されたバージョン番号を使用してください。 不一致なバージョンを実行すると、gRPC通信エラーが発生します。

リモート接続をどのように設定しますか？

IronPdfEngineが123.456.7.8:33350で動作していると想定します。 アプリケーションの開始時に設定呼び出しを行い、任意のIronPDFメソッドの呼び出しを行う前に設定してください。

:path=/static-assets/ironpdf-nodejs/content-code-examples/get-started/use-ironpdfengine-9.js

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

そのアドレスがNode.jsホストからアクセス可能である必要があります。ファイアウォールルールがアプリケーションサーバーとエンジンホスト間のポート33350をブロックしていないか確認してください。

リモートIronPdfEngineを使用する場合、ironpdf-engine-xxx-xxx依存パッケージをインストールする必要はありません。 ironPdfEngineDockerAddressを設定すると、ローカルエンジンは完全にバイパスされます。