Hoe Aspose.OCR FOSS for .NET te bouwen vanaf de bron

Aspose.OCR FOSS voor .NET is open source: je kunt de repository klonen en zelf bouwen op elk moment, onafhankelijk van wanneer het gecompileerde pakket wordt gepubliceerd in een package registry. Deze gids loopt door het klonen, bouwen, testen en refereren naar de bibliotheek vanuit de bron met behulp van de .NET CLI.

Stapsgewijze handleiding

Stap 1: Klonen en bouwen

dotnet add package Aspose.OCR.FOSS

Het bouwen van alle vijf doel-frameworks (netstandard2.0, net48, net8.0, net9.0, net10.0) vereist de .NET 10 SDK. Om in plaats daarvan één enkel doel te bouwen, gebruik -f:

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

Stap 2: Testsuite uitvoeren

Voer het volledige xUnit-testproject uit tegen de build die je zojuist hebt geproduceerd:

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

Om alleen tegen één doelframework uit te voeren:

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

Stap 3: Verwijs naar de bibliotheek vanuit je eigen project

De eenvoudigste manier om een source build te gebruiken is een directe projectreferentie vanuit je eigen .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);

Stap 4: (Optioneel) Maak een pakket-artefact

build-packages.bat voert restore, build, test en pack uit in één stap en schrijft een .nupkg naar artifacts\packages:

build-packages.bat --no-pause

Of voer de equivalente dotnet pack-stap direct uit, na een succesvolle build:

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

Dit produceert Aspose.OCR.FOSS.26.10.0.nupkg in artifacts/packages, een zelfstandig pakketbestand dat je direct kunt kopiëren of refereren vanuit andere projecten op dezelfde machine.

Veelvoorkomende problemen en oplossingen

dotnet build faalt met een missing-SDK-fout op een van de vijf doel-frameworks. Building net9.0 and net10.0 targets vereist de .NET 10 SDK. Bouw een enkele ondersteunde target met -f net8.0 (of een andere geïnstalleerde target) als je alleen een eerdere SDK hebt.

Tests falen of worden overgeslagen op een bepaald target-framework. Het testproject targett net48, net8.0, net9.0, en net10.0. Voer dotnet test tests/Aspose.Ocr.Foss.Tests.csproj -c Release -f net8.0 uit om een enkele target te isoleren.

dotnet pack rapporteert het verwachte .nupkg is niet aangemaakt. Bevestig dat de build- en teststappen eerst voltooid zijn — dotnet pack with --no-build vereist een succesvolle eerdere build.

Veelgestelde vragen

Heb ik een gepubliceerd pakket nodig om deze bibliotheek te gebruiken?

Nee. Een projectreferentie naar src/Aspose.Ocr.Foss.csproj werkt op dezelfde manier als een referentie naar een registratiespakket, zonder te wachten op een publicatiestap.

Welke .NET SDK heb ik nodig?

De .NET 10 SDK is vereist om alle vijf doel-frameworks (netstandard2.0/net48/net8.0/net9.0/net10.0) vanuit één dotnet build-aanroep te bouwen. Eerdere SDK’s kunnen nog steeds één ondersteund doel bouwen met -f.

Wat voert build-packages.bat eigenlijk uit?

Vier stappen in volgorde: dotnet restore, dotnet build --configuration Release, dotnet test --configuration Release --no-build en dotnet pack --no-build die Aspose.OCR.FOSS.26.10.0.nupkg produceren in artifacts/packages.