Linux 集成 .NET Core 库 ​

环境要求 ​

• .NET Core SDK

  注意：ComPDFKit PDF SDK 是多目标的，支持的目标框架包括： .NET Core 2.1+, .NET Standard 2.0, .NET 5, .NET 6, .NET 7, .NET 8。

• 适用于 Linux 的 ComPDFKit PDF SDK for .NET Core 库

  请联系我们以获取 ComPDFKit PDF SDK for .NET Core。

• ComPDFKit PDF SDK 许可证

  在生产环境中使用需要商业许可证密钥。如果您没有有效的许可证密钥，请联系我们以获取许可证密钥。

  许可证密钥是唯一生成的，小心保管您的许可证密钥以避免在错误的环境中公开（例如在您的公共 GitHub 中）。

运行示例 ​

进入样本文件夹内并从命令行运行示例：

• 输入 ./run.sh all 运行所有示例。
• 输入 ./run.sh <sample_name> 运行特定示例。例如，./run.sh BatesTest。

如果您收到错误消息 bash: ./test.sh: Permission denied，您需要输入以下命令：

chmod+x run .sh

将 ComPDFKit 集成到项目中 ​

可以按照下面所述的手动或 nuget 集成进行操作。本节将帮助您构建您的第一个 ComPDFKit 应用程序。如果您能够打开、保存和关闭 PDF文档，则可以轻松集成 ComPDFKit PDF SDK 的其余部分。

手动集成 ​

1. 通过控制台创建一个名为 ComPDFKit Demo 的新项目：

   shell

   mkdir ComPDFKitDemo
   cd ComPDFKitDemo
   dotnet new console -o "ComPDFKit Demo"

   1
   2
   3
   

2. 将 ComPDFKitNative.so 文件和 ComPDFKit.NET.dll 文件复制到项目文件夹中。

3. 将以下代码添加到 .csproj 文件中：

   xml

   <ItemGroup>
    <Reference Include="ComPDFKit.NET.Core">
      <HintPath>ComPDFKit.NET.dll</HintPath>
    </Reference>
   </ItemGroup>
   
   <ItemGroup>
       <Content Include="ComPDFKitNative.so">
           <CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory>
       </Content>
   </ItemGroup>

   1
   2
   3
   4
   5
   6
   7
   8
   9
   10
   11
   

   您最终的 ComPDFKit Demo.csproj 文件应该如下所示：

   xml

   <Project Sdk="Microsoft.NET.Sdk">
   
       <PropertyGroup>
           <OutputType>Exe</OutputType>
           <TargetFramework>net6.0</TargetFramework>
       </PropertyGroup>
   
       <ItemGroup>
           <Reference Include="ComPDFKit.NET.Core">
               <HintPath>ComPDFKit.NET.dll</HintPath>
           </Reference>
       </ItemGroup>
   
       <ItemGroup>
           <Content Include="ComPDFKitNative.so">
               <CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory>
           </Content>
       </ItemGroup>
   
   </Project>

   1
   2
   3
   4
   5
   6
   7
   8
   9
   10
   11
   12
   13
   14
   15
   16
   17
   18
   19
   20
   

使用 Nuget 包集成 ​

1. 通过控制台创建一个名为 ComPDFKit Demo 的新项目：

   shell

   mkdir ComPDFKitDemo
   cd ComPDFKitDemo
   dotnet new console -o "ComPDFKit Demo"

   1
   2
   3
   

2. 进入项目文件夹，安装 ComPDFKit.Core NuGet 包：

   bash

   dotnet add package ComPDFKit.NetCore

   1
   

创建 PDF 文档 ​

我们已经完成了所有准备步骤。现在让我们使用 ComPDFKit PDF SDK 创建一个带有一个空白页的 PDF 文件，用下面这段代码替换您的 Program.cs 文件，注意：需要将您的 license 替换到 LicenseVerify() 方法中。

using ComPDFKit.NativeMethod;
using ComPDFKit.PDFDocument;
using System.Reflection.Metadata;

namespace ComPDFKit_Demo
{
    public class Program
    {
        private static bool LicenseVerify()
        {
            if (!CPDFSDKVerifier.LoadNativeLibrary())
                return false;
            LicenseErrorCode verifyResult = CPDFSDKVerifier.LicenseVerify("Input your license here");
            return (verifyResult == LicenseErrorCode.E_LICENSE_SUCCESS);
        }
        
        public static void Main()
        { 
            LicenseVerify();
            CPDFDocument document = CPDFDocument.CreateDocument();
             // 插入到第一页。
			int pageIndex = 0;
			int pageWidth = 595;
			int pageHeight = 842;
			// InsertPage方法可以指定一个图片路径，当图片路径为空时即插入空白页面。
			document.InsertPage(pageIndex, pageWidth, pageHeight, "");
			document.WriteToFilePath("new_file.pdf");// 将文档对象全量保存到当前路径
            Console.WriteLine("Done. Results saved in new_file.pdf");
        }
    }
}

现在您可以从命令行运行程序：

dotnet run

现在您会在程序输出目录下找到 new_file.pdf 文件，它是一个带有一个空白页的 PDF 文件。