lucenenet

Selamat datang di Apache Lucene.NET

Pencarian teks lengkap yang kuat untuk .NET

Apache Lucene.NET adalah perpustakaan pencarian teks lengkap sumber terbuka yang ditulis dalam C#. Ini adalah port dari proyek Java Apache Lucene yang populer.

Apache Lucene.NET adalah perpustakaan .NET yang menyediakan fitur pengindeksan dan pencarian yang kuat, serta pemeriksaan ejaan, penyorotan hit, dan kemampuan analisis/tokenisasi tingkat lanjut.

Lucene.NET versi 4.8 (masih dalam Beta) berjalan di mana pun .NET dijalankan, termasuk Windows, Unix, MacOS, Android, dan iOS.

Situs web Apache Lucene.NET ada di: http://lucenenet.apache.org

Kerangka Kerja yang Didukung

Lucene.NET 3.0.3

• .NET Kerangka 4.0
• .NET Kerangka 3.5

Lucene.NET 4.8.0

• .NET 8.0
• .NET 6.0
• Standar .NET 2.1
• .NET Standar 2.0
• .NET Kerangka 4.6.2

Status

Versi Rilis Terbaru: Lucene.NET 3.0.3

Bekerja menuju Lucene.NET 4.8.0 (saat ini dalam BETA)

• Versi beta sangat stabil
• Memiliki lebih dari 7800+ unit tes yang lulus
• Terintegrasi dengan baik dengan .NET 8.0 dan .NET 6.0 (serta versi lain yang tidak didukung)
• Mendukung .NET Standar 2.1 dan .NET Standar 2.0
• Mendukung .NET Framework 4.6.2+
• Beberapa pengembang sudah menggunakannya di lingkungan produksi

Unduh

Lucene.NET 3.0.3

Perpustakaan Inti

 PM> Install-Package Lucene.Net

Semua Paket

• Lucene.Net - Perpustakaan inti
• Lucene.Net.Contrib - Berbagai fungsi dan tambahan yang dikontribusikan pengguna
• Lucene.Net.Contrib.Spatial - Pencarian Geospasial
• Lucene.Net.Contrib.Spatial.NTS - Pencarian geospasial dengan dukungan untuk NetTopologySuite.

Lucene.NET 4.8.0

Perpustakaan Inti

 PM> Install-Package Lucene.Net -Pre

Semua Paket

• Lucene.Net - Perpustakaan inti
• Lucene.Net.Analysis.Common - Penganalisis untuk mengindeks konten dalam berbagai bahasa dan domain
• Lucene.Net.Analysis.Kuromoji - Penganalisis Morfologi Jepang
• Lucene.Net.Analysis.Morfologik - Penganalisis untuk kamus yang berasal, kamus Polandia bawaan
• Lucene.Net.Analysis.OpenNLP - Integrasi Perpustakaan OpenNLP
• Lucene.Net.Analysis.Phonetic - Penganalisis untuk mengindeks tanda tangan fonetik (untuk pencarian yang mirip suara)
• Lucene.Net.Analysis.SmartCn - Penganalisis untuk mengindeks bahasa Mandarin
• Lucene.Net.Analysis.Stempel - Penganalisis untuk mengindeks bahasa Polandia
• Lucene.Net.Benchmark - Sistem untuk membandingkan Lucene
• Lucene.Net.Classification - Modul klasifikasi untuk Lucene
• Lucene.Net.Codecs - Codec Lucene dan format postingan
• Lucene.Net.Expressions - Nilai yang dihitung secara dinamis untuk mengurutkan/segi/pencarian berdasarkan tata bahasa yang dapat dicolokkan
• Lucene.Net.Facet - Kemampuan pengindeksan dan pencarian segi
• Lucene.Net.Grouping - Kolektor untuk mengelompokkan hasil pencarian
• Lucene.Net.Highlighter - Menyoroti kata kunci pencarian dalam hasil
• Lucene.Net.ICU - Penganalisis dan Penyorot ICU Khusus (Komponen Internasional untuk Unicode)
• Lucene.Net.Join - Penggabungan waktu indeks dan waktu Kueri untuk konten yang dinormalisasi
• Lucene.Net.Memory - Implementasi indeks dalam memori dokumen tunggal
• Lucene.Net.Misc - Alat indeks dan kode lain-lain
• Lucene.Net.Queries - Filter dan Kueri yang menambah inti Lucene
• Lucene.Net.QueryParser - Pengurai teks ke Kueri dan kerangka penguraian
• Utilitas replikasi File Lucene.Net.Replicator
• Lucene.Net.Sandbox - Berbagai kontribusi pihak ketiga dan ide-ide baru
• Lucene.Net.Spatial - Pencarian geospasial
• Lucene.Net.Suggest - Dukungan saran otomatis dan pemeriksaan ejaan
• Lucene.Net.TestFramework - Kerangka untuk menguji aplikasi berbasis Lucene

