Skip to content

macOS 集成 .NET Core 库

环境要求

  • .NET Core SDK

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

  • 适用于 macOS 的 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,您需要输入以下命令:

shell
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"
  2. 将 ComPDFKitNative.dylib 文件和 ComPDFKit.NET.dll 文件复制到项目文件夹中。

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

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

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

    xml
    <Project Sdk="Microsoft.NET.Sdk">
    
        <PropertyGroup>
            <OutputType>Exe</OutputType>
            <TargetFramework>net6.0</TargetFramework>
            <RootNamespace>ComPDFKit_Demo</RootNamespace>
            <ImplicitUsing>enable</ImplicitUsing>
            <Nullable>enable</Nullable>
        </PropertyGroup>
    
    	<ItemGroup>
        	<Reference Include="ComPDFKit.NET.dll">
         	   <HintPath>ComPDFKit.NET.dll</HintPath>
        	</Reference>
    	</ItemGroup>
    
    	<ItemGroup>
     	   <Content Include="ComPDFKitNative.dylib">
     	       <CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory>
    	    </Content>
    	</ItemGroup>
    
    </Project>

使用 Nuget 包集成

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

    shell
    mkdir ComPDFKitDemo
    cd ComPDFKitDemo
    dotnet new console -o "ComPDFKit Demo"
  2. 进入项目文件夹,安装 ComPDFKit.Core NuGet 包:

    bash
    dotnet add package ComPDFKit.NetCore

创建 PDF 文档

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

csharp
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");
        }
    }
}

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

shell
dotnet run

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