Przegląd instalacji
Kompletny przewodnik po instalacji i konfiguracji IronPDF na wszystkich platformach.
-
1Install IronPDF with NuGet Package Manager
-
2Skopiuj i uruchom ten fragment kodu.
IronPdf.ChromePdfRenderer .StaticRenderHtmlAsPdf("<p>Hello World</p>") .SaveAs("pixelperfect.pdf");C# -
3Wdrożenie do testowania w środowisku produkcyjnym
Rozpocznij używanie IronPDF w swoim projekcie już dziś z darmową wersją próbną
1. Wymagania platformowe
| Platforma | Wersja .NET | Sprzęt | Dodatkowe wymagania, kompatybilność |
|---|---|---|---|
 | .NET 10, 9, 8, 7, 6, 5, .NET Core, .NET Standard i .NET Framework. |
|
|
 |
| ||
 | Wszystkie wersje macOS od 2020 |
2. Metody instalacji
Istnieją dwa sposoby instalacji IronPDF: tryb natywny i zdalny silnik. Domyślnie zaleca się tryb natywny. Do wdrażania na serwerach produkcyjnych używając Docker/Kubernetes, użyj trybu zdalnego silnika.
- Najlepsze dla: Wdrożenia w chmurze i konteneryzowane, wsparcie dla starszych systemów operacyjnych.
- Paczka: IronPdf.Slim
- Rozmiar: Bardziej lekki, zajmuje tylko kilka MB.
- Wymagania: Wymaga skonfigurowania połączenia z hostem.
- Najlepsze dla: Nowoczesne wdrożenia na Windows, macOS i Linux.
- Pakiet: Pelny pakiet NuGet IronPDF.
- Rozmiar: Większy rozmiar (setki MB), zawiera Chrome i biblioteki Pdfium.
- Wymagania: Działa na nowoczesnych systemach operacyjnych.
3. Opcje instalacji
Zainstalowanie biblioteki C# PDF zajmuje mniej niż 5 minut. Pobierz bezpłatnie przez NuGet lub bezpośrednie pobieranie i zacznij używać w Visual Studio natychmiast.
Przejdz do biblioteki NuGet IronPDF (lub konsoli Package Manager w Visual Studio)
- W Eksploratorze Rozwiązań kliknij prawym przyciskiem na Odwołania
- Wybierz 'Manage NuGet Packages' > 'Browse' > Wyszukaj IronPDF
- Wybierz pakiet i zainstaluj.
- Pobierz paczkę DLL IronPDF dla Twojej platformy: Windows, Linux, macOS
- Rozpakuj plik ZIP dla Twojego systemu operacyjnego do lokalizacji w Twoim katalogu rozwiązań.
- W Eksploratorze Rozwiązań Visual Studio kliknij prawym przyciskiem na 'Dependencies'.
- 'Dodaj odwołanie projektu' > Wybierz 'Przeglądaj', aby dołączyć wszystkie pliki DLL wyodrębnione z ZIP.
Zainstaluj IronPDF za pomoca NuGet.
4. Dodatkowe konfiguracje
Po zakupieniu lub zapisaniu się na 30-dniowy okres próbny IronPDF, znajdź klucz licencyjny wysłany na Twój email.
Dodaj klucz licencyjny na początku swojej aplikacji.
IronPdf.License.LicenseKey = "KEY";Imports IronPdf
IronPdf.License.LicenseKey = "KEY"Sprawdź status licencji.
bool valid = IronPdf.License.IsLicensed;Imports IronPdf
Dim valid As Boolean = License.IsLicensedUstaw właściwość TempFolderPath obiektu IronPdf.Installation.
IronPdf.Installation.TempFolderPath = @"C:\My\Safe\Path";IronPdf.Installation.TempFolderPath = "C:\My\Safe\Path"Ustawienie zmiennej środowiskowej folderu tymczasowego w zakresie aplikacji.
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
' 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 = System.IO.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[Remote IronPdfEngine] Po zainstalowaniu pakietu IronPdf.Slim, podłącz do kontenera silnika i skonfiguruj połączenie przy uruchomieniu aplikacji lub przed wywołaniem dowolnej metody IronPDF.
Zakładając, że IronPdfEngine działa zdalnie na 123.456.7.8:33350:
Installation.ConnectToIronPdfHost(
IronPdf.GrpcLayer.IronPdfConnectionConfiguration.RemoteServer("123.456.7.8:33350")
);Imports IronPdf
Installation.ConnectToIronPdfHost(
GrpcLayer.IronPdfConnectionConfiguration.RemoteServer("123.456.7.8:33350")
)[Linux] Włącz IronPDF do automatycznej instalacji wszystkich wymagań dla Linux. Pierwsza operacja HTML-to-PDF może potrwać dłużej niż zwykle.
Installation.LinuxAndDockerDependenciesAutoConfig = true;Installation.LinuxAndDockerDependenciesAutoConfig = True[Docker] Wstępnie zainicjuj silnik Chrome, aby załadować wymagania wstępne i przyspieszyć pierwsze użycie w Docker.
IronPdf.Installation.Initialize();IronPdf.Installation.Initialize()5. Scenariusze wdrożenia
Uruchom i wdrażaj IronPDF .NET na
Funkcja Azure
Uruchom i wdrażaj IronPDF .NET na
AWS Lambda
Uruchom IronPDF w
Kontenerze Linux Docker
Uruchom IronPDF jako
Zdalny kontenerKolejne kroki
Często Zadawane Pytania
Jak skonfigurować IronPdfEngine do zdalnego generowania plików PDF?
Aby skonfigurować IronPdfEngine do zdalnego generowania plików PDF, zainstaluj pakiet IronPdf.Slim z NuGet i skonfiguruj ustawienia połączenia za pomocą klasy IronPdfConnectionConfiguration. Ta konfiguracja pozwala na zdalne połączenie aplikacji z instancją IronPdfEngine.
Jakie są główne zalety korzystania z IronPdfEngine w mojej aplikacji?
Wykorzystanie IronPdfEngine w aplikacji pozwala na zdalne wykonywanie zadań związanych z plikami PDF, co pomaga uniknąć problemów z kompatybilnością na konkretnych platformach, zwłaszcza na starszych systemach i platformach mobilnych. Eliminuje to również potrzebę korzystania ze środowiska uruchomieniowego .NET podczas wykonywania zadań.
Dlaczego warto wybrać IronPdfEngine zamiast natywnej biblioteki PDF?
Możesz wybrać IronPdfEngine do zdalnego uruchamiania funkcji PDF wymagających dużej wydajności, co zmniejsza problemy z kompatybilnością z różnymi systemami operacyjnymi i poprawia wydajność dzięki wykorzystaniu renderera identycznego z Chrome do konwersji HTML na PDF.
Czy IronPdfEngine obsługuje skalowanie horyzontalne?
Nie, IronPdfEngine obecnie nie obsługuje skalowania poziomego, co oznacza, że nie można rozłożyć obciążenia na wiele instancji ze względu na sposób obsługi plików PDF w pamięci serwera.
Czy IronPdfEngine może działać na różnych systemach operacyjnych?
IronPdfEngine jest przeznaczony do działania w systemach Linux przy użyciu kontenerów Docker. Pliki binarne są jednak specyficzne dla danej platformy, dlatego należy upewnić się, że używana jest wersja odpowiednia dla danego systemu operacyjnego.
Co mam zrobić, jeśli moje pliki PDF wyglądają inaczej po użyciu IronPdfEngine?
Wyniki w formacie PDF mogą się nieznacznie różnić ze względu na różne zachowania systemów operacyjnych. Aby zminimalizować różnice, upewnij się, że używasz właściwego obrazu Docker i sprawdź, czy nie ma żadnych ustawień specyficznych dla systemu operacyjnego, które mogłyby wpłynąć na renderowanie.
Jak upewnić się, że moja aplikacja korzysta z właściwej wersji IronPdfEngine?
Aby zapewnić kompatybilność, każda wersja IronPDF wymaga odpowiedniej wersji IronPdfEngine. Należy pamiętać o jednoczesnej aktualizacji obu komponentów, aby uniknąć problemów związanych z różnicami między wersjami.
Jakie są ograniczenia związane z używaniem IronPdfEngine w systemie Windows?
Podczas korzystania z IronPdfEngine w systemie Windows potrzebne są kontenery Linux dla Docker i należy upewnić się, że port serwera jest dostępny. Pliki binarne są specyficzne dla platformy i wymagane jest przejście na kontenery Linux.
Jak skonfigurować IronPDF, aby połączyć się ze zdalnym serwerem IronPdfEngine?
Aby skonfigurować IronPDF dla serwera zdalnego, należy użyć metody Installation.ConnectToIronPdfHost z IronPdf.GrpcLayer.IronPdfConnectionConfiguration.RemoteServer, podając adres IP serwera i szczegóły dotyczące portu.
Jakiego pakietu powinienem użyć, aby zminimalizować rozmiar aplikacji podczas korzystania z IronPdfEngine?
Należy użyć pakietu IronPdf.Slim z NuGet, ponieważ zawiera on tylko komponenty niezbędne do uruchomienia IronPDF z IronPdfEngine, co zmniejsza rozmiar aplikacji.
Curtis Chau posiada tytuł licencjata z informatyki (Uniwersytet Carleton) i specjalizuje się w front-endowym rozwoju, z ekspertką w Node.js, TypeScript, JavaScript i React. Pasjonuje się tworzeniem intuicyjnych i estetycznie przyjemnych interfejsów użytkownika, Curtis cieszy się pracą z nowoczesnymi frameworkami i tworzeniem dobrze zorganizowanych, atrakcyjnych wizualnie podręczników.
