1. IronPDF
  2. Başlayın
  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

Tüm platformlarda IronPDF'in kurulumu ve yapılandırılması için tam kılavuz.

  1. NuGet Paket Yöneticisi ile https://www.nuget.org/packages/IronPdf yükleyin

    PM > Install-Package IronPdf

  2. Bu kod parçasını kopyalayıp çalıştırın.

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

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

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

    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 Core & 1.75 GB RAM
  • Tavsiye edilen: 2 Core & 8 GB RAM veya üzeri
  • 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-11m 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 beri tüm macOS sürümleri

2. Kurulum Yöntemleri

IronPDF'yi kurmak için iki yol vardır: yerel mod ve uzak motor. Varsayılan olarak, yerel mod tavsiye edilir. Docker/Kubernetes kullanarak üretim sunucularına uygulamak için uzak motor modu kullanın.

Uzak Motor Modu gRPC protokolü aracılığıyla ayrı PDF işleme.
  • En iyi seçenek: Bulut ve konteynerli kurulumlar, eski OS desteği.
  • Paket: IronPdf.Slim
  • Boyut: Daha hafif, birkaç MB yer kaplar.
  • Gereksinimler: Host'a bağlanmak için yapılandırma gerektirir.
Yerel Mod (Varsayılan) Her şey uygulamanızda yerel olarak çalışır
Float Recommended related to 2. Kurulum Yöntemleri
  • En iyi seçenek: Modern Windows, macOS ve Linux kurulumları için.
  • Paket: Tam IronPdf NuGet paketi.
  • Boyut: Daha büyük boyutta (yüzlerce MB), Chrome ve Pdfium ikili dosyalarını içerir.
  • Gereksinimler: Modern işletim sistemlerinde çalışır.

3. Kurulum Seçenekleri

C# PDF kütüphanesini kurmak 5 dakikadan az sürer. NuGet aracılığıyla veya doğrudan indirerek ücretsiz alın ve hemen Visual Studio'da kullanmaya başlayın.

NuGet Paketi
Manuel İndirme
Uzak IronPdfEngine

IronPDF NuGet kütüphanesi veya Visual Studio'daki Paket Yöneticisi Konsolu'na gidin

  1. Solution Explorer'da, References üzerine sağ tıklayın
  2. 'Manage NuGet Packages' > 'Browse' > IronPdf ara
  3. Paketi seçin ve kurun.
Install-Package IronPdf

**ALAKALI:** Daha gelişmiş IronPDF NuGet paketleri

  1. Platformunuz için IronPDF DLL paketini indirin: Windows, Linux, macOS
  2. ZIP dosyasını, Çözüm dizinindeki bir konuma çıkartın.
  3. Visual Studio Çözüm Gezgini'nde 'Bağımlılıklar' üzerine sağ tıklayın.
  4. 'Proje Başvurusu Ekle' > Zip'ten çıkarılan tüm DLL'leri eklemek için 'Gözat' seçeneğini seçin.

Lütfen dikkate alinLütfen unutmayın: Her IronPDF sürümü, uygun IronPdfEngine sürümünü gerektirir. Çapraz sürüm desteği mevcut değildir. Örneğin, IronPDF 2024.2.2, IronPdfEngine 2024.2.2'yi kullanmak zorundadır.

IronPdf kullanarak NuGet'i kurun.

Install-Package IronPdf.Slim

4. Ek Konfigürasyonlar

Lisansı Yönet
Path & Permission
Uzak Motor

IronPDF'yi satın aldığınızda veya 30 günlük deneme için kaydolduğunuzda, size gönderilen lisans anahtarını 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ıGeliştirme ve sunucularınızdaki tüm geçici ve önbellek klasörlerini temizlediğinizden emin olun, ardından bir yol güncellemesinden sonra uygulamanızın temiz bir 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ıKilitleyici bir sunucuda, IIS kullanıcısına (IUSER) kurulum yolu klasörünüze, Windows ve Geçici Klasöre okuma ve yazma izinleri verin.

[Uzak IronPdfEngine] IronPdf.Slim paketini yükledikten sonra, motor konteynerine bağlanın ve uygulama başlatıldığında veya herhangi bir IronPDF yöntemi çağrılmadan önce bağlantıyı yapılandırın.

IronPdfEngine'in uzakta 123.456.7.8:33350 adresinde ç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

**ALAKALI:** IronPdfEngine Sınırlamaları

[Linux] IronPDF'nin gerekli tüm Linux bağımlılıklarını otomatik olarak kurmasını etkinleştirin. İlk HTML-to-PDF işlemi, normalden uzun sürebilir.

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

[Docker] Önceden gereksinimlerin yüklenmesi ve Docker'da ilk kullanımın hızlandırılması için Chrome motorunu önceden başlatın.

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

**ALAKALI:** IronPDF Linux Docker Uyumluluğu ve Kurulumu

5. Dağıtım Senaryoları

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

IronPDF .NET'i şu konumda çalıştırın ve uygulayın

Azure İşlevi
Logo Aws related to 5. Dağıtım Senaryoları

