IronPdfEngineの使い方
IronPdfEngineは、PDFドキュメントの作成、編集、および読み取りを含む多様なIronPDFタスクを監督するために設計されたgRPCサーバーです。
Node.jsでIronPdfEngineを使用する方法
- Node.jsライブラリをインストールして、IronPdfEngineを利用します。
- npmを使用してライブラリをインストールして含めます
- 同じインストールを通じてChromeバイナリを取得する
- ironPdfEngineVersion プロパティにアクセスして必要なバージョンを確認してください。
- IronPdfEngineを使用してHTMLをChromeレンダラーと同一の形式でPDFにレンダリングします。
IronPDFを始めましょう
今日から無料トライアルでIronPDFをあなたのプロジェクトで使い始めましょう。
IronPDF for Node.jsおよびIronPdfEngine
IronPdf for Node.js require IronPdfEngine を実行する必要があります。 Node.js コードは、IronPdfEngine gRPC の上にある単なる API マスクです。 したがって、IronPdf for Node.js でいずれかのメソッドを呼び出すと、IronPdfEngine 内でマジックが起こります!
デフォルトでは、IronPDF for Node.js は IronPdfEngine をサブプロセスとして生成し、アプリケーションがシャットダウンされるまでそれと通信します。
次の内容にご注意ください。
ローカルIronPdfEngineを使用したIronPdf for Node.js
オプション 1 ランタイムで IronPdfEngine をダウンロード
デフォルトでは、JavaプロジェクトにIronPdfをインストールした後、最初の実行時に、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;
接続方法
IronPdfEngine がリモートで 123.456.7.8:33350
で実行されていると仮定します。
次の内容にご注意ください。
IronPdfEngineがどこにあるのかをIronPdfに伝えるだけで十分です(そのアドレスがファイアウォールによってブロックされておらず、アクセス可能であることを確認してください)。
このコードをアプリケーションの初期段階で追加してください(または、任意のIronPDFメソッドを呼び出す直前)。
IronPdfGlobalConfig.setConfig({
ironPdfEngineDockerAddress:"123.456.7.8:33350"
});
それだけです! これで、アプリケーションがリモートIronPdfEngineに接続されます!
リモートIronPdfEngineの場合、依存関係としてIronPdfEngineをインストールする必要はありません。 「Option 2(推奨)IronPdfEngine を依存関係としてインストールする」というタイトルのセクションをスキップできます。