1. IronPDF
  2. Fehlersuche
  3. Fehler beim Bereitstellen von Chrome-Abhängigkeiten

Troubleshooting Chrome Dependencies in IronPDF

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

Der Google Chromium HTML-Renderer ist ein wesentlicher Bestandteil des "Html zu PDF"-Rendering-Prozesses von IronPDF. Die wesentliche Binärdatei für diesen Renderer sollte sich leicht im IronPDF NuGet-Paket finden lassen. Fehlt diese Binärdatei im Projektordner, wird folgender Fehler angezeigt:

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

Wenn IronPDF die Chrome-Abhängigkeiten nicht automatisch bereitstellen kann, müssen sie möglicherweise manuell über NuGet zu einem Projekt hinzugefügt werden. Mehrere Abhängigkeiten können hinzugefügt werden:

Hinweis:In späteren Versionen von IronPDF werden die erforderlichen Binärdateien bei Abwesenheit im Projektordner automatisch von der NuGet-Quelle basierend auf dem zur Laufzeit verwendeten Betriebssystem heruntergeladen. Dies wird erfolgreich sein, solange das Projekt mit dem Internet verbunden ist und Lese-, Schreib- und Ausführungsberechtigungen für den Projektordner hat.

Unter Windows ist es eine gute Idee, sicherzustellen, dass das Zielbetriebssystem über Visual C++ Runtimes verfügt. Viele moderne Anwendungen können ohne diese wesentliche Betriebssystemkomponente nicht ausgeführt werden.

We also have compatibility guides for Linux and Docker.

Linux

  • Sicherstellen, dass die richtige Docker-Datei verwendet wird.
  • Verwenden Sie das IronPdf.Linux NuGet-Paket anstelle von IronPdf.

  • Stellen Sie den GPU-Modus für das Chrome-Rendering auf deaktiviert:

    IronPdf.Installation.ChromeGpuMode = IronPdf.Engines.Chrome.ChromeGpuModes.Disabled;
    IronPdf.Installation.ChromeGpuMode = IronPdf.Engines.Chrome.ChromeGpuModes.Disabled;
    IronPdf.Installation.ChromeGpuMode = IronPdf.Engines.Chrome.ChromeGpuModes.Disabled
    $vbLabelText   $csharpLabel

  • Deaktivieren Sie die automatische Konfiguration für Linux- und Docker-Abhängigkeiten:

    csharp
Installation.LinuxAndDockerDependenciesAutoConfig = false;
    csharp
Installation.LinuxAndDockerDependenciesAutoConfig = false;
    csharp Installation.LinuxAndDockerDependenciesAutoConfig = False
    $vbLabelText   $csharpLabel

MacOS

  • Überprüfen Sie, ob die .NET-Laufzeit auf die richtige Architektur eingestellt ist - x64 oder arm64.

Was zu tun ist, wenn das nicht hilft?

Wenn das das Problem nicht löst, sind wir hier, um zu helfen. Kompatibilität hat für unser Ingenieurteam hohe Priorität. Bitte senden Sie einen Fehlerbericht per E-Mail an support@ironsoftware.com. Alle Kompatibilitätsprobleme werden von einem leitenden Ingenieur ernsthaft geprüft.

Informieren Sie uns unbedingt über das Einsatzbetriebssystem/-plattform, insbesondere wenn es sich um eine Cloud-Plattform wie AWS oder Azure handelt.

So aktivieren Sie die native Protokollierung in IronPDF

Das Anhängen von Protokolldateien an einen Fehlerbericht verdoppelt mehr als die Wahrscheinlichkeit, dass wir das Problem isolieren und schnell lösen können.

Platzieren Sie dies oben in Ihrem Code, bevor Sie IronPDF-Methoden ausführen (alle Versionen nach 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;
// 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;
' 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
$vbLabelText   $csharpLabel

Logdateien, die von IronPDF erstellt werden, befinden sich im /bin-Verzeichnis Ihres Projekts, wo Ihre DLLs bereitgestellt werden:

  • default.log (Bereitstellungsprozess)
  • cef.log (Rendering)
  • IronSoftwareCefSubprocess.log (Rendering & Threading)
  • IronSoftwareEngine.log (Nützlich zum Debuggen von Ausnahmen, die mit "Fehler beim Generieren von PDF aus..." beginnen)

Cloud-Server haben oft spezifische Speicherorte für Protokolldateien. We have guides for generating log files in Azure and AWS.

Curtis Chau
Curtis Chau
  Jetzt mit dem Ingenieurteam chatten
Technischer Autor

Curtis Chau hat einen Bachelor-Abschluss in Informatik von der Carleton University und ist spezialisiert auf Frontend-Entwicklung mit Expertise in Node.js, TypeScript, JavaScript und React. Leidenschaftlich widmet er sich der Erstellung intuitiver und ästhetisch ansprechender Benutzerschnittstellen und arbeitet gerne mit modernen Frameworks sowie der Erstellung gut strukturierter, optisch ansprechender ...

Weiterlesen
Bereit anzufangen?
Nuget Downloads 16,154,058 | Version: 2025.11 gerade veröffentlicht