Comment utiliser IronPdfEngine
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.
Comment utiliser IronPdfEngine dans Node.js
- Installer la bibliothèque Node.js pour utiliser IronPdfEngine
- Inclure la bibliothèque en l'installant à l'aide de npm
- Obtenir le binaire Chrome via la même installation
- Vérifiez la version nécessaire en accédant à la propriété ironPdfEngineVersion
- Utiliser le moteur IronPdfEngine pour convertir HTML en PDF avec un moteur de rendu identique à celui de Chrome
Commencez avec IronPDF
Commencez à utiliser IronPDF dans votre projet dès aujourd'hui avec un essai gratuit.
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
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
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;
Comment se connecter
Supposons qu'IronPdfEngine fonctionne à distance à 123.456.7.8:33350
A noter
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"
});
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."