Hur man bygger Aspose.OCR FOSS for .NET från källkod

Aspose.OCR FOSS för .NET är öppen källkod: du kan klona arkivet och bygga det själv när som helst, oberoende av när det kompilerade paketet publiceras i ett paketregister. Den här guiden går igenom kloning, byggning, testning och referering av biblioteket från källkod med .NET CLI.

Steg-för-steg-guide

Steg 1: Klona och bygg

dotnet add package Aspose.OCR.FOSS

Att bygga alla fem målramverk (netstandard2.0, net48, net8.0, net9.0, net10.0) kräver .NET 10 SDK. För att bygga ett enskilt mål istället, använd -f:

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

Steg 2: Kör testsviten

Kör hela xUnit-testprojektet mot den bygg du just producerat:

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

För att bara köra mot ett målramverk:

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

Steg 3: Referera biblioteket från ditt eget projekt

Det enklaste sättet att använda en källkodbyggnad är en direkt projektreferens från ditt eget .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);

Steg 4: (Valfritt) Skapa ett paketartefakt

build-packages.bat kör restore, build, test och pack i ett steg och skriver en .nupkg till artifacts\packages:

build-packages.bat --no-pause

Eller kör motsvarande dotnet pack-steg direkt, efter en lyckad bygg:

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

Detta producerar Aspose.OCR.FOSS.26.10.0.nupkg i artifacts/packages, en fristående paketfil som du kan kopiera eller referera direkt från andra projekt på samma maskin.

Vanliga problem och lösningar

dotnet build misslyckas med ett saknat-SDK-fel på ett av de fem målramverken. Building net9.0 and net10.0 targets kräver .NET 10 SDK. Bygg ett enda stödjande mål med -f net8.0 (eller ett annat installerat mål) om du bara har en tidigare SDK.

Tester misslyckas eller hoppas över på ett givet målramverk. Testprojektet riktar sig mot net48, net8.0, net9.0, och net10.0. Kör dotnet test tests/Aspose.Ocr.Foss.Tests.csproj -c Release -f net8.0 för att isolera ett enskilt mål.

dotnet pack rapporterar det förväntade .nupkg skapades inte. Bekräfta att bygg- och teststegen har slutförts först — dotnet pack with --no-build kräver en lyckad föregående bygg.

Vanliga frågor

Behöver jag ett publicerat paket för att använda detta bibliotek?

Nej. En projektreferens till src/Aspose.Ocr.Foss.csproj fungerar på samma sätt som en registerpaketreferens skulle, utan att vänta på något publiceringssteg.

Vilken .NET SDK behöver jag?

Den .NET 10 SDK:n krävs för att bygga alla fem målramverk (netstandard2.0/net48/net8.0/net9.0/net10.0) från ett enda dotnet build-anrop. Tidigare SDK:er kan fortfarande bygga ett enda stödjande mål med -f.

Vad kör build-packages.bat egentligen?

Fyra steg i ordning: dotnet restore, dotnet build --configuration Release, dotnet test --configuration Release --no-build och dotnet pack --no-build som producerar Aspose.OCR.FOSS.26.10.0.nupkg i artifacts/packages.