Node.jsでIronPdfEngineを使う方法

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

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

//:path=shell
npm install @ironsoftware/ironpdf

//:path=shell
npm install @ironsoftware/ironpdf

利点:

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

欠点:

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

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

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

Windows x64:

//:path=shell
npm install @ironsoftware/ironpdf-engine-windows-x64

//:path=shell
npm install @ironsoftware/ironpdf-engine-windows-x64

Windows x86:

//:path=shell
npm install @ironsoftware/ironpdf-engine-windows-x86

//:path=shell
npm install @ironsoftware/ironpdf-engine-windows-x86

Linux x64:

//:path=shell
npm install @ironsoftware/ironpdf-engine-linux-x64

//:path=shell
npm install @ironsoftware/ironpdf-engine-linux-x64

macOS x64:

//:path=shell
npm install @ironsoftware/ironpdf-engine-macos-x64

//:path=shell
npm install @ironsoftware/ironpdf-engine-macos-x64

macOS arm64:

//:path=shell
npm install @ironsoftware/ironpdf-engine-macos-arm64

//:path=shell
npm install @ironsoftware/ironpdf-engine-macos-arm64

利点:

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

欠点:

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

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

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

//:path=get-started/use-ironpdfengine/check-version.js
const ironPdfEngineVersion = IronPdfGlobalConfig.ironPdfEngineVersion;
console.log(`Required IronPdfEngine version: ${ironPdfEngineVersion}`);

//:path=get-started/use-ironpdfengine/check-version.js
const ironPdfEngineVersion = IronPdfGlobalConfig.ironPdfEngineVersion;
console.log(`Required IronPdfEngine version: ${ironPdfEngineVersion}`);

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

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

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

//:path=get-started/use-ironpdfengine/remote-config.js
IronPdfGlobalConfig.setConfig({
    ironPdfEngineDockerAddress: "123.456.7.8:33350"
});

//:path=get-started/use-ironpdfengine/remote-config.js
IronPdfGlobalConfig.setConfig({
    ironPdfEngineDockerAddress: "123.456.7.8:33350"
});

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