Dokumentasi

Kami memiliki dokumentasi awal untuk Lucene.NET 4.8.0 di Situs Web Lucene.NET.

API ini mirip dengan Java Lucene 4.8.0, yang mungkin berguna untuk Anda tinjau.

CATATAN: Kami sedang berupaya memperbaiki masalah pada dokumentasi, namun memerlukan bantuan lebih lanjut karena ini adalah proyek besar. Lihat #206.

Versi Lama

• Dokumentasi API Lucene.Net 3.0.3
• Dokumentasi API Lucene.Net 2.9.4

Demo & Alat

Ada beberapa demo yang diimplementasikan sebagai aplikasi konsol sederhana yang dapat disalin dan ditempelkan ke Visual Studio atau dikompilasi pada baris perintah di proyek Lucene.Net.Demo.

Ada juga alat baris perintah dotnet yang tersedia di NuGet. Ini berisi semua demo serta alat yang memelihara indeks Lucene.NET Anda, menampilkan operasi seperti pemisahan, penggabungan, daftar info segmen, perbaikan, penghapusan segmen, peningkatan, dll. Selalu pastikan untuk membuat cadangan indeks Anda sebelum menjalankan perintah apa pun menentangnya!

• Prasyarat: Runtime .NET 8.0 atau Lebih Tinggi

 dotnet tool install lucene-cli -g --version 4.8.0-beta00015

CATATAN: Versi CLI yang Anda instal harus sesuai dengan versi Lucene.NET yang Anda gunakan.

Setelah terinstal, Anda dapat menjelajahi perintah dan opsi yang tersedia dengan memasukkan perintah lucene .

Dokumentasi lucene-cli

Bagaimana Berkontribusi

Kami senang mendapatkan kontribusi! Baca Panduan Kontribusi kami atau baca terus untuk mengetahui cara-cara yang dapat Anda bantu.

Bergabunglah dengan Milis

Cara Bergabung dengan Milis

Ajukan Pertanyaan

Jika Anda memiliki pertanyaan umum bagaimana caranya atau memerlukan bantuan dari komunitas Lucene.NET, silakan berlangganan milis user dengan mengirimkan email ke [email protected] dan kemudian ikuti instruksi untuk memverifikasi alamat email Anda . Perhatikan bahwa Anda hanya perlu berlangganan satu kali.

Setelah Anda berlangganan milis, kirimkan pesan Anda melalui email ke [email protected].

Alternatifnya, Anda bisa mendapatkan bantuan melalui komunitas aktif StackOverflow.

Harap jangan mengirimkan pertanyaan umum tentang caranya ke GitHub, gunakan GitHub untuk laporan bug dan tugas saja.

Laporkan Bug

Untuk melaporkan bug, silakan gunakan pelacak masalah GitHub.

CATATAN: Di masa lalu, proyek Lucene.NET menggunakan pelacak masalah JIRA, yang kini sudah tidak digunakan lagi. Namun, kami tetap mengaktifkannya untuk melacak masalah lama. Silakan kirimkan masalah baru apa pun ke GitHub.

Mulai Diskusi

Untuk memulai diskusi pengembangan mengenai fitur teknis Lucene.NET, silakan kirim email ke milis dev dengan mengirimkan email ke [email protected] lalu ikuti petunjuk untuk memverifikasi alamat email Anda. Perhatikan bahwa Anda hanya perlu berlangganan satu kali.

Setelah Anda berlangganan milis, kirimkan pesan Anda melalui email ke [email protected].

Kirim Permintaan Tarik

Sebelum Anda mulai mengerjakan pull request, harap baca panduan Berkontribusi kami.

Membangun dan Menguji

Baris Perintah

Prasyarat

