1. IronPDF
  2. Rozpocznij
  3. Użyj IronPdfEngine

Jak używać IronPdfEngine

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

IronPdfEngine to serwer gRPC stworzony do nadzorowania szeregu zadań IronPDF, obejmujących tworzenie, edycję i odczyt dokumentów PDF.

Jak korzystać z IronPdfEngine w Node.js

  1. Zainstaluj bibliotekę Node.js, aby korzystać z IronPdfEngine.
  2. Aby dołączyć bibliotekę, zainstaluj ją za pomocą npm.
  3. Pobierz plik binarny Chrome za pomocą tej samej instalacji.
  4. Check the version needed by accessing the `ironPdfEngineVersion` property.
  5. Użyj IronPdfEngine do renderowania HTML do PDF przy użyciu renderera identycznego z Chrome.

IronPdf Node.js i IronPdfEngine

IronPDF for Node.js wymaga do działania biblioteki IronPdfEngine. Kod Node.js jest jedynie maską API nad gRPC IronPdfEngine. Kiedy więc wywołujesz dowolną metodę w IronPDF for Node.js, magia dzieje się wewnątrz IronPdfEngine!

Domyślnie IronPDF for Node.js uruchamia IronPdfEngine jako podproces i komunikuje się z nim do momentu zamknięcia aplikacji.

Uwaga: Każda wersja IronPDF for Node.js wymaga konkretnej wersji IronPdfEngine. Nie jest obsługiwane korzystanie z różnych wersji.

IronPDF for Node.js z lokalnym IronPdfEngine

Opcja 1: Pobierz IronPdfEngine w czasie wykonywania

Domyślnie po zainstalowaniu IronPdf w projekcie JavaScript, przy pierwszym uruchomieniu IronPdf wykryje platformę (np. Windows x64) i pobierze z Internetu odpowiednie pliki binarne IronPdfEngine.

npm install @ironsoftware/ironpdf
npm install @ironsoftware/ironpdf
SHELL

Zalety:

  • Pakiet aplikacji będzie niewielki.
  • Można wdrażać na wielu platformach.

Wady:

  • Podczas kilku pierwszych uruchomień wymagany jest dostęp do Internetu.
  • Wolny czas uruchamiania.

Opcja 2 (zalecana): Zainstaluj IronPdfEngine jako zależność

IronPDF for Node.js pozwala na dodanie IronPdfEngine jako zależności. Te zaleznosci IronPdfEngine zawieraja IronPdfEngine w pliku .zip i beda go automatycznie wyodrebniac i uzywac.

Możesz zainstalować jedną lub wiele z tych zależności IronPdfEngine.

Uwaga: wersje zaleznosci ironpdf i ironpdf-engine-xxx-xxx musza byc takie same. Wersja zaleznosci ironpdf-engine-xxx-xxx nie odnosi sie do wersji IronPdfEngine wewnatrz.

Instalacja specyficzna dla platformy:

  • 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

Zalety:

  • Szybszy czas uruchamiania.
  • Dostęp do Internetu nie jest potrzebny po zainstalowaniu zależności.

Wady:

  • Pakiet aplikacji będzie duży.
  • Należy określić platformy docelowe.

IronPDF for Node.js z Remote IronPdfEngine

Aby korzystać ze zdalnego IronPdfEngine, potrzebna jest konkretna wersja IronPdfEngine. Na przyklad, jesli IronPdf for Node.js wersja 2024.2.2 wymaga wersji IronPdfEngine 2024.2.2, nie uzywaj wersji IronPdfEngine 2024.2.1. Uzyskaj dostep do wlasciwosci ironPdfEngineVersion, aby sprawdzic wymagana wersje.

const ironPdfEngineVersion = IronPdfGlobalConfig.ironPdfEngineVersion;
const ironPdfEngineVersion = IronPdfGlobalConfig.ironPdfEngineVersion;
JAVASCRIPT

Jak się połączyć

Zaloz, ze IronPdfEngine dziala zdalnie na 123.456.7.8:33350.

Zobacz "Jak pobrać i uruchomić IronPdfEngine".

Aby nawiązać połączenie, wystarczy określić lokalizację IronPdfEngine (upewnij się, że adres jest dostępny i nie jest blokowany przez zaporę sieciową). Dodaj ten kod na początkowym etapie działania aplikacji lub tuż przed wywołaniem dowolnej metody IronPDF.

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

