Jak zbudować Aspose.OCR FOSS for .NET ze źródeł

Aspose.OCR FOSS for .NET jest otwartym oprogramowaniem: możesz sklonować repozytorium i zbudować je samodzielnie w dowolnym momencie, niezależnie od tego, kiedy skompilowany pakiet zostanie opublikowany w rejestrze pakietów. Ten przewodnik przeprowadza przez klonowanie, budowanie, testowanie i odwoływanie się do biblioteki ze źródeł przy użyciu .NET CLI.

Przewodnik krok po kroku

Krok 1: Klonuj i buduj

dotnet add package Aspose.OCR.FOSS

Budowanie wszystkich pięciu docelowych frameworków (netstandard2.0, net48, net8.0, net9.0, net10.0) wymaga .NET 10 SDK. Aby zamiast tego zbudować pojedynczy cel, użyj -f:

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

Krok 2: Uruchom zestaw testów

Uruchom pełny projekt testów xUnit przeciwko właśnie utworzonej kompilacji:

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

Aby uruchomić tylko dla jednego docelowego frameworka:

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

Krok 3: Odwołaj się do biblioteki z własnego projektu

Najprostszym sposobem użycia kompilacji źródłowej jest bezpośrednie odwołanie projektu z własnego .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);

Krok 4: (Opcjonalnie) Utwórz artefakt pakietu

build-packages.bat wykonuje przywracanie, kompilację, testy i pakowanie w jednym kroku i zapisuje .nupkg do artifacts\packages:

build-packages.bat --no-pause

Lub uruchom równoważny krok dotnet pack bezpośrednio, po pomyślnym zbudowaniu:

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

To generuje Aspose.OCR.FOSS.26.10.0.nupkg w artifacts/packages, samodzielny plik pakietu, który możesz skopiować lub odwołać się do niego bezpośrednio z innych projektów na tym samym komputerze.

Typowe problemy i rozwiązania

dotnet build zawodzi z błędem brakującego SDK na jednym z pięciu docelowych frameworków. Building net9.0 and net10.0 targets wymaga SDK .NET 10. Zbuduj pojedynczy obsługiwany cel przy użyciu -f net8.0 (lub innego zainstalowanego celu), jeśli masz tylko wcześniejsze SDK.

Testy zawodzą lub są pomijane w danym frameworku docelowym. Projekt testowy ma cele net48, net8.0, net9.0, i net10.0. Uruchom dotnet test tests/Aspose.Ocr.Foss.Tests.csproj -c Release -f net8.0 aby wyodrębnić pojedynczy cel.

dotnet pack raportuje oczekiwane .nupkg nie został utworzony. Potwierdź, że kroki budowania i testowania zostały najpierw zakończone — dotnet pack with --no-build wymaga udanego wcześniejszego builda.

Najczęściej zadawane pytania

Czy potrzebuję opublikowanego pakietu, aby używać tej biblioteki?

Nie. Odwołanie do projektu src/Aspose.Ocr.Foss.csproj działa tak samo, jak odwołanie do pakietu w rejestrze, bez konieczności czekania na jakikolwiek krok publikacji.

Który .NET SDK jest potrzebny?

Do budowania wszystkich pięciu frameworków docelowych (netstandard2.0/net48/net8.0/net9.0/net10.0) z jednego wywołania dotnet build wymagana jest .NET 10 SDK. Starsze SDK mogą nadal budować pojedynczy obsługiwany cel przy użyciu -f.

Co tak naprawdę uruchamia build-packages.bat?

Cztery kroki w kolejności: dotnet restore, dotnet build --configuration Release, dotnet test --configuration Release --no-build i dotnet pack --no-build generujące Aspose.OCR.FOSS.26.10.0.nupkg w artifacts/packages.