1. .NET
  2. Başlamak için
  3. Kurulum Genel Bakış

Kurulum Genel Bakış

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

IronPDF'in tüm platformlarda nasıl kurulduğu ve yapılandırıldığına yönelik tam kılavuz.

  1. IronPDF aşağıdaki NuGet Paket Yöneticisi ile yükleyin

    PM > Install-Package IronPdf

  2. Bu kod parçacığını kopyalayın ve çalıştırın.

    IronPdf.ChromePdfRenderer
       .StaticRenderHtmlAsPdf("<p>Hello World</p>")
       .SaveAs("pixelperfect.pdf");

  3. Canlı ortamınızda test için dağıtım yapın

    Ücretsiz deneme ile bugün projenizde IronPDF kullanmaya başlayın

    arrow pointer

1. Platform Gereksinimleri

Platform .NET Sürümü Donanım Ek Gereksinimler, Uyumluluk
Logo Table Windows related to 1. Platform Gereksinimleri
Windows 		.NET 10, 9, 8, 7, 6, 5, .NET Core, .NET Standard ve .NET Framework.
  • Minimum: 1 Çekirdek & 1,75 GB RAM
  • Önerilen: 2 Çekirdek & 8 GB RAM veya daha fazla
  • Windows 10, 11 ve Windows Server
  • Visual C++ Yeniden Dağıtılabilir (x86 & x64)
Logo Table Linux related to 1. Platform Gereksinimleri
Linux
  • 64-bit Linux İşletim Sistemleri: Ubuntu 22, Ubuntu 20, Ubuntu 18, Ubuntu 16, Debian 10-11, CentOS 8, Fedora Linux 33, Amazon, AWS, Linux 2
  • IronCefSubprocess
  • Chrome bağımlılıkları
Logo Table Mac related to 1. Platform Gereksinimleri
macOS 		2020'den bu yana tüm macOS sürümleri

2. Yükleme Yöntemleri

IronPDF'i yüklemenin iki yolu vardır: yerel mod ve uzak motor. Varsayılan olarak, yerel mod önerilir. Docker/Kubernetes kullanarak üretim sunucularına dağıtım için uzak motor modunu kullanın.

Uzak Motor Modu gRPC protokolü aracılığıyla ayrı PDF işlemleri.
  • En iyi için: Bulut ve konteynerleştirilmiş dağıtımlar, eski OS desteği.
  • Paket: IronPdf.Slim
  • Boyut: Daha hafif, birkaç MB kaplar.
  • Gereksinimler: Ana makinaya bağlantının yapılandırılması gereklidir.
Yerel Mod (Varsayılan) Her şey uygulamanızda yerel olarak çalışır
Float Recommended related to 2. Yükleme Yöntemleri
  • En iyi için: Modern Windows, macOS ve Linux dağıtımları.
  • Paket: Tam IronPDF NuGet paketi.
  • Boyut: Daha büyük boyut (yüzlerce MB), Chrome ve Pdfium ikili dosyalarını içerir.
  • Gereksinimler: Modern işletim sistemlerinde çalışır.

3. Yükleme Seçenekleri

C# PDF kütüphanesini yüklemek 5 dakikadan az sürer. NuGet veya doğrudan indirme yoluyla ücretsiz edinin ve anında Visual Studio'yu kullanmaya başlayın.

NuGet Paketi
Manuel İndirme
Uzak IronPdfEngine

