Як зібрати Aspose.OCR FOSS for .NET з вихідного коду

Aspose.OCR FOSS for .NET є відкритим вихідним кодом: ви можете клонувати репозиторій і збирати його самостійно в будь-який час, незалежно від того, коли скомпільований пакет буде опублікований у реєстрі пакетів. Цей посібник крок за кроком розповідає про клонування, збірку, тестування та посилання на бібліотеку з вихідного коду за допомогою .NET CLI.

Покроковий посібник

Крок 1: Клонування та збірка

dotnet add package Aspose.OCR.FOSS

Збірка всіх п’яти цільових фреймворків (netstandard2.0, net48, net8.0, net9.0, net10.0) вимагає .NET 10 SDK. Щоб зібрати лише один цільовий фреймворк, використайте -f:

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

Крок 2: Запуск тестового набору

Запустіть повний проект тестів xUnit проти збірки, яку ви щойно створили:

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

Щоб запустити лише для одного цільового фреймворку:

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

Крок 3: Додайте посилання на бібліотеку у ваш власний проєкт

Найпростіший спосіб використати збірку з вихідного коду – це пряме посилання на проєкт у вашому власному .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);

Крок 4: (Необов’язково) Створити артефакт пакету

build-packages.bat виконує відновлення, збірку, тестування та упаковку в один крок і записує .nupkg у artifacts\packages:

build-packages.bat --no-pause

Або запустіть еквівалентний крок dotnet pack безпосередньо після успішної збірки:

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

Це створює Aspose.OCR.FOSS.26.10.0.nupkg у artifacts/packages, самодостатній файл пакету, який ви можете копіювати або посилатися на нього безпосередньо з інших проєктів на тому ж комп’ютері.

Типові проблеми та рішення

dotnet build завершується помилкою відсутнього SDK на одному з п’яти цільових фреймворків. Building net9.0 and net10.0 targets вимагає .NET 10 SDK. Створіть один підтримуваний target за допомогою -f net8.0 (або інший встановлений target), якщо у вас є лише ранніший SDK.

Тести завершуються з помилкою або пропускаються на певному цільовому фреймворку. Тестовий проєкт орієнтується на net48, net8.0, net9.0, і net10.0. Запустіть dotnet test tests/Aspose.Ocr.Foss.Tests.csproj -c Release -f net8.0 для ізоляції одного target.

dotnet pack повідомляє очікуване .nupkg не було створено. Переконайтеся, що кроки збірки та тестування завершені спочатку — dotnet pack with --no-build вимагає успішної попередньої збірки.

Поширені запитання

Чи потрібен опублікований пакет для використання цієї бібліотеки?

Ні. Посилання на проєкт src/Aspose.Ocr.Foss.csproj працює так само, як посилання на пакет у реєстрі, без очікування на крок публікації.

Який .NET SDK мені потрібен?

Для побудови всіх п’яти цільових фреймворків (netstandard2.0/net48/net8.0/net9.0/net10.0) з одного виклику dotnet build потрібен .NET 10 SDK. Раніші SDK все ще можуть збирати один підтримуваний цільовий фреймворк за допомогою -f.

Що насправді виконує build-packages.bat?

Чотири кроки послідовно: dotnet restore, dotnet build --configuration Release, dotnet test --configuration Release --no-build та dotnet pack --no-build, які створюють Aspose.OCR.FOSS.26.10.0.nupkg у artifacts/packages.