Comment utiliser IronPdfEngine

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

IronPdfEngine est un serveur gRPC conçu pour superviser une série de tâches IronPDF, notamment la création, l'édition et la lecture de documents PDF.

Commencez avec IronPDF

Commencez à utiliser IronPDF dans votre projet dès aujourd'hui avec un essai gratuit.

Première étape :
green arrow pointer


IronPDF for Node.js et IronPdfEngine

IronPDF for Node.js requiert IronPdfEngine pour fonctionner. Le code Node.js est juste un masque API sur IronPdfEngine gRPC. Ainsi, lorsque vous appelez une méthode dans IronPDF for Node.js, la magie s'opère à l'intérieur d'IronPdfEngine!

Par défaut, IronPDF for Node.js créera IronPdfEngine en tant que sous-processus et communiquera avec lui jusqu'à ce que votre application soit arrêtée.

A noter
Chaque version d'IronPDF for Node.js nécessite une version spécifique d'IronPdfEngine. Les versions croisées ne sont pas supportées.

IronPDF pour Node.js avec IronPdfEngine local

Option 1 : télécharger IronPdfEngine dans le moteur d'exécution

Par défaut, après avoir installé IronPDF dans votre projet Java, lors de la première exécution, IronPdf détectera votre plateforme(par exemple, Windows x64) et téléchargez les binaires corrects d'IronPdfEngine sur l'internet.

npm i @ironsoftware/ironpdf

Pour

  • Votre dossier de candidature sera peu volumineux.
  • Peut être déployé sur de nombreuses plateformes

Cons

  • L'accès à l'internet est nécessaire pour les premières courses
  • Temps de démarrage lent

Option 2(recommandée) installer IronPdfEngine en tant que dépendance

IronPDF for Node.js vous permet d'ajouter IronPdfEngine comme dépendance. Ces dépendances IronPdfEngine regroupent IronPdfEngine dans un fichier .zip et seront extraites et utilisées automatiquement.

Vous pouvez choisir d'installer une ou plusieurs de ces dépendances IronPdfEngine.

[{i :(la version des dépendances ironpdf et ironpdf-engine-xxx-xxx doit être la même.

la version de la dépendance ironpdf-engine-xxx-xxx ne fait pas référence à la version d'IronPdfEngine qu'elle contient.

)}]

Pour Windows x64

npm install @ironsoftware/ironpdf-engine-windows-x64

Pour Windows x86

npm install @ironsoftware/ironpdf-engine-windows-x86

Pour Linux x64

npm install @ironsoftware/ironpdf-engine-linux-x64

Pour macOS x64

npm install @ironsoftware/ironpdf-engine-macos-x64

Pour macOS arm

npm install @ironsoftware/ironpdf-engine-macos-arm64

A noter
Chaque dépendance est assez importante, ce n'est pas une bonne idée de toutes les installer.

Pour

  • Temps de démarrage plus rapide.
  • L'accès à Internet n'est pas nécessaire après l'installation de la dépendance.

Cons

  • Votre dossier de candidature sera volumineux.
  • Il faut préciser les plates-formes cibles.

IronPDF pour Node.js avec IronPdfEngine à distance

Pour utiliser IronPdfEngine à distance, une version spécifique d'IronPdfEngine est nécessaire. Par exemple, si la version 2024.2.2 d'IronPDF for Node.js nécessite la version 2024.2.2 d'IronPdfEngine. N'utilisez pas IronPdfEngine version 2024.2.1. Accédez à la propriété ironPdfEngineVersion pour vérifier la version nécessaire.

const ironPdfEngineVersion = IronPdfGlobalConfig.ironPdfEngineVersion;
JAVASCRIPT

Comment se connecter

Supposons que IronPdfEngine s'exécute à distance à 123.456.7.8:33350

[{i :(Pour exécuter IronPdfEngine à distance, veuillez vous référer à "Comment tirer et exécuter IronPdfEngine.")}]

Il suffit d'indiquer à IronPDF où se trouve IronPdfEngine(assurez-vous que l'adresse est accessible et non bloquée par un pare-feu).

Ajoutez ce code à l'étape initiale de votre application(ou juste avant d'appeler une méthode IronPDF).

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

C'est aussi simple que cela! Après cela, votre application sera connectée à distance à IronPdfEngine!

Pour IronPdfEngine à distance, il n'est pas nécessaire d'installer IronPdfEngine en tant que dépendance. Vous pouvez sauter la section intitulée "Option 2(recommandée) installer IronPdfEngine en tant que dépendance."