IronPDF'de Chrome Bağımlılıklarını Sorun Giderme

Güncellendi:Nisan 21, 2026

Translated

View the article in English

Google Chromium HTML işleyici, IronPDF'in 'Html To PDF' oluşturma sürecinin önemli bir parçasıdır. Bu işleyicinin temel ikili dosyası, IronPDF NuGet paketinde kolayca bulunur. Proje klasöründen bu ikili dosyanın yokluğu şu hatayı atacak:

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

IronPDF, Chrome Bağımlılıklarını otomatik olarak dağıtamazsa, bunların projeye elle NuGet aracılığıyla eklenmesi gerekebilir. Birden fazla bağımlılık eklenebilir:

Lütfen dikkate alınIronPDF'nin daha sonraki sürümlerinde, gerekirse bu ikili dosyalar, çalışma zamanı sırasında kullanılan işletim sistemine göre NuGet kaynağından otomatik olarak indirilecektir, eğer proje klasöründen yoklarsa. Proje internete bağlı olduğu ve proje klasörüne Okuma, Yazma ve Çalıştırma izni verdiği süre boyunca bu başarılı olacaktır.

Windows'ta, hedef işletim sisteminde Visual C++ Runtimes'ın yüklü olduğundan emin olmak iyi bir fikirdir. Birçok modern uygulama bu işletim sistemi bileşeni olmadan çalışamaz.

Ayrıca Linux ve Docker hakkında uyumluluk kılavuzlarımız da var.

Linux

Doğru Docker dosyasının kullanıldığından emin olun.
IronPDF yerine IronPdf.Linux NuGet paketini kullanın.

Chrome oluşturma için GPU modunu devre dışı olarak ayarlayın:

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

Linux ve Docker bağımlılıkları için otomatik yapılandırmayı devre dışı bırakın:

csharp
Installation.LinuxAndDockerDependenciesAutoConfig = false;

csharp
Installation.LinuxAndDockerDependenciesAutoConfig = false;

csharp Installation.LinuxAndDockerDependenciesAutoConfig = False

$vbLabelText $csharpLabel

macOS

.NET çalışma zamanının x64 veya arm64 olarak doğru mimariye ayarlandığından emin olun.

Bunu çözmüyorsa ne yapılmalı?

Eğer bu çözmüyorsa, yardımcı olmak için buradayız. Uyumluluk, mühendislik ekibimiz için yüksek önceliklidir. Lütfen bir e-posta hata raporunu support@ironsoftware.com adresine gönderin. Tüm uyumluluk sorunları kıdemli bir mühendis tarafından ciddi şekilde incelenecektir.

Özellikle bir bulut platformu (AWS veya Azure gibi) kurumu yapılıyorsa, hangi işletim sistemi/platforma dağıtım yapıldığı hakkında bize bilgi vermeyi unutmayın.

IronPDF'de Yerel Günlüğü Etkinleştirme

Hata raporuna günlük dosyalarını eklemek, sorunu izole edebilme ve hızla çözebilme olasılığını iki kattan fazla artırır.

Herhangi bir IronPDF yöntemini çalıştırmadan önce, kodunuzun en üstüne bunu yerleştirin (2021.3.1'den sonraki tüm sürümler):

// 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

IronPDF tarafından oluşturulan günlük dosyaları, DLL'lerinizin dağıtıldığı proje dizininizin /bin klasöründe bulunur:

default.log (Dağıtım süreci)
cef.log (Renderleme)
IronSoftwareCefSubprocess.log (Renderleme & İş parçacığı yürütme)
IronSoftwareEngine.log (PDF oluşturma hatasıyla başlayan istisnaların hata ayıklaması için yararlıdır)

Bulut sunucularının günlük dosyaları için genellikle belirli konumları vardır. Azure ve AWS 'de günlük dosyaları oluşturma kılavuzlarımız var.

Curtis Chau

Mühendislik ekibiyle şimdi sohbet edin

Teknik Yazar

Curtis Chau, Bilgisayar Bilimleri alanında Lisans Derecesine (Carleton Üniversitesi) sahip ve Node.js, TypeScript, JavaScript ve React konularında uzmanlaşmış ön uç geliştirmeyle ilgileniyor. Sezgisel ve estetik açıdan hoş kullanıcı arayüzleri oluşturma tutkunu, Curtis modern çerçevelerle çalışmayı ve iyi yapı...

Daha Fazla Oku

Başlamaya Hazır mısınız?

Nuget İndirmeler 19,014,616 | Sürüm: 2026.5 just released