1. PowerShell 5.0 atau lebih tinggi (lihat pertanyaan ini untuk memeriksa versi PowerShell Anda)
2. .NET 8.0 SDK atau lebih tinggi

Eksekusi

CATATAN: Jika proyek dibuka di Visual Studio, pemulihan latar belakangnya mungkin mengganggu perintah ini. Disarankan untuk menutup semua instance Visual Studio yang membuka Lucene.Net.sln sebelum mengeksekusi.

Untuk membangun sumber, kloning atau unduh dan unzip repositori. Untuk rilis tertentu, unduh dan unzip file .src.zip dari halaman unduh versi tertentu. Dari repositori atau akar distribusi, jalankan perintah build dari command prompt dan sertakan opsi yang diinginkan dari tabel opsi build di bawah ini:

jendela

 > build [options]

Linux atau macOS

 ./build [options]

CATATAN: File build perlu diberi izin untuk dijalankan menggunakan perintah chmod u+x build sebelum eksekusi pertama.

Opsi Bangun

Opsi berikut tidak peka huruf besar-kecil. Tiap opsi memiliki bentuk pendek yang ditandai dengan satu - dan bentuk panjang yang ditandai dengan -- . Opsi yang memerlukan nilai harus diikuti dengan spasi dan kemudian nilai, mirip dengan menjalankan dotnet CLI.

Pendek	Panjang	Keterangan	Contoh
‑config	--konfigurasi	Konfigurasi build ("Rilis" atau "Debug").	membangun ‑‑konfigurasi Debug
‑mp	‑‑pekerjaan paralel maksimum	Jumlah maksimum pekerjaan paralel yang dijalankan selama pengujian. Jika tidak disertakan, defaultnya adalah 8.	membangun ‑t ‑mp 10
‑pv	‑‑versi paket	Versi paket NuGet. Jika tidak disediakan, akan menggunakan versi dari file Version.proj.	membangun ‑pv 4.8.0‑beta00001
-T	--tes	Menjalankan tes setelah membangun. Opsi ini tidak memerlukan nilai. Perhatikan bahwa pengujian biasanya memakan waktu sekitar 40 menit dengan 8 pekerjaan paralel.	membangun ‑t
‑fv	‑‑versi file	Versi file perakitan. Jika tidak disediakan, defaultnya adalah nilai --package-version (tidak termasuk label pra-rilis). Versi perakitan akan diturunkan dari komponen versi mayor dari nilai yang diteruskan, tidak termasuk komponen minor, build, dan revisi.	membangun ‑pv 4.8.0‑beta00001 ‑fv 4.8.0

Misalnya, perintah berikut membuat build Rilis dengan paket NuGet versi 4.8.0‑ci00015 dan file versi 4.8.0. Versi perakitan akan diturunkan dari komponen versi mayor dari nilai yang diteruskan, tidak termasuk komponen minor, build, dan revisi (dalam hal ini 4.0.0).

jendela

 > build ‑‑configuration Release ‑pv 4.8.0‑ci00015 ‑fv 4.8.0

Linux atau macOS

 ./build ‑‑configuration Release ‑pv 4.8.0‑ci00015 ‑fv 4.8.0

Dalam contoh di atas, kami menggunakan "ci" dalam versi paket untuk menunjukkan bahwa ini bukan versi beta yang dirilis secara publik, melainkan keluaran dari build integrasi berkelanjutan dari master yang terjadi setelah beta00014 tetapi sebelum beta00015 dirilis.

Paket NuGet dikeluarkan oleh build ke direktori /_artifacts/NuGetPackages/ . Hasil tes (jika ada) dikeluarkan ke direktori /_artifacts/TestResults/ .

Anda dapat mengatur Visual Studio untuk membaca paket NuGet seperti feed NuGet lainnya dengan mengikuti langkah-langkah berikut:

1. Di Visual Studio, klik kanan solusi di Solution Explorer, dan pilih "Kelola Paket NuGet untuk Solusi"
2. Klik ikon roda gigi di sebelah tarik-turun Sumber paket.
3. Klik ikon + (untuk menambahkan)
4. Beri nama sumbernya seperti Lucene.Net Local Packages
5. Klik tombol ... di sebelah kolom Sumber, dan pilih folder /src/_artifacts/NuGetPackages di sistem lokal Anda.
6. Klik Oke

Maka yang perlu Anda lakukan hanyalah memilih feed Lucene.Net Local Packages dari dropdown (di Manajer Paket NuGet) dan Anda dapat mencari, menginstal, dan memperbarui paket NuGet seperti yang Anda bisa lakukan dengan feed berbasis Internet.

Studio Visual

Prasyarat

1. Visual Studio 2022 atau lebih tinggi
2. .NET 8.0 SDK atau lebih tinggi

Eksekusi

1. Buka Lucene.Net.sln di Visual Studio.
2. Pilih kerangka kerja target yang akan diuji dengan membuka .build/TestTargetFramework.props dan menghapus komentar pada <TargetFramework> yang sesuai (dan memberi komentar pada yang lainnya).
3. Bangun proyek atau seluruh solusi, dan tunggu hingga Visual Studio menemukan pengujiannya - ini mungkin memerlukan waktu beberapa menit.
4. Jalankan atau debug pengujian di Test Explorer, secara opsional menggunakan filter yang diinginkan.

CATATAN: Saat menjalankan pengujian di Visual Studio, pastikan untuk mengatur arsitektur prosesor default ke 64 bit untuk menghindari kehabisan memori virtual pada beberapa pengujian.

Azure DevOps

Kami telah menyiapkan file azure-pipelines.yml dengan default logis sehingga siapa pun yang memiliki akun Azure DevOps dapat membuat Lucene.NET dan menjalankan pengujian dengan sedikit usaha. Bahkan akun Azure DevOps gratis pun bisa berfungsi, namun pengujian akan berjalan lebih cepat jika akun diatur sebagai publik, yang memungkinkan hingga 10 pekerjaan paralel dijalankan secara bersamaan.

Prasyarat

1. Akun Azure DevOps.
2. Cabang repositori ini di GitHub atau Azure DevOps. Petunjuk selanjutnya menggunakan fork GitHub.

Eksekusi

Jika Anda belum menyiapkan alur:

1. Buat organisasi Azure DevOps. Jika Anda sudah memilikinya yang ingin digunakan, Anda dapat melewati langkah ini.
2. Buat proyek Azure DevOps. Kami merekomendasikan untuk memberi nama proyek Lucene.NET. Perhatikan bahwa jika Anda menggunakan akun Azure DevOps gratis, Anda harus memilih untuk menjadikan proyek tersebut publik untuk mengaktifkan 10 pekerjaan paralel. Jika Anda menjadikan proyek tersebut pribadi, Anda hanya akan mendapatkan 1 pekerjaan paralel. Selain itu, jika menonaktifkan fitur, pastikan untuk membiarkan Pipelines diaktifkan.
3. Buat alur Azure DevOps.
   • Klik "Pipelines" dari menu sebelah kiri.
   • Klik tombol "Buat Saluran Pipa" atau "Saluran Baru", bergantung pada apakah saluran pipa sudah ada.
   • Pilih GitHub sebagai lokasi untuk menemukan file YAML.
   • Pilih cabang repositori yang Anda buat di "Prasyarat". Perhatikan bahwa jika ini adalah akun Azure DevOps baru, Anda mungkin perlu menyiapkan izin tambahan untuk mengakses akun GitHub Anda.
   • Selanjutnya halaman "Tinjau YAML Anda" ditampilkan yang memperlihatkan konten azure-pipelines.yml . Ada dokumentasi di dekat bagian atas file yang menunjukkan variabel yang dapat diatur untuk mengaktifkan opsi tambahan, namun perhatikan bahwa konfigurasi default akan secara otomatis menjalankan build dan semua pengujian.
   • Klik tombol "Jalankan" di kanan atas halaman.

Jika Anda sudah menyiapkan alur:

1. Klik "Pipelines" dari menu sebelah kiri.
2. Pilih alur yang ingin Anda jalankan.
3. Klik tombol "Antrian" di kanan atas.
4. (Opsional) Pilih cabang dan ganti variabel apa pun dalam alur untuk proses ini.
5. Klik tombol "Jalankan".

Perhatikan bahwa setelah pembangunan selesai, artefak nuget berisi file .nupkg yang dapat diunduh ke mesin lokal tempat Anda dapat menyiapkan folder lokal untuk bertindak sebagai umpan NuGet.

ID umpan Azure DevOps juga dapat ditambahkan ke variabel baru bernama ArtifactFeedID , tetapi kami mendapatkan hasil yang beragam karena masalah izin.