如何从源码构建 Aspose.OCR FOSS for .NET

Aspose.OCR FOSS for .NET 是开源的：您可以随时克隆仓库并自行构建，而不受已发布到软件包注册表的编译包发布时间的限制。本指南将演示如何克隆、构建、测试，以及使用 .NET CLI 从源码引用该库。

分步指南

步骤 1：克隆并构建

dotnet add package Aspose.OCR.FOSS

构建所有五个目标框架（netstandard2.0、net48、net8.0、net9.0、net10.0）需要 .NET 10 SDK。若只构建单个目标，请使用 -f：

dotnet build src/Aspose.Ocr.Foss.csproj -c Release -f net8.0

步骤 2：运行测试套件

在您刚刚生成的构建上运行完整的 xUnit 测试项目：

dotnet test Aspose.Ocr.Foss.sln -c Release --no-build

仅针对单个目标框架运行：

dotnet test tests/Aspose.Ocr.Foss.Tests.csproj -c Release -f net8.0

步骤 3：在您自己的项目中引用该库

使用源码构建的最简单方法是从您自己的 .csproj 进行直接项目引用：

<ItemGroup>
  <ProjectReference Include="..\Aspose.OCR-FOSS-for-.NET\src\Aspose.Ocr.Foss.csproj" />
</ItemGroup>

using Aspose.OCR;

var api = new AsposeOcr();
using var input = new OcrInput(InputType.SingleImage);
input.Add("scan.png");
Console.WriteLine(api.Recognize(input)[0].RecognitionText);

步骤 4：（可选）创建包构件

build-packages.bat 在一步中执行还原、构建、测试和打包，并将 .nupkg 写入 artifacts\packages：

build-packages.bat --no-pause

或者在成功构建后直接运行等效的 dotnet pack 步骤：

dotnet pack src/Aspose.Ocr.Foss.csproj -c Release --no-build -o artifacts/packages

这将在 artifacts/packages 中生成 Aspose.OCR.FOSS.26.10.0.nupkg，这是一个自包含的包文件，您可以直接从同一机器上的其他项目复制或引用它。

常见问题与解决方案

dotnet build 在五个目标框架中的一个上因缺少 SDK 错误而失败。 Building net9.0 and net10.0 targets 需要 .NET 10 SDK。使用以下方式构建单个受支持的目标 -f net8.0 （或其他已安装的目标），如果您只有较早的 SDK。

在给定的目标框架上，测试失败或被跳过。 测试项目的目标是 net48, net8.0, net9.0，并且 net10.0。运行 dotnet test tests/Aspose.Ocr.Foss.Tests.csproj -c Release -f net8.0 以隔离单个目标。

dotnet pack 报告预期 .nupkg 未创建。 请先确认构建和测试步骤已完成 — dotnet pack with --no-build 需要先前成功的构建。

常见问题

我需要发布的包才能使用此库吗？

不需要。对 src/Aspose.Ocr.Foss.csproj 的项目引用的工作方式与注册表包引用相同，无需等待任何发布步骤。

我需要哪个 .NET SDK？

需要使用 .NET 10 SDK 才能从单个 dotnet build 调用构建所有五个目标框架（netstandard2.0/net48/net8.0/net9.0/net10.0）。早期的 SDK 仍然可以使用 -f 构建单个受支持的目标。

build-packages.bat 实际运行了什么？

按顺序的四个步骤：dotnet restore、dotnet build --configuration Release、dotnet test --configuration Release --no-build 和 dotnet pack --no-build，在 artifacts/packages 中生成 Aspose.OCR.FOSS.26.10.0.nupkg。