ZIP Package Installation

Patagames Pdf.Net SDK comes with an automated NuGet package distribution which is the preferred method of installation. There is also a ZIP package for manual installation of the library for environments without package manager access or custom build pipelines.

Pdfium.NET SDK provides a number of components to work with PDF files:

• Patagames.Pdf.dll contains the class library used to load, manipulate and render PDF documents;
• Patagames.Pdf.WinForms.dll contains a WinForms controls that can render a PdfDocument (Follow the steps on this page to add PdfViewer control into Toolbox);
• Patagames.Pdf.Wpf.dll contains a Wpf controls that can render a PdfDocument;
• Patagames.Pdf.WinUI.dll contains UWP/WinUI controls that can display PdfDocument;
• Patagames.Pdf.Gdi.dll contains GDI-dependent classes;
• ptgpdfcore.dll native engine for windows (x86 and x64);
• libptgpdfcore.dylib native engine for macOS (Universal Binary supporting Intel x86_64 and Apple Silicon arm64);
• libptgpdfcore.so native engine for standard Linux (GLIBC) and Alpine Linux (MUSL) environments;
• PtgPdfCore.xcframework native multi-architecture Apple framework for iOS deployment.

1. Download the ZIP package, unpack it and copy the required managed assemblies and matching native runtimes into your project directory:

   									netXX\ (or netstandard2.0\)
   									Patagames.Pdf.dll
   									Patagames.Pdf.xml
   									Patagames.Pdf.WinForms.dll
   									Patagames.Pdf.WinForms.xml
   									Patagames.Pdf.Wpf.dll
   									Patagames.Pdf.Wpf.xml
   									Patagames.Pdf.Gdi.dll
   									Patagames.Pdf.Gdi.xml
   									runtimes\
   									win-x64\native\ptgpdfcore.dll
   									win-x86\native\ptgpdfcore.dll
   									osx\native\libptgpdfcore.dylib
   									linux-x64\native\libptgpdfcore.so
   									linux-musl-x64\native\libptgpdfcore.so
   									android\native\ (arm64-v8a, armeabi-v7a, x86_64, x86 .so files)
   									ios\native\PtgPdfCore.xcframework
   								

   Tip
   For UWP/WinUI applications copy the following files instead: uapXX\ Patagames.Pdf.dll Patagames.Pdf.xml Patagames.Pdf.WinUI.dll Patagames.Pdf.WinUI.xml runtimes\ win-x64\native\ptgpdfcore.dll win-x86\native\ptgpdfcore.dll

2. To use the library, you must first add a reference to Patagames.Pdf.dll and/or target UI assemblies like Patagames.Pdf.WinForms.dll or Patagames.Pdf.Wpf.dll into your project. Optionally, you can add Patagames.Pdf.Gdi.dll if your project relies on GDI+ extensions.

   

3. After adding references, you must include the specific native binary assets required for your deployment targets:

   • win-x86\native\ptgpdfcore.dll for 32-bit Windows systems;

   • win-x64\native\ptgpdfcore.dll for 64-bit Windows systems;

   • osx\native\libptgpdfcore.dylib for macOS deployments (Intel and Apple Silicon);

   • linux-x64\native\libptgpdfcore.so for target standard GLIBC Linux servers.

   

   Note
   To ensure cross-platform runtime resolution, it is recommended to keep the standard .NET runtime directory tree structure (runtimes/{platform}/native/). The SDK engine will automatically look up the native library within these relative paths at runtime.

4. When building your project, the native binaries must be copied next to your application output binaries. For desktop and console setups, select the added native files, navigate to properties, and change the Copy to Output Directory setting to Copy if newer or Copy always.

   

5. That's all. Your project is ready to use Pdfium.Net SDK v5

   Tip
   You can find VIDEO instructions on how to configure your project here.