IronPdfEngineの使い方

Darrius Serrant
Darrius Serrant
2024年2月25日
更新済み 2024年12月10日
共有:
This article was translated from English: Does it need improvement?
Translated
View the article in English

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

IronPDFを始めましょう

今日から無料トライアルでIronPDFをあなたのプロジェクトで使い始めましょう。

最初のステップ:
green arrow pointer


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 をサブプロセスとして生成し、アプリケーションがシャットダウンされるまでそれと通信します。

次の内容にご注意ください。
各バージョンの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つまたは複数をインストールすることができます。

次の内容にご注意ください。
ironpdfironpdf-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;
JAVASCRIPT

接続方法

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

次の内容にご注意ください。
IronPdfEngineをリモートで実行するには、「How to Pull and Run IronPdfEngine」を参照してください。

IronPdfEngineがどこにあるのかをIronPdfに伝えるだけで十分です(そのアドレスがファイアウォールによってブロックされておらず、アクセス可能であることを確認してください)。

このコードをアプリケーションの初期段階で追加してください(または、任意のIronPDFメソッドを呼び出す直前)。

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

それだけです! これで、アプリケーションがリモートIronPdfEngineに接続されます!

リモートIronPdfEngineの場合、依存関係としてIronPdfEngineをインストールする必要はありません。 「Option 2(推奨)IronPdfEngine を依存関係としてインストールする」というタイトルのセクションをスキップできます。

Darrius Serrant
フルスタックソフトウェアエンジニア(WebOps)

Darrius Serrantは、マイアミ大学でコンピュータサイエンスの学士号を取得しており、Iron SoftwareでフルスタックWebOpsマーケティングエンジニアとして働いています。若い頃からコーディングに魅了され、コンピューティングを神秘的でありながらアクセスしやすいものと見なし、それが創造性と問題解決のための完璧な媒体であると感じました。

Iron Softwareでは、新しいものを作り出し、複雑な概念を簡単にすることでより理解しやすくすることを楽しんでいます。彼は常駐の開発者の一人として、学生に教えることを志願し、自分の専門知識を次世代と共有しています。

Darriusにとって、彼の仕事は評価され、実際に影響があることで充実しています。