To takie proste! Następnie Twoja aplikacja zostanie połączona z Remote IronPdfEngine!

W przypadku zdalnego IronPdfEngine nie jest wymagana instalacja IronPdfEngine jako zależności. Możesz pominąć sekcję zatytułowaną "Opcja 2 (zalecana) – zainstaluj IronPdfEngine jako zależność".

Często Zadawane Pytania

Do czego służy IronPdfEngine w Node.js?

IronPdfEngine to serwer gRPC używany w Node.js do zarządzania zadaniami związanymi z plikami PDF, takimi jak tworzenie, edycja i renderowanie, zapewniający płynną obsługę plików PDF.

Jak zainstalować IronPDF for Node.js?

Możesz zainstalować IronPDF for Node.js za pomocą npm, używając polecenia npm install @ironsoftware/ironpdf.

Jakie są różnice między konfiguracją lokalną a zdalną dla IronPdfEngine?

Konfiguracja lokalna polega na pobraniu IronPdfEngine w czasie wykonywania lub zainstalowaniu go jako zależności, co zapewnia szybsze uruchamianie. Konfiguracja zdalna łączy się ze zdalnie hostowanym IronPdfEngine, eliminując potrzebę lokalnej instalacji.

Jak zapewnić kompatybilność między wersjami IronPdf i IronPdfEngine?

Każda wersja IronPDF for Node.js wymaga określonej wersji IronPdfEngine. Użyj właściwości ironPdfEngineVersion, aby sprawdzić wymaganą wersję i upewnić się, że obie wersje są zgodne.

Jakie są zalety zainstalowania IronPdfEngine jako zależności?

Zainstalowanie IronPdfEngine jako zależności skraca czas uruchamiania i eliminuje potrzebę dostępu do Internetu po instalacji, choć zwiększa rozmiar pakietu aplikacji.

Jak połączyć się ze zdalnym IronPdfEngine?

Aby połączyć się ze zdalnym IronPdfEngine, użyj IronPdfGlobalConfig.setConfig do określenia adresu serwera, upewniając się, że jest on dostępny i nie jest blokowany przez zaporę sieciową.

Czy do pobrania środowiska uruchomieniowego IronPdfEngine wymagany jest dostęp do Internetu?

Tak, dostęp do Internetu jest wymagany podczas kilku pierwszych uruchomień w trakcie pobierania IronPdfEngine w czasie wykonywania, co powoduje również wydłużenie czasu uruchamiania.

Czy muszę zainstalować IronPdfEngine, aby korzystać z niego zdalnie?

Nie, w przypadku korzystania ze zdalnego IronPdfEngine nie ma potrzeby instalowania go lokalnie jako zależności.

Czy IronPdfEngine może być używany na różnych platformach?

Tak, IronPdfEngine można wdrożyć na wielu platformach. Dostępne są polecenia npm specyficzne dla platformy, umożliwiające instalację w systemach Windows, Linux i macOS.

Czy IronPDF jest kompatybilny z .NET 10 i jakie środowiska obsługuje?

Tak, IronPDF jest w pełni kompatybilny z .NET 10 (a także z .NET 9, 8, 7 itp.). Obsługuje języki C#, VB.NET i F# oraz działa na różnych platformach, takich jak Windows, Linux i macOS — w tym w środowiskach Docker i chmurowych — dzięki czemu nadaje się do projektów .NET 10 w sieci, na komputerach stacjonarnych, konsolach lub w chmurze.

Curtis Chau
Curtis Chau
  Czat z zespołem inżynierów teraz
Autor tekstów technicznych

Curtis Chau posiada tytuł licencjata z informatyki (Uniwersytet Carleton) i specjalizuje się w front-endowym rozwoju, z ekspertką w Node.js, TypeScript, JavaScript i React. Pasjonuje się tworzeniem intuicyjnych i estetycznie przyjemnych interfejsów użytkownika, Curtis cieszy się pracą z nowoczesnymi frameworkami i tworzeniem dobrze zorganizowanych, atrakcyjnych wizualnie podrę...

Czytaj więcej
Gotowy, aby rozpocząć?
Wersja: 2026.4 just released
Still Scrolling Icon

Wciąż przewijasz?

Czy chcesz szybko dowodu?
Uruchom przykład i zobacz, jak Twój kod HTML zamienia się w plik PDF.