كيفية بناء Aspose.OCR FOSS for .NET من المصدر

Aspose.OCR FOSS لـ .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. أنشئ هدفًا مدعومًا واحدًا باستخدام -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.