IRONSOFTWAREHOME

Rozwiązywanie problemów z zależnościami Chrome w IronPDF

Curtis Chau
Curtis Chau
Updated: 22 kwietnia 2026

Google Chromium HTML renderer jest niezbędnym elementem procesu renderowania "Html To PDF" w IronPDF. Niezbędny plik binarny dla tego renderera powinien być łatwo dostępny wewnątrz pakietu IronPDF NuGet. Brak tego pliku binarnego w folderze projektu spowoduje wystąpienie następującego błędu:

Unhandled exception. IronSoftware.Exceptions.IronSoftwareDeploymentException: Error while deploying IronPdf Chrome renderer: 'Unable to locate 'IronInterop'.
Text

Jeśli IronPDF nie jest w stanie automatycznie wdrożyć zależności Chrome, mogą one być wymagały ręcznego dodania do projektu poprzez NuGet. Można dodać wiele zależności:

Zwróć uwagę: W późniejszych wersjach IronPDF wymagane pliki binarne będą automatycznie pobierane z źródła NuGet w oparciu o używany w czasie pracy system operacyjny, jeśli są nieobecne w folderze projektu.

To będzie działać pod warunkiem, że projekt jest podłączony do Internetu i ma uprawnienia do odczytu, zapisu i wykonania w folderze projektu.)}]

Na systemie Windows dobrze jest upewnić się, że docelowy system operacyjny ma zainstalowane Visual C++ Runtimes. Wiele nowoczesnych aplikacji nie może działać bez tego niezbędnego komponentu systemu operacyjnego.

Posiadamy także przewodniki dotyczące zgodności dla Linux i Docker.

Linux

  • Upewnij się, że używasz właściwego pliku Docker.

  • Zamiast IronPDF użyj pakietu NuGet IronPdf.Linux.

  • Ustaw tryb GPU dla renderowania Chrome jako wyłączony:

    IronPdf.Installation.ChromeGpuMode = IronPdf.Engines.Chrome.ChromeGpuModes.Disabled;
  • Wyłącz automatyczną konfigurację dla zależności Linux i Docker:

    csharp
    Installation.LinuxAndDockerDependenciesAutoConfig = false;

macOS

  • Sprawdź, czy środowisko uruchomieniowe .NET jest ustawione na odpowiednią architekturę - x64 lub arm64.

Co zrobić, jeśli to nie rozwiązuje problemu?

Jeśli to nie rozwiązuje problemu, jesteśmy tutaj, aby pomóc. Zgodność jest najwyższym priorytetem dla naszego zespołu inżynierów. Proszę wysłać zgłoszenie błędu e-mailem na support@ironsoftware.com. Wszystkie problemy z kompatybilnością będą dokładnie analizowane przez starszego inżyniera.

Upewnij się, że poinformujesz nas o systemie operacyjnym/platformie, na którą wdrażasz, szczególnie jeśli jest to platforma chmurowa jak AWS czy Azure.

Jak włączyć natywne logowanie w IronPDF

Dołączenie plików dziennika do zgłoszenia błędu więcej niż podwaja szansę, że możemy wyizolować problem i rozwiązać go szybko.

Umieść to na początku swojego kodu przed uruchomieniem jakichkolwiek metod IronPDF (wszystkie wersje po 2021.3.1):

// Set the log file path, this can be a directory or a full file path
IronPdf.Logging.Logger.LogFilePath = "Default.log";
// Enable all logging modes for detailed logging information
IronPdf.Logging.Logger.LoggingMode = IronPdf.Logging.Logger.LoggingModes.All;

Pliki dziennika utworzone przez IronPDF znajdują się w katalogu /bin twojego projektu, gdzie wdrażane są twoje DLLs:

  • default.log (Proces wdrażania)
  • cef.log (Renderowanie)
  • IronSoftwareCefSubprocess.log (Renderowanie i wielowątkowość)
  • IronSoftwareEngine.log (Przydatne do debugowania wyjątków zaczynających się od 'Błąd generowania PDF z...')

Serwery chmurowe często mają określone lokalizacje dla plików dziennika. Mamy przewodniki dotyczące generowania plików dziennika w Azure i AWS.

Curtis Chau
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ęczników.

...
Czytaj więcej

Gotowy, aby rozpocząć?

Nuget Downloads 20,667,543Wersja:2026.7właśnie wydany

Otrzymaj swój darmowy Klucz Próbny na 30 dni natychmiast.
Nie wymaga karty kredytowej ani tworzenia konta
Biblioteka C# NuGet dla plików PDF
Zainstaluj za pomocą NuGet

Wersja: 2026.7

PM > Install-Package IronPdf
nuget.org/packages/IronPdf/
  1. W Eksploratorze Rozwiązań, kliknij prawym przyciskiem Myszy na Odwołania, Zarządzaj pakietami NuGet
  2. Wybierz opcję Przeglądaj i wyszukaj „IronPdf”
  3. Wybierz pakiet i zainstaluj
DLL PDF dla C#
Pobierz DLL

Wersja: 2026.7

Pobierz teraz

lub pobierz instalator Windows tutaj.

  1. Pobierz i rozpakuj IronPDF do lokalizacji takiej jak ~/Libs w katalogu Solution
  2. W Eksploratorze rozwiązań programu Visual Studio kliknij prawym przyciskiem myszy opcję Odwołania. Wybierz opcję Przeglądaj, „IronPdf.dll”

Licencje od 749 USD

Key in blue circle

Uzyskaj natychmiast swój darmowy 30-dniowy Klucz Testowy.

Brak ograniczeń. 100% dostępności. Bez karty kredytowej.

bullet_checkedNie wymaga karty kredytowej ani tworzenia kontaBrak ograniczeń. 100% dostępności. Bez karty kredytowej.
  • Logo Aetna
  • Logo NASA
  • Logo GE
  • Logo Porsche
  • Logo USDA
  • Logo Qatar
Join Millions of Engineers who’ve tried IronPDF
Zarezerwuj swoje darmowe Demo na żywo
Booking Badge

Zaufane przez miliony inżynierów na całym świecie

Logotypy klientów Iron Software
Otrzymaj swoje Konsultacja Bez Zobowiązań
Wypełnij poniższy formularz lub wyślij e-mail na sales@ironsoftware.com
Twoje dane zawsze będą utrzymywane w tajemnicy.
Zaufane przez miliony inżynierów na całym świecie
Logotypy klientów Iron Software
Otrzymaj swój darmowy Klucz Próbny na 30 dni natychmiast.
Nie wymaga karty kredytowej ani tworzenia konta