Como Compilar Aspose.OCR FOSS for .NET a partir do Código-Fonte

Aspose.OCR FOSS for .NET é open source: você pode clonar o repositório e compilá-lo você mesmo a qualquer momento, independentemente de quando o pacote compilado for publicado em um registro de pacotes. Este guia percorre o processo de clonagem, compilação, teste e referência da biblioteca a partir do código fonte usando a CLI .NET.

Guia Passo a Passo

Passo 1: Clonar e Compilar

dotnet add package Aspose.OCR.FOSS

Compilar todos os cinco frameworks de destino (netstandard2.0, net48, net8.0, net9.0, net10.0) requer o SDK .NET 10. Para compilar apenas um único destino, use -f:

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

Passo 2: Executar a Suíte de Testes

Execute o projeto de testes completo do xUnit contra a compilação que você acabou de produzir:

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

Para executar apenas em um framework de destino:

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

Etapa 3: Referencie a Biblioteca a partir do Seu Próprio Projeto

A maneira mais simples de usar uma compilação a partir do código-fonte é uma referência direta de projeto a partir do seu próprio .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);

Etapa 4: (Opcional) Crie um Artefato de Pacote

build-packages.bat executa restore, build, test e pack em uma única etapa e grava um .nupkg em artifacts\packages:

build-packages.bat --no-pause

Ou execute a etapa equivalente dotnet pack diretamente, após uma compilação bem-sucedida:

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

Isso produz Aspose.OCR.FOSS.26.10.0.nupkg em artifacts/packages, um arquivo de pacote autocontido que você pode copiar ou referenciar diretamente de outros projetos na mesma máquina.

Problemas Comuns e Correções

dotnet build falha com um erro de SDK ausente em um dos cinco frameworks de destino. Building net9.0 and net10.0 targets requer o SDK .NET 10. Construa um único alvo suportado com -f net8.0 (ou outro alvo instalado) se você tem apenas um SDK anterior.

Os testes falham ou são ignorados em um determinado framework de destino. O projeto de teste tem como alvo net48, net8.0, net9.0, e net10.0. Execute dotnet test tests/Aspose.Ocr.Foss.Tests.csproj -c Release -f net8.0 para isolar um único alvo.

dotnet pack relata o esperado .nupkg não foi criado. Confirme se as etapas de compilação e teste foram concluídas primeiro — dotnet pack with --no-build requer uma compilação anterior bem-sucedida.

Perguntas Frequentes

Preciso de um pacote publicado para usar esta biblioteca?

Não. Uma referência de projeto a src/Aspose.Ocr.Foss.csproj funciona da mesma forma que uma referência de pacote do registro, sem precisar aguardar nenhuma etapa de publicação.

Qual SDK .NET eu preciso?

O SDK .NET 10 é necessário para compilar todos os cinco frameworks de destino (netstandard2.0/net48/net8.0/net9.0/net10.0) a partir de uma única chamada dotnet build. SDKs anteriores ainda podem compilar um único destino suportado com -f.

O que o build-packages.bat realmente executa?

Quatro etapas em ordem: dotnet restore, dotnet build --configuration Release, dotnet test --configuration Release --no-build e dotnet pack --no-build produzindo Aspose.OCR.FOSS.26.10.0.nupkg em artifacts/packages.