IronPDF .NET'i şu konumda çalıştırın ve uygulayın

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

IronPDF'yi şu konumda çalıştırın

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

IronPDF'yi şu şekilde çalıştırın

Uzak Konteyner

Sonraki Adımlar

HTML to PDF C# için Tam Kılavuz

Eğitimi Görüntüle

Sürüm Geçmişi: Güncellemeler, dönüm noktaları, yol haritası

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

Mühendislik Destek Talebi

Sorun Giderme Görüntüle

Quickstart Guide Native vs Remote Engine

Sıkça Sorulan Sorular

Uzak PDF oluşturma için IronPdfEngine nasıl kurabilirim?

Uzak 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ılandirin. Bu kurulum, uygulamanızın IronPdfEngine örneğine uzaktan baglanmasına olanak tanir.

Uygulamamla birlikte IronPdfEngine kullanmanın ana faydaları nelerdir?

Uygulamanızla birlikte IronPdfEngine kullanmak, PDF görevlerinin uzaktan yürütülmesini sağlar; özellikle eski sistemlerde ve mobil platformlarda platforma ozgu uyumluluk sorunlarini onler. Ayrica çalıştırma sırasında .NET çalışma zamanına ihtiyaçı azaltır.

IronPdfEngine'i neden doğal PDF kütüphanesi yerine kullanmayi seçebilirim?

IronPdfEngine, performansla ilgili yoğun PDF fonksiyonlarını uzaktan çalıştırmak için tercih edilebilir, farkli işletim sistemleriyle olan uyumluluk sorunlarını azaltir ve HTML'den PDF'ye dönüşümde Chrome'yle ayni render'ı kullanarak performansı artırır.

IronPdfEngine yatay ölçeklemeyi destekliyor mu?

Hayır, IronPdfEngine şu anda yatay ölçeklemeyi desteklemez; bu da PDF dosya ikili dosyalarının sunucu belleğinde nasıl işlendiğinden dolayı birden çok örneğe yük dengelemesi yapılamaz anlamına gelir.

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

IronPdfEngine, Docker konteynerleri kullanarak Linux sistemlerinde çalışmak üzere tasarlanmıştır. Ancak, ikili dosyalar platforma ozgudur; bu nedenle işletim sisteminiz için doğru sürümu kullandığınızdan emin olmanız gerekir.

IronPdfEngine kullanara PDF çıktılarım farklıysa ne yapmalıyım?

PDF çıktılarında işletim sistem davranışlarından dolayı ufak farklar olabilir. Farkları en aza indirmek için doğru Docker imajını kullandığınızdan ve renderlemeyi etkileyebilecek herhangi bir issistem ozgü ayarini kontrol ettiğinizden emin olun.

Uygulamamın IronPdfEngine'in doğru sürümünü kullandığından nasıl emin olabilirim?

Uyumlulugu saglamak için, her IronPDF sürümü eslesik bir IronPdfEngine sürümu gerektirir. Farkli sürüm sorunlarini onlemek için her iki bileşeni ayni anda guncellediginizden emin olun.

IronPdfEngine'i Windows üzerinde kullanmanın sınırlamaları nelerdir?

IronPdfEngine'i Windows'ta kullanırken, Docker için Linux Konteynerlerine ihtiyaç olacaktır ve sunucu portunun erişilebilirliğine dikkat edilmelidir. İkili dosyalar platforma özgüdür ve Linux Konteynerlerine geçiş gereklidir.

IronPDF'yi uzak bir IronPdfEngine sunucusuna bağlamak için nasıl yapılandırırım?

Uzak bir sunucu için IronPDF'yi yapılandırmak için, sunucunun IP ve port detaylarını belirterek IronPdf.GrpcLayer.IronPdfConnectionConfiguration.RemoteServer yöntemini Installation.ConnectToIronPdfHost ile kullanın.

IronPdfEngine'i kullanırken uygulama boyutunu en aza indirmek için hangi paketi kullanımaliyim?

IronPDF'yi IronPdfEngine ile çalıştırmak için sadece gerekli bileşenleri içeren IronPdf.Slim paketini NuGet'ten kullanmalısınız, böylece uygulama boyutu azaltılır.

Curtis Chau
Curtis Chau
  Mühendislik takımıyla şimdi sohbet edin
Teknik Yazar

Curtis Chau, Bilgisayar Bilimleri alanında lisans derecesine sahiptir (Carleton Üniversitesi) ve Node.js, TypeScript, JavaScript ve React konularında uzmanlaşmış ön uç geliştirme üzerine uzmanlaşmıştır. Kullanıcı dostu ve estetik açıdan hoş arayüzler tasarlamaya tutkuyla bağlı olan Curtis, modern çerç...

Daha Fazlasını Oku
Başlamaya Hazır mısınız?
Nuget Indirmeler 18,332,619 | Sürüm: 2026.4 yeni yayınlandı
Still Scrolling Icon

Hala Kaydiriyor musunuz?

Hızlı bir kanit mi istiyorsunuz? PM > Install-Package IronPdf
bir örnek çalıştır HTML'nizin PDF olduğunu izleyin.