Linux .NET Core PDF library integration

This guide will help you run Apryse samples and integrate a free trial of the Apryse SDK into .NET Core applications on Linux. Your free trial includes unlimited trial usage and support from solution engineers.

• .NET Core SDK
  • Note: Apryse SDK is multi-targeting. Target Frameworks : .NET Core 3.1+, .NET Standard 2.1, .NET 5.
• Apryse SDK for Linux:

1. Download the Apryse SDK.
2. Extract via tar xvzf PDFNetC64.tar.gz or tar xvzf PDFNetCArm64.tar.gz or tar xvzf PDFNetC.tar.gz.
3. Get your Apryse trial key.

Run a specific sample

1. Navigate to the CS folder in the sample you want to run(e.g. /Samples/AddImageTest/CS and execute

dotnet run

Run all samples

1. Navigate to /Samples and make a new file named runall_dotnetcore.sh. Open up the file and paste the shell script from here into it.

2. Next give yourself execute permissions by

chmod a+x runall_dotnetcore.sh

then run the script using:

./runall_dotnetcore.sh

The tests will run one by one.

This section will show you how to use our SDK to create a simple Apryse "Hello World!" application. It will create a document with one blank page and save it as a linearized PDF in its running directory.

1. Create a new project called myApp from the terminal:

dotnet new console -o myApp

This guide will assume your project is named myApp.

Next, you can edit Program.cs.

4. Open Program.cs in your favorite text editor and add the necessary headers:

   using pdftron.Common;
   using pdftron.PDF;
   using pdftron.SDF;

5. Initialize PDFNet in your main function:

   static void Main(string[] args)
   {
       Console.WriteLine("Hello World!");
       pdftron.PDFNet.Initialize();
   }

6. Instantiate a new document with one blank page:

   using(PDFDoc doc = new PDFDoc()){
     Page page = doc.PageCreate();  // Start a new page
     doc.PagePushBack(page);  // Add page to document
   }

   Then save the document as a linearized PDF named output.pdf:

   doc.Save("output.pdf", SDFDoc.SaveOptions.e_linearized);  // Save document as a linearized PDF

   Your final program should look like this:

   using System;
   using pdftron.Common;
   using pdftron.PDF;
   using pdftron.SDF;
   
   namespace myApp
   {
       class Program
       {
         static void Main(string[] args)
         {
             Console.WriteLine("Hello World!");
             pdftron.PDFNet.Initialize(); // PDFNet must be initialized before accessing any Apryse API
   
             using(PDFDoc doc = new PDFDoc()){
   
               Page page = doc.PageCreate();	// Start a new page
               doc.PagePushBack(page);       // Add page to document
               doc.Save("output.pdf", SDFDoc.SaveOptions.e_linearized); // Save document as a linearized PDF
   
             }
         }
       }
   }

7. Now run the application by executing dotnet run. If all goes well, your console should output:

   PDFNet is running in demo mode.
   Permission: write
   Hello World!

Check the output.pdf that the program output in the same directory. It should be a PDF with one blank page.

Guides API docsSamples