How to Use IronPdfEngine

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

IronPdfEngineは、PDFドキュメントの作成、編集、読み込みを含むさまざまなIronPDFタスクを監督するために作られたgRPCサーバーです。

class="hsg-featured-snippet">

Node.jsでのIronPdfEngineの使用方法

  1. IronPdfEngineを利用するためにNode.jsライブラリをインストールします。
  2. npmを使用してライブラリをインストールします。
  3. 同じインストールでChromeのバイナリを取得します。
  4. `ironPdfEngineVersion`プロパティにアクセスして必要なバージョンを確認します。
  5. Chromeと同一のレンダラーを使用してHTMLをPDFにレンダリングするためにIronPdfEngineを使用します。

IronPDFを始める


IronPdf Node.jsとIronPdfEngine

IronPdf for Node.jsは、実行するためにIronPdfEngineを必要とします。 Node.jsのコードはIronPdfEngine gRPCの上にあるAPIマスクに過ぎません。 したがって、Node.jsのIronPdfでメソッドを呼び出すと、その操作はすべてIronPdfEngine内で行われます!

デフォルトでは、Node.jsのIronPdfはサブプロセスとしてIronPdfEngineを起動し、アプリケーションが終了するまでそれと通信します。

注意: Node.jsの各バージョンのIronPdfには特定のバージョンのIronPdfEngineが必要です。異なるバージョン間の互換性はサポートされていません。

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

オプション1: 実行時にIronPdfEngineをダウンロード

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

npm install @ironsoftware/ironpdf
npm install @ironsoftware/ironpdf
SHELL

利点:

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

欠点:

  • 最初の数回の実行ではインターネットアクセスが必要です。
  • 起動時間が遅くなります。

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

Node.jsのIronPdfは、IronPdfEngineを依存関係として追加することを許可します。 これらのIronPdfEngine依存パッケージはIronPdfEngineを.zipファイルとしてまとめ、 自動的に解凍して使用します。

これらのIronPdfEngine依存パッケージを1つまたは複数インストールすることを選択できます。

注意: ironpdfironpdf-engine-xxx-xxx依存関係のバージョンは同じでなければなりません。 ironpdf-engine-xxx-xxx依存関係のバージョンは、内部のIronPdfEngineのバージョンではありません。

プラットフォーム固有のインストール:

  • Windows x64:

    npm install @ironsoftware/ironpdf-engine-windows-x64
    npm install @ironsoftware/ironpdf-engine-windows-x64
    SHELL
  • Windows x86:

    npm install @ironsoftware/ironpdf-engine-windows-x86
    npm install @ironsoftware/ironpdf-engine-windows-x86
    SHELL
  • Linux x64:

    npm install @ironsoftware/ironpdf-engine-linux-x64
    npm install @ironsoftware/ironpdf-engine-linux-x64
    SHELL
  • macOS x64:

    npm install @ironsoftware/ironpdf-engine-macos-x64
    npm install @ironsoftware/ironpdf-engine-macos-x64
    SHELL
  • macOS arm:
    npm install @ironsoftware/ironpdf-engine-macos-arm64
    npm install @ironsoftware/ironpdf-engine-macos-arm64
    SHELL

利点:

  • 依存関係がインストールされた後は、インターネットアクセスが不要です。
  • アプリケーションパッケージが大きくなります。

欠点:

  • 対象プラットフォームを指定する必要があります。
  • ターゲットプラットフォームを指定する必要があります。

リモートIronPdfEngineを使用したNode.jsのIronPdf

リモートのIronPdfEngineを使用するには、特定のバージョンのIronPdfEngineが必要です。 例えば、IronPdf for Node.jsバージョン2024.2.2がIronPdfEngineバージョン2024.2.2を必要とする場合、IronPdfEngineバージョン2024.2.1を使用しないでください。必要なバージョンを確認するには、ironPdfEngineVersionプロパティにアクセスしてください。

const ironPdfEngineVersion = IronPdfGlobalConfig.ironPdfEngineVersion;
const ironPdfEngineVersion = IronPdfGlobalConfig.ironPdfEngineVersion;
JAVASCRIPT

接続方法

IronPdfEngineがリモートで123.456.7.8:33350で実行されていると仮定します。

