1. IronPDF
  2. 始める
  3. IronPDFEngineを使用する

IronPdfEngineの使用方法

カーティス・チャウ
カーティス・チャウ
更新日:
This article was translated from English: Does it need improvement?
Translated
View the article in English

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

Node.jsでのIronPdfEngineの使い方

  1. IronPdfEngineを利用するにはNode.jsライブラリをインストールしてください。
  2. npmを使用してライブラリをインストールしてください。
  3. Chromeのバイナリは、同じインストールで入手できます。
  4. Check the version needed by accessing the `ironPdfEngineVersion` property.
  5. Chromeと同様のレンダラを使用してIronPdfEngineでHTMLをPDFにレンダリングします。

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

利点:

  • アプリケーションパッケージが小さくなります。
  • Can deploy on many platforms.

欠点:

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

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

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

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

注意: ironpdf と ironpdf-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

利点:

  • 依存関係がインストールされた後は、インターネットアクセスが不要です。
  • 依存関係がインストールされた後は、インターネットアクセスは必要ありません。

欠点:

  • Your application package will be large.
  • ターゲットプラットフォームを指定する必要があります。

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

リモートのIronPdfEngineを使用するには、特定のバージョンのIronPdfEngineが必要です。 例えば、 Node.js用IronPDFバージョン 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

Simple as that! これで、リモートIronPdfEngineとアプリケーションが接続されます！

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

よくある質問

Node.jsでIronPDFEngineは何に使われますか？

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

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

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

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

準備はできましたか？
バージョン: 2026.3 リリース
Still Scrolling Icon

まだスクロールしていますか?

すぐに証拠が欲しいですか?
サンプルを実行するHTML が PDF に変換されるのを確認します。