Come compilare Aspose.OCR FOSS for .NET dal codice sorgente

Aspose.OCR FOSS per .NET è open source: puoi clonare il repository e compilarlo da solo in qualsiasi momento, indipendentemente da quando il pacchetto compilato viene pubblicato in un registro di pacchetti. Questa guida illustra il clonare, compilare, testare e fare riferimento alla libreria dal sorgente usando il CLI .NET.

Guida passo-passo

Passo 1: Clona e compila

dotnet add package Aspose.OCR.FOSS

Compilare tutti e cinque i framework di destinazione (netstandard2.0, net48, net8.0, net9.0, net10.0) richiede il SDK .NET 10. Per compilare un solo target invece, usa -f:

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

Passo 2: Esegui la suite di test

Esegui l’intero progetto di test xUnit contro la build che hai appena prodotto:

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

Per eseguire solo su un framework di destinazione:

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

Passo 3: Riferisci la libreria dal tuo progetto

Il modo più semplice per utilizzare una build di origine è un riferimento di progetto diretto dal tuo .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);

Passo 4: (Opzionale) Crea un artefatto del pacchetto

build-packages.bat esegue restore, build, test e pack in un unico passo e scrive un .nupkg su artifacts\packages:

build-packages.bat --no-pause

Oppure esegui direttamente il passo dotnet pack equivalente, dopo una build riuscita:

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

Questo produce Aspose.OCR.FOSS.26.10.0.nupkg in artifacts/packages, un file di pacchetto autonomo che puoi copiare o riferire direttamente da altri progetti sulla stessa macchina.

Problemi comuni e soluzioni

dotnet build fallisce con un errore di SDK mancante su uno dei cinque framework di destinazione. Building net9.0 and net10.0 targets richiede l’SDK .NET 10. Compila un singolo target supportato con -f net8.0 (o un altro target installato) se hai solo un SDK precedente.

I test falliscono o vengono saltati su un determinato framework di destinazione. Il progetto di test ha come target net48, net8.0, net9.0, e net10.0. Esegui dotnet test tests/Aspose.Ocr.Foss.Tests.csproj -c Release -f net8.0 per isolare un singolo target.

dotnet pack riporta il previsto .nupkg non è stato creato. Conferma che i passaggi di build e test siano completati prima — dotnet pack with --no-build richiede una build precedente riuscita.

Domande frequenti

Devo avere un pacchetto pubblicato per usare questa libreria?

No. Un riferimento di progetto a src/Aspose.Ocr.Foss.csproj funziona allo stesso modo di un riferimento a un pacchetto del registro, senza attendere alcuna fase di pubblicazione.

Quale SDK .NET mi serve?

È necessario l’SDK .NET 10 per compilare tutti e cinque i framework di destinazione (netstandard2.0/net48/net8.0/net9.0/net10.0) da una singola chiamata dotnet build. Le versioni precedenti dell’SDK possono comunque compilare un singolo target supportato con -f.

Cosa esegue effettivamente build-packages.bat?

Quattro passaggi in ordine: dotnet restore, dotnet build --configuration Release, dotnet test --configuration Release --no-build e dotnet pack --no-build producendo Aspose.OCR.FOSS.26.10.0.nupkg in artifacts/packages.