"IronPdfEngineをプルして実行する方法"を参照してください。

接続するには、IronPdfEngineがどこにあるかを指定する必要があります(アドレスがアクセス可能で、ファイアウォールによってブロックされていないことを確認してください)。 アプリケーションの初期段階または任意のIronPdfメソッドを呼び出す直前にこのコードを追加します。

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

このコードを実行すると、アプリケーションはリモートIronPdfEngineに接続します! これで、リモートIronPdfEngineとアプリケーションが接続されます!

オプション2(推奨): IronPdfEngineを依存関係としてインストール」のセクションをスキップできます。 "オプション2(推奨)IronPdfEngineを依存関係としてインストール"のセクションをスキップできます。

よくある質問

Node.jsでIronPdfEngineは何に使われますか?

IronPdfEngineはNode.jsでのPDFタスク(作成、編集、レンダリングなど)を管理するために使用されるgRPCサーバーで、シームレスなPDF処理体験を提供します。

Node.js用のIronPDFをどのようにインストールできますか?

Node.js用のIronPDFをインストールするには、npmを使用し、コマンドnpm install @ironsoftware/ironpdfを実行します。

IronPdfEngineのローカルセットアップとリモートセットアップの違いは何ですか?

ローカルセットアップは、実行時にIronPdfEngineをダウンロードするか、依存関係としてインストールし、開始時間を短縮します。リモートセットアップは、ローカルインストールの必要がないリモートホストIronPdfEngineに接続します。

IronPdfとIronPdfEngineのバージョン間の互換性をどのように保証しますか?

Node.js用の各バージョンのIronPdfは特定のIronPdfEngineバージョンを必要とします。ironPdfEngineVersionプロパティで必要なバージョンを確認し、両方のバージョンが一致していることを確認します。

IronPdfEngineを依存関係としてインストールする利点は何ですか?

IronPdfEngineを依存関係としてインストールすると、開始時間が短縮され、インターネットアクセスがインストール後に不要になりますが、アプリケーションのパッケージサイズが増加します。

リモートIronPdfEngineに接続するにはどうすればよいですか?

リモートIronPdfEngineに接続するには、IronPdfGlobalConfig.setConfigを使用してサーバーアドレスを指定し、アクセスできるようファイアウォールでブロックされないことを確認します。

IronPdfEngineの実行時ダウンロードにはインターネットアクセスが必要ですか?

はい、実行時にIronPdfEngineをダウンロードする最初の数回にはインターネットアクセスが必要であり、開始時間が遅くなります。

リモート使用のためにIronPdfEngineをインストールする必要がありますか?

いいえ、リモートIronPdfEngineを使用する場合は、ローカルに依存関係としてインストールする必要はありません。

IronPdfEngineは異なるプラットフォームで使用できますか?

はい、IronPdfEngineは複数のプラットフォームで展開可能です。Windows、Linux、macOSにインストールするためのプラットフォーム固有のnpmコマンドがあります。

IronPDF は .NET 10 と互換性がありますか? また、どのような環境をサポートしていますか?

はい、IronPDFは.NET 10(.NET 9、8、7など)と完全に互換性があります。C#、VB.NET、F#をサポートし、Windows、Linux、macOSなどのプラットフォーム(Dockerやクラウド環境を含む)で動作するため、.NET 10のWeb、デスクトップ、コンソール、クラウドプロジェクトに最適です。

Curtis Chau
テクニカルライター

Curtis Chauは、カールトン大学でコンピュータサイエンスの学士号を取得し、Node.js、TypeScript、JavaScript、およびReactに精通したフロントエンド開発を専門としています。直感的で美しいユーザーインターフェースを作成することに情熱を持ち、Curtisは現代のフレームワークを用いた開発や、構造の良い視覚的に魅力的なマニュアルの作成を楽しんでいます。

開発以外にも、CurtisはIoT(Internet of Things)への強い関心を持ち、ハードウェアとソフトウェアの統合方法を模索しています。余暇には、ゲームをしたりDiscordボットを作成したりして、技術に対する愛情と創造性を組み合わせています。

準備はいいですか?
バージョン: 2025.11 ただ今リリースされました