Apache Lucene.NET هي مكتبة بحث عن النص الكامل مفتوحة المصدر مكتوبة بلغة C#. إنه منفذ لمشروع Java Apache Lucene الشهير.
Apache Lucene.NET هي مكتبة .NET توفر ميزات فهرسة وبحث قوية، بالإضافة إلى التدقيق الإملائي وتمييز النتائج وإمكانيات التحليل/الترميز المتقدمة.
يعمل الإصدار 4.8 من Lucene.NET (لا يزال في الإصدار التجريبي) في كل مكان يتم تشغيل .NET فيه، بما في ذلك Windows وUnix وMacOS وAndroid وiOS.
موقع Apache Lucene.NET موجود على: http://lucenenet.apache.org
أحدث إصدار: Lucene.NET 3.0.3
العمل على Lucene.NET 4.8.0 (حاليًا في الإصدار التجريبي)
PM> Install-Package Lucene.Net
PM> Install-Package Lucene.Net -Pre
لدينا وثائق أولية لـ Lucene.NET 4.8.0 على موقع الويب Lucene.NET.
تشبه واجهة برمجة التطبيقات Java Lucene 4.8.0، والتي قد تجد أيضًا أنه من المفيد مراجعتها.
ملاحظة: نحن نعمل على إصلاح المشكلات المتعلقة بالوثائق، ولكن يمكننا استخدام المزيد من المساعدة نظرًا لأنه مشروع ضخم. انظر رقم 206.
هناك العديد من العروض التوضيحية التي تم تنفيذها كتطبيقات وحدة تحكم بسيطة يمكن نسخها ولصقها في Visual Studio أو تجميعها على سطر الأوامر في مشروع Lucene.Net.Demo.
تتوفر أيضًا أداة سطر أوامر dotnet على NuGet. فهو يحتوي على جميع العروض التوضيحية بالإضافة إلى الأدوات التي تحافظ على فهرس Lucene.NET الخاص بك، والذي يتميز بعمليات مثل التقسيم والدمج وإدراج معلومات الشريحة والإصلاح وحذف المقاطع والترقية وما إلى ذلك. تأكد دائمًا من عمل نسخة احتياطية من الفهرس الخاص بك قبل تشغيل أي أوامر ضدها!
dotnet tool install lucene-cli -g --version 4.8.0-beta00015
ملاحظة: يجب أن يتطابق إصدار واجهة سطر الأوامر (CLI) التي تقوم بتثبيتها مع إصدار Lucene.NET الذي تستخدمه.
بمجرد التثبيت، يمكنك استكشاف الأوامر والخيارات المتاحة عن طريق إدخال الأمر lucene
.
وثائق lucene-cli
نحن نحب الحصول على المساهمات! اقرأ دليل المساهمة الخاص بنا أو تابع القراءة للتعرف على الطرق التي يمكنك من خلالها المساعدة.
كيفية الانضمام إلى القوائم البريدية
إذا كان لديك سؤال إرشادي عام أو كنت بحاجة إلى مساعدة من مجتمع Lucene.NET، فيرجى الاشتراك في القائمة البريدية user
عن طريق إرسال بريد إلكتروني إلى [email protected] ثم اتبع التعليمات للتحقق من عنوان بريدك الإلكتروني . لاحظ أنك تحتاج إلى الاشتراك مرة واحدة فقط.
بعد الاشتراك في القائمة البريدية، أرسل رسالتك بالبريد الإلكتروني إلى [email protected].
وبدلاً من ذلك، يمكنك الحصول على المساعدة عبر مجتمع StackOverflow النشط.
يرجى عدم إرسال أسئلة إرشادية عامة إلى GitHub، استخدم GitHub لتقارير الأخطاء والمهام فقط.
للإبلاغ عن خطأ ما، يرجى استخدام أداة تعقب المشكلات على GitHub.
ملاحظة: في الماضي، استخدم مشروع Lucene.NET أداة تعقب المشكلات JIRA، والتي تم إهمالها الآن. ومع ذلك، فإننا نبقيه نشطًا لتتبع المشكلات القديمة. يرجى تقديم أي مشاكل جديدة إلى GitHub.
لبدء مناقشة التطوير فيما يتعلق بالميزات التقنية لـ Lucene.NET، يرجى إرسال القائمة البريدية dev
عبر إرسال بريد إلكتروني إلى [email protected] ثم اتباع التعليمات للتحقق من عنوان بريدك الإلكتروني. لاحظ أنك تحتاج إلى الاشتراك مرة واحدة فقط.
بعد الاشتراك في القائمة البريدية، أرسل رسالتك بالبريد الإلكتروني إلى [email protected].
قبل البدء في العمل على طلب السحب، يرجى قراءة دليل المساهمة الخاص بنا.
ملاحظة: إذا كان المشروع مفتوحًا في Visual Studio، فقد تتداخل عملية استعادة الخلفية مع هذه الأوامر. يوصى بإغلاق كافة مثيلات Visual Studio التي تم فتح
Lucene.Net.sln
فيها قبل التنفيذ.
لإنشاء المصدر، قم باستنساخ المستودع أو تنزيله وفك ضغطه. بالنسبة لإصدارات محددة، قم بتنزيل وفك ضغط الملف .src.zip
من صفحة التنزيل الخاصة بالإصدار المحدد. من المستودع أو جذر التوزيع، قم بتنفيذ أمر الإنشاء من موجه الأوامر وقم بتضمين الخيارات المطلوبة من جدول خيارات الإنشاء أدناه:
> build [options]
./build [options]
ملاحظة: سيحتاج ملف
build
إلى الحصول على إذن للتشغيل باستخدام الأمرchmod u+x build
قبل التنفيذ الأول.
الخيارات التالية غير حساسة لحالة الأحرف. يحتوي كل خيار على نموذج قصير يُشار إليه برمز مفرد -
ونموذج طويل يُشار إليه بـ --
. الخيارات التي تتطلب قيمة يجب أن يتبعها مسافة ثم القيمة، على غرار تشغيل dotnet CLI.
قصير | طويل | وصف | مثال |
---|---|---|---|
-التكوين | --إعدادات | تكوين البناء ("الإصدار" أو "التصحيح"). | بناء - تصحيح التكوين |
-MP | - الحد الأقصى للوظائف الموازية | الحد الأقصى لعدد المهام المتوازية التي سيتم تشغيلها أثناء الاختبار. إذا لم يتم توفيره، فإن الإعداد الافتراضي هو 8. | بناء -t -mp 10 |
-بف | ---نسخة الحزمة | إصدار حزمة NuGet. إذا لم يتم توفيره، سيتم استخدام الإصدار من الملف Version.proj. | بناء -pv 4.8.0-beta00001 |
-ر | --امتحان | يجري الاختبارات بعد البناء. لا يتطلب هذا الخيار قيمة. لاحظ أن الاختبار يستغرق عادةً حوالي 40 دقيقة مع 8 مهام متوازية. | بناء -ر |
-fv | --نسخة الملف | إصدار ملف التجميع. إذا لم يتم توفيره، فستكون القيمة الافتراضية هي قيمة --package-version (باستثناء أي تسمية ما قبل الإصدار). سيتم اشتقاق إصدار التجميع من مكون الإصدار الرئيسي للقيمة التي تم تمريرها، باستثناء المكونات الثانوية ومكونات البناء والمراجعة. | بناء -pv 4.8.0-beta00001-fv 4.8.0 |
على سبيل المثال، يقوم الأمر التالي بإنشاء إصدار إصدار باستخدام إصدار حزمة NuGet 4.8.0‑ci00015 وإصدار الملف 4.8.0. سيتم اشتقاق إصدار التجميع من مكون الإصدار الرئيسي للقيمة التي تم تمريرها، باستثناء المكونات الثانوية ومكونات البناء والمراجعة (في هذه الحالة 4.0.0).
> build ‑‑configuration Release ‑pv 4.8.0‑ci00015 ‑fv 4.8.0
./build ‑‑configuration Release ‑pv 4.8.0‑ci00015 ‑fv 4.8.0
في المثال أعلاه، نستخدم "ci" في إصدار الحزمة للإشارة إلى أن هذا ليس إصدارًا تجريبيًا تم إصداره بشكل عام، بل هو ناتج بناء تكامل مستمر من الإصدار الرئيسي والذي حدث بعد beta00014 ولكن قبل إصدار beta00015.
يتم إخراج حزم NuGet من خلال الإصدار إلى الدليل /_artifacts/NuGetPackages/
. يتم إخراج نتائج الاختبار (إن أمكن) إلى الدليل /_artifacts/TestResults/
.
يمكنك إعداد Visual Studio لقراءة حزم NuGet مثل أي خلاصة NuGet باتباع الخطوات التالية:
+
(للإضافة)Lucene.Net Local Packages
...
بجوار حقل المصدر، واختر المجلد /src/_artifacts/NuGetPackages
على نظامك المحلي. بعد ذلك، كل ما عليك فعله هو اختيار خلاصة حزم Lucene.Net Local Packages
من القائمة المنسدلة (في NuGet Package Manager) ويمكنك البحث عن حزم NuGet وتثبيتها وتحديثها تمامًا كما يمكنك باستخدام أي خلاصة مستندة إلى الإنترنت.
Lucene.Net.sln
في Visual Studio..build/TestTargetFramework.props
وإلغاء التعليق على <TargetFramework>
المطابق (والتعليق على جميع الآخرين).ملاحظة: عند إجراء الاختبارات في Visual Studio، تأكد من ضبط بنية المعالج الافتراضية على 64 بت لتجنب نفاد الذاكرة الافتراضية في بعض الاختبارات.
لقد قمنا بإعداد ملف azure-pipelines.yml
الخاص بنا باستخدام الإعدادات الافتراضية المنطقية حتى يتمكن أي شخص لديه حساب Azure DevOps من إنشاء Lucene.NET وإجراء الاختبارات بأقل جهد. حتى حساب Azure DevOps المجاني سيعمل، ولكن سيتم تشغيل الاختبارات بشكل أسرع بكثير إذا تم إعداد الحساب كحساب عام، مما يتيح تشغيل ما يصل إلى 10 وظائف متوازية في وقت واحد.
azure-pipelines.yml
. توجد وثائق بالقرب من أعلى الملف تشير إلى المتغيرات التي يمكن إعدادها لتمكين الخيارات الإضافية، ولكن لاحظ أن التكوين الافتراضي سيعمل تلقائيًا على تشغيل البناء وجميع الاختبارات. لاحظ أنه بعد اكتمال الإنشاء، تحتوي قطعة nuget
على ملفات .nupkg
التي يمكن تنزيلها على جهازك المحلي حيث يمكنك إعداد مجلد محلي ليكون بمثابة موجز NuGet.
من الممكن أيضًا إضافة معرف موجز Azure DevOps إلى متغير جديد يسمى
ArtifactFeedID
، لكننا نحصل على نتائج مختلطة بسبب مشكلات الأذونات.