چگونه Aspose.OCR FOSS for .NET را از منبع بسازیم

Aspose.OCR FOSS برای .NET منبع باز است: می‌توانید مخزن را کلون کنید و در هر زمانی آن را خودتان بسازید، بدون وابستگی به زمان انتشار بسته کامپایل‌شده در رجیستری بسته‌ها. این راهنما مراحل کلون، ساخت، تست و ارجاع به کتابخانه از منبع را با استفاده از CLI .NET توضیح می‌دهد.

راهنمای گام به گام

مرحله ۱: کلون و ساخت

dotnet add package Aspose.OCR.FOSS

ساخت تمام پنج چارچوب هدف (netstandard2.0, net48, net8.0, net9.0, net10.0) به SDK .NET 10 نیاز دارد. برای ساخت یک هدف به‌جای همه، از -f استفاده کنید:

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

مرحله ۲: اجرای مجموعه تست

پروژه کامل تست xUnit را در مقابل ساختی که تازه تولید کرده‌اید اجرا کنید:

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

برای اجرا فقط بر یک چارچوب هدف:

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

مرحله ۳: ارجاع کتابخانه از پروژه خودتان

ساده‌ترین روش برای استفاده از یک ساخت منبع، ارجاع مستقیم پروژه از .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);

مرحله ۴: (اختیاری) ایجاد یک آرتیفکت بسته

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 در یکی از پنج چارچوب هدف با خطای missing-SDK ناموفق می‌شود. Building net9.0 and net10.0 targets به SDK .NET 10 نیاز دارد. یک هدف پشتیبانی‌شدهٔ منفرد ایجاد کنید با -f net8.0 (یا هدف نصب‌شدهٔ دیگری) اگر فقط یک SDK قدیمی‌تر دارید.

تست‌ها در یک چارچوب هدف مشخص ناموفق می‌شوند یا رد می‌شوند. پروژهٔ تست هدف‌گذاری می‌کند net48, net8.0, net9.0، و net10.0. اجرا کنید dotnet test tests/Aspose.Ocr.Foss.Tests.csproj -c Release -f net8.0 برای جداسازی یک هدف منفرد.

dotnet pack گزارش‌ها همان مورد انتظار را می‌دهند .nupkg ایجاد نشد. ابتدا اطمینان حاصل کنید که مراحل ساخت و تست تکمیل شده‌اند — dotnet pack with --no-build به یک ساخت قبلی موفق نیاز دارد.

سوالات متداول

آیا برای استفاده از این کتابخانه به یک بستهٔ منتشرشده نیاز دارم؟

خیر. ارجاع پروژه به src/Aspose.Ocr.Foss.csproj به همان شکلی که ارجاع به بستهٔ رجیستری عمل می‌کند، کار می‌کند و نیازی به انتظار برای هر مرحلهٔ انتشار ندارد.

کدام SDK .NET لازم است؟

SDK .NET 10 برای ساخت همه پنج چارچوب هدف (netstandard2.0/net48/net8.0/net9.0/net10.0) از یک فراخوانی dotnet build لازم است. 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 تولید می‌کند.