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を使い始める

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

Pros:

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

Cons:

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

オプション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

Pros:

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

Cons:

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

リモート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

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ボットを作成したりして、技術に対する愛情と創造性を組み合わせています。

準備はできましたか？
バージョン: 2025.12 リリース