Cum să construiți Aspose.OCR FOSS for .NET din sursă

Aspose.OCR FOSS pentru .NET este open source: poți clona depozitul și să îl construiești singur în orice moment, independent de când pachetul compilat este publicat într-un registru de pachete. Acest ghid parcurge clonarea, construirea, testarea și referențierea bibliotecii din sursă folosind interfața în linie de comandă .NET.

Ghid pas cu pas

Pasul 1: Clonează și construiește

dotnet add package Aspose.OCR.FOSS

Construirea tuturor celor cinci cadre țintă (netstandard2.0, net48, net8.0, net9.0, net10.0) necesită SDK-ul .NET 10. Pentru a construi în schimb o singură țintă, folosește -f:

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

Pasul 2: Rulează suita de teste

Rulați proiectul complet de teste xUnit împotriva construcției pe care tocmai ați produs-o:

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

Pentru a rula doar pe un singur cadru țintă:

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

Pasul 3: Referențiați biblioteca din propriul dvs. proiect

Cea mai simplă modalitate de a utiliza o construcție din sursă este o referință de proiect directă din propriul .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);

Pasul 4: (Opțional) Creați un artefact de pachet

build-packages.bat rulează restaurarea, construcția, testarea și împachetarea într-un singur pas și scrie un .nupkg în artifacts\packages:

build-packages.bat --no-pause

Sau rulați direct pasul echivalent dotnet pack, după o construcție reușită:

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

Aceasta produce Aspose.OCR.FOSS.26.10.0.nupkg în artifacts/packages, un fișier de pachet autonom pe care îl puteți copia sau referenția direct din alte proiecte de pe aceeași mașină.

Probleme comune și remedii

dotnet build eșuează cu o eroare missing-SDK pe unul dintre cele cinci cadre țintă. Building net9.0 and net10.0 ținte necesită SDK-ul .NET 10. Construiți o singură țintă acceptată cu -f net8.0 (sau o altă țintă instalată) dacă aveți doar un SDK anterior.

Testele eșuează sau sunt omise pe un anumit cadru țintă. Proiectul de testare vizează net48, net8.0, net9.0, și net10.0. Rulați dotnet test tests/Aspose.Ocr.Foss.Tests.csproj -c Release -f net8.0 pentru a izola o singură țintă.

dotnet pack raportează așteptatul .nupkg nu a fost creat. Confirmă că pașii de construire și testare au fost finalizați mai întâi — dotnet pack with --no-build necesită o construcție anterioară de succes.

Întrebări frecvente

Trebuie să am un pachet publicat pentru a folosi această bibliotecă?

Nu. O referință de proiect la src/Aspose.Ocr.Foss.csproj funcționează în același mod ca o referință la un pachet din registru, fără a aștepta vreun pas de publicare.

Ce SDK .NET trebuie să folosesc?

SDK-ul .NET 10 este necesar pentru a construi toate cele cinci cadre țintă (netstandard2.0/net48/net8.0/net9.0/net10.0) dintr-un singur apel dotnet build. SDK-urile anterioare pot încă să construiască o singură țintă suportată cu -f.

Ce rulează de fapt build-packages.bat?

Patru pași în ordine: dotnet restore, dotnet build --configuration Release, dotnet test --configuration Release --no-build și dotnet pack --no-build produc Aspose.OCR.FOSS.26.10.0.nupkg în artifacts/packages.