IronPDF NuGet kütüphanesine gidin (veya Visual Studio'daki Paket Yöneticisi Konsolunda)

  1. Çözüm Gezgini'nde Referanslar'a sağ tıklayın
  2. 'NuGet Paketlerini Yönet' > 'Gözat' > IronPDF'yi ara seçeneğini seçin
  3. Paketi seçin ve yükleyin.
Install-Package IronPdf

**İLGİLİ:** Daha gelişmiş IronPDF NuGet paketleri

  1. Platformunuz için IronPDF DLL paketini indirin: Windows, Linux, macOS
  2. ZIP dosyasını Çözüm dizininizdeki bir konuma açın.
  3. Visual Studio Çözüm Gezgini'nde, 'Bağımlılıklar' üzerinde sağ tıklayın.
  4. 'Proje Başvurusunu Ekle' > Tüm DLL'leri içermek için 'Gözat'ı seçin.

Lütfen dikkate alınPlease note: Her IronPDF sürümü, eşleşen IronPdfEngine sürümünü gerektirir. Çapraz sürüm desteği mevcut değil. Örneğin, IronPDF 2024.2.2, IronPdfEngine 2024.2.2'yi kullanmalıdır.

NuGet kullanarak IronPDF'yi yükleyin.

Install-Package IronPdf.Slim

4. Ek Yapılandırmalar

Lisansı Yönet
Path & Permission
Uzak Motor

IronPDF'i satın aldıktan veya 30 günlük deneme kaydı yaptıktan sonra lisans anahtarını e-postanıza bulun.

Uygulamanızın başında lisans anahtarınızı ekleyin.

IronPdf.License.LicenseKey = "KEY";
IronPdf.License.LicenseKey = "KEY";
Imports IronPdf

IronPdf.License.LicenseKey = "KEY"
$vbLabelText   $csharpLabel

Lisans durumunu kontrol edin.

bool valid = IronPdf.License.IsLicensed;
bool valid = IronPdf.License.IsLicensed;
Imports IronPdf

Dim valid As Boolean = IronPdf.License.IsLicensed
$vbLabelText   $csharpLabel

IronPdf.Installation nesnesinin TempFolderPath özelliğini ayarlayın.

IronPdf.Installation.TempFolderPath = @"C:\My\Safe\Path";
IronPdf.Installation.TempFolderPath = @"C:\My\Safe\Path";
IronPdf.Installation.TempFolderPath = "C:\My\Safe\Path"
$vbLabelText   $csharpLabel

İpuçlarıTüm geçici ve önbellek klasörlerini geliştirme ve sunucularınızda temizlediğinizden emin olun, ardından yolu güncelledikten sonra bir uygulamanızın temiz sürümünü yeniden dağıtın.

Uygulama kapsamında geçici klasör ortam değişkenini ayarlama.

using IronPdf;

// Adjusts System.IO.Path.GetTempFileName and System.IO.Path.GetTempPath behavior for the application
var MyTempPath = @"C:\Safe\Path\";
Environment.SetEnvironmentVariable("TEMP", MyTempPath, EnvironmentVariableTarget.Process);
Environment.SetEnvironmentVariable("TMP", MyTempPath, EnvironmentVariableTarget.Process);

// Set IronPDF Temp Path
IronPdf.Installation.TempFolderPath = System.IO.Path.Combine(MyTempPath, "IronPdf");

// Your PDF Generation and editing code
var Renderer = new IronPdf.ChromePdfRenderer();
using var Doc = Renderer.RenderHtmlAsPdf("<h1>Html with CSS and Images</h1>");
Doc.SaveAs("example.pdf");
using IronPdf;

// Adjusts System.IO.Path.GetTempFileName and System.IO.Path.GetTempPath behavior for the application
var MyTempPath = @"C:\Safe\Path\";
Environment.SetEnvironmentVariable("TEMP", MyTempPath, EnvironmentVariableTarget.Process);
Environment.SetEnvironmentVariable("TMP", MyTempPath, EnvironmentVariableTarget.Process);

// Set IronPDF Temp Path
IronPdf.Installation.TempFolderPath = System.IO.Path.Combine(MyTempPath, "IronPdf");

// Your PDF Generation and editing code
var Renderer = new IronPdf.ChromePdfRenderer();
using var Doc = Renderer.RenderHtmlAsPdf("<h1>Html with CSS and Images</h1>");
Doc.SaveAs("example.pdf");
Imports IronPdf
Imports System.IO

' Adjusts System.IO.Path.GetTempFileName and System.IO.Path.GetTempPath behavior for the application
Dim MyTempPath As String = "C:\Safe\Path\"
Environment.SetEnvironmentVariable("TEMP", MyTempPath, EnvironmentVariableTarget.Process)
Environment.SetEnvironmentVariable("TMP", MyTempPath, EnvironmentVariableTarget.Process)

' Set IronPDF Temp Path
IronPdf.Installation.TempFolderPath = Path.Combine(MyTempPath, "IronPdf")

' Your PDF Generation and editing code
Dim Renderer As New IronPdf.ChromePdfRenderer()
Using Doc = Renderer.RenderHtmlAsPdf("<h1>Html with CSS and Images</h1>")
    Doc.SaveAs("example.pdf")
End Using
$vbLabelText   $csharpLabel

İpuçlarıBir kısıtlı sunucuda, IIS kullanıcısına (IUSER) kurulum yolunuza ve Windows ve Geçici Klasörünüze okuma ve yazma izinleri verin.

[Uzak IronPdfEngine] IronPdf.Slim paketini yükledikten sonra, motor kapsayıcısına bağlanın ve uygulama başlangıç noktasında veya herhangi bir IronPDF yöntemini çağırmadan önce bağlantıyı yapılandırın.

IronPdfEngine'in uzaktan 123.456.7.8:33350'de çalıştığını varsayarak:

Installation.ConnectToIronPdfHost(
    IronPdf.GrpcLayer.IronPdfConnectionConfiguration.RemoteServer("123.456.7.8:33350")
);
Installation.ConnectToIronPdfHost(
    IronPdf.GrpcLayer.IronPdfConnectionConfiguration.RemoteServer("123.456.7.8:33350")
);
Installation.ConnectToIronPdfHost( _
    IronPdf.GrpcLayer.IronPdfConnectionConfiguration.RemoteServer("123.456.7.8:33350") _
)
$vbLabelText   $csharpLabel

**İLGİLİ:** IronPdfEngine Kısıtlamaları

[Linux] IronPDF'in gerekli tüm Linux bağımlılıklarını otomatik olarak yüklemesini etkinleştirin. İlk HTML'den PDF'ye işlem normalden daha uzun sürebilir.

Installation.LinuxAndDockerDependenciesAutoConfig = true;
Installation.LinuxAndDockerDependenciesAutoConfig = true;
Installation.LinuxAndDockerDependenciesAutoConfig = True
$vbLabelText   $csharpLabel

[Docker] Chrome motorunu önceden başlatmak, ön gerekli şartları yüklemek ve Docker'da ilk kez kullanım hızını artırmak için.

IronPdf.Installation.Initialize();
IronPdf.Installation.Initialize();
IronPdf.Installation.Initialize()
$vbLabelText   $csharpLabel

**İLGİLİ:** IronPDF Linux Docker Uyumluluk ve Kurulum

5. Dağıtım Senaryoları

Logo Azure related to 5. Dağıtım Senaryoları

IronPDF .NET'i Çalıştır ve Dağıt

Azure Function
Logo Aws related to 5. Dağıtım Senaryoları

IronPDF .NET'i Çalıştır ve Dağıt

AWS Lambda
Logo Linux related to 5. Dağıtım Senaryoları

IronPDF'i Çalıştırma

Linux Docker Konteyneri
Logo Remote related to 5. Dağıtım Senaryoları

IronPDF'i

Uzak Kapsayıcı olarak Çalıştırın

Sonraki Adımlar

HTML'den PDF'ye C# Üzerine Tam Kılavuz

Öğreticiye Bak

Güncellemeler: Değişiklikler, kilometre taşları, yol haritası

Ürün Güncellemelerini Görüntüle

Mühendislik Desteği Talep Edin

Sorun Gidermeye Bakın

Quickstart Guide Native vs Remote Engine

Sıkça Sorulan Sorular

Uzaktan PDF oluşturma için IronPdfEngine'i nasıl kurarım?

Uzaktan PDF oluşturma için IronPdfEngine'i kurmak için, NuGet'ten IronPdf.Slim paketini yükleyin ve IronPdfConnectionConfiguration sınıfını kullanarak bağlantı ayarlarını yapılandırın. Bu kurulum, uygulamanızı uzaktan IronPdfEngine örneğine bağlamanıza izin verir.

Uygulamamla birlikte IronPdfEngine'i kullanmanın ana faydaları nelerdir?

Uygulamanızla IronPdfEngine kullanmak, PDF görevlerini uzaktan yürütmeyi sağlar, özellikle eski sistemler ve mobil platformlarda platforma özgü uyumluluk sorunlarını önler. Ayrıca, yürütme sırasında .NET çalışma zamanı gereksinimini ortadan kaldırır.

Neden yerel PDF kütüphanesi yerine IronPdfEngine kullanmayı tercih edebilirim?

Farklı işletim sistemleriyle uyumluluk sorunlarını azaltmak ve HTML’den PDF’ye dönüşüm için Chrome ile aynı render kapasitesini kullanarak performansı artırmak için IronPdfEngine'i tercih edebilirsiniz.

IronPdfEngine'te yatay ölçeklendirme destekleniyor mu?

Hayır, IronPdfEngine şu anda yatay ölçeklendirmeyi desteklemiyor, bu nedenle sunucu belleğinde PDF dosya ikili dosyalarının işlenme şekli nedeniyle birden fazla örnek arasında yük dengelemesi yapılamaz.

IronPdfEngine farklı işletim sistemlerinde çalışabilir mi?

IronPdfEngine, Docker konteynerlarını kullanarak Linux sistemlerinde çalışacak şekilde tasarlanmıştır. Ancak, ikili dosyalar platforma özgüdür, bu nedenle işletim sisteminiz için doğru versiyonu kullandığınızdan emin olmalısınız.

IronPdfEngine kullandığımda PDF çıktılarım farklı ise ne yapmalıyım?

PDF çıktıları, farklı işletim sistemi davranışlarına bağlı olarak hafifçe değişebilir. Farklılıkları en aza indirmek için doğru Docker görüntüsünü kullandığınızdan emin olun ve render işlemini etkileyebilecek herhangi bir işletim sistemi spesifik ayarı kontrol edin.

Uygulamamın doğru IronPdfEngine versiyonunu kullandığından nasıl emin olabilirim?

Uyumluluğu sağlamak için, her IronPDF versiyonu için uygun IronPdfEngine versiyonu gereklidir. Çapraz versiyon sorunlarını önlemek için her iki bileşeni de eşzamanlı olarak güncellediğinizden emin olun.

Windows üzerinde IronPdfEngine kullanırken hangi sınırlamalarla karşılaşırsınız?

Windows üzerinde IronPdfEngine kullanırken, Docker için Linux Containers gereksinime ihtiyacınız vardır ve sunucu portunun erişilebilir olduğundan emin olmalısınız. İkili dosyalar platforma özgüdür ve Linux Containers'a geçiş gereklidir.

IronPDF'yi uzak IronPdfEngine sunucusuna nasıl bağlayabilirim?

IronPDF’i uzak bir sunucuya bağlamak için Installation.ConnectToIronPdfHost kullanarak, IronPdf.GrpcLayer.IronPdfConnectionConfiguration.RemoteServer yöntemini kullanın ve sunucu IP ve port detaylarını belirtin.

IronPdfEngine kullanırken uygulama büyüklüğünü nasıl en aza indirebilirim?

Uygulama boyutunu en aza indirmek için, NuGet'ten IronPdf.Slim paketini kullanmalısınız, çünkü bu paket yalnızca IronPDF'i IronPdfEngine ile çalıştırmak için gerekli bileşenleri içerir ve böylece uygulama boyutunu küçültür.

Curtis Chau
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
Still Scrolling Icon

Hâlâ Kaydırıyor Musunuz?

Hızlıca kanıt ister misiniz? PM > Install-Package IronPdf
bir örnek çalıştır HTML'nizi bir PDF'ye dönüştüğünü izleyin.