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

Fehlersuche bei Chrome-Abhängigkeiten 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 automatisch aus der NuGet-Quelle auf der Grundlage des zur Laufzeit verwendeten Betriebssystems heruntergeladen, wenn sie nicht im Projektordner vorhanden sind. Dies gelingt, solange das Projekt mit dem Internet verbunden ist und über Lese-, Schreib- und Ausführungsrechte für den Projektordner verfügt.

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.

Wir bieten außerdem Kompatibilitätsleitfäden für Linux und Docker an.

Linux

  • Die richtige Docker-Datei verwenden.
  • 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;
    $vbLabelText   $csharpLabel

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

    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@Iironsoftware.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;
$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. Wir haben Anleitungen zur Generierung von Log-Dateien in Azure und 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 17,012,929 | Version: 2025.12 gerade veröffentlicht