Comment utiliser IronPdfEngine

Darrius Serrant
Darrius Serrant
février 25, 2024
Mise à jour décembre 10, 2024
Partager:
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 require IronPdfEngine pour fonctionner. Le code Node.js est juste un masque API sur IronPdfEngine gRPC. Donc, lorsque vous appelez une méthode dans IronPdf for Node.js, la magie s'opérera à 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échargera les fichiers binaires corrects d'IronPdfEngine depuis 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.

A noter
ironpdf et ironpdf-engine-xxx-xxx doivent avoir la même version de dépendance.

La version de la dépendance ironpdf-engine-xxx-xxx ne se réfère pas à la version de IronPdfEngine à l'intérieur.

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 de IronPdf for Node.js nécessite la version 2024.2.2 de IronPdfEngine. N'utilisez pas la version 2024.2.1 de IronPdfEngine. Accédez à la propriété ironPdfEngineVersion pour vérifier la version nécessaire.

const ironPdfEngineVersion = IronPdfGlobalConfig.ironPdfEngineVersion;
JAVASCRIPT

Comment se connecter

Supposons qu'IronPdfEngine fonctionne à distance à 123.456.7.8:33350

A noter
Pour exécuter IronPdfEngine à distance, veuillez consulter "Comment tirer et exécuter IronPdfEngine."

Il vous suffit d'indiquer à IronPdf où se trouve IronPdfEngine (veuillez vous assurer que l'adresse est accessible, 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

Aussi simple que cela ! Après cela, votre application sera connectée au moteur IronPdfEngine distant !

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

Darrius Serrant
Ingénieur Logiciel Full Stack (WebOps)

Darrius Serrant est titulaire d'une licence en informatique de l'Université de Miami et travaille en tant qu'ingénieur marketing Full Stack WebOps chez Iron Software. Attiré par le code depuis son plus jeune âge, il a vu l'informatique comme à la fois mystérieuse et accessible, en faisant le support parfait pour la créativité et la résolution de problèmes.

Chez Iron Software, Darrius apprécie de créer de nouvelles choses et de simplifier des concepts complexes pour les rendre plus compréhensibles. En tant que l'un de nos développeurs résidents, il a également fait du bénévolat pour enseigner aux étudiants, partageant son expertise avec la prochaine génération.

Pour Darrius, son travail est épanouissant car il est apprécié et a un réel impact.