Wie man Aspose.OCR FOSS for .NET aus dem Quellcode baut

Aspose.OCR FOSS für .NET ist Open Source: Sie können das Repository klonen und es jederzeit selbst bauen, unabhängig davon, wann das kompilierte Paket in ein Paket-Registry veröffentlicht wird. Diese Anleitung führt Sie durch das Klonen, Bauen, Testen und Referenzieren der Bibliothek aus dem Quellcode mithilfe der .NET CLI.

Schritt-für-Schritt-Anleitung

Schritt 1: Klonen und Bauen

dotnet add package Aspose.OCR.FOSS

Das Bauen aller fünf Ziel-Frameworks (netstandard2.0, net48, net8.0, net9.0, net10.0) erfordert das .NET 10 SDK. Um stattdessen ein einzelnes Ziel zu bauen, verwenden Sie -f:

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

Schritt 2: Die Testsuite ausführen

Führen Sie das vollständige xUnit-Testprojekt gegen den Build aus, den Sie gerade erstellt haben:

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

Um nur gegen ein Ziel-Framework auszuführen:

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

Schritt 3: Verweisen Sie die Bibliothek aus Ihrem eigenen Projekt

Der einfachste Weg, ein Quell-Build zu verwenden, ist ein direkter Projektverweis aus Ihrem eigenen .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);

Schritt 4: (Optional) Erstellen Sie ein Paket-Artefakt

build-packages.bat führt Wiederherstellung, Build, Test und Packen in einem Schritt aus und schreibt ein .nupkg nach artifacts\packages:

build-packages.bat --no-pause

Oder führen Sie den entsprechenden dotnet pack-Schritt direkt nach einem erfolgreichen Build aus:

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

Dadurch wird Aspose.OCR.FOSS.26.10.0.nupkg in artifacts/packages erzeugt, eine eigenständige Paketdatei, die Sie direkt von anderen Projekten auf demselben Rechner kopieren oder referenzieren können.

Häufige Probleme und Lösungen

dotnet build schlägt mit einem fehlenden SDK-Fehler bei einem der fünf Ziel-Frameworks fehl. Building net9.0 and net10.0 targets benötigt das .NET 10 SDK. Erstellen Sie ein einzelnes unterstütztes Ziel mit -f net8.0 (oder ein anderes installiertes Ziel), wenn Sie nur ein älteres SDK haben.

Tests schlagen fehl oder werden bei einem bestimmten Ziel-Framework übersprungen. Das Testprojekt zielt auf net48, net8.0, net9.0, und net10.0. Ausführen dotnet test tests/Aspose.Ocr.Foss.Tests.csproj -c Release -f net8.0 um ein einzelnes Ziel zu isolieren.

dotnet pack meldet das Erwartete .nupkg wurde nicht erstellt. Bestätigen Sie, dass die Build- und Testschritte zuerst abgeschlossen wurden — dotnet pack with --no-build erfordert einen erfolgreichen vorherigen Build.

Häufig gestellte Fragen

Benötige ich ein veröffentlichtes Paket, um diese Bibliothek zu verwenden?

Nein. Ein Projektverweis auf src/Aspose.Ocr.Foss.csproj funktioniert genauso wie ein Registrierungs-Paketverweis, ohne auf einen Veröffentlichungsschritt warten zu müssen.

Welches .NET SDK benötige ich?

Das .NET 10 SDK ist erforderlich, um alle fünf Ziel-Frameworks (netstandard2.0/net48/net8.0/net9.0/net10.0) mit einem einzigen dotnet build-Aufruf zu erstellen. Ältere SDKs können immer noch ein einzelnes unterstütztes Ziel mit -f erstellen.

Was führt build-packages.bat tatsächlich aus?

Vier Schritte in der Reihenfolge: dotnet restore, dotnet build --configuration Release, dotnet test --configuration Release --no-build und dotnet pack --no-build, die Aspose.OCR.FOSS.26.10.0.nupkg in artifacts/packages erzeugen.