Apache Lucene.NET は、C# で書かれたオープンソースの全文検索ライブラリです。これは、人気のある Java Apache Lucene プロジェクトのポートです。
Apache Lucene.NET は、強力なインデックス作成機能と検索機能に加え、スペルチェック、ヒットの強調表示、高度な分析/トークン化機能を提供する .NET ライブラリです。
Lucene.NET バージョン 4.8 (まだベータ版) は、Windows、Unix、MacOS、Android、iOS など、.NET が動作するあらゆる場所で動作します。
Apache Lucene.NET Web サイトは次のとおりです: 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 Web サイトには、Lucene.NET 4.8.0 の予備ドキュメントがあります。
API は Java Lucene 4.8.0 に似ており、これも確認すると役立つでしょう。
注: 私たちはドキュメントの問題の修正に取り組んでいますが、大規模なプロジェクトであるため、さらに多くの助けが必要になる可能性があります。 #206を参照してください。
コピーして Visual Studio に貼り付けたり、Lucene.Net.Demo プロジェクトのコマンド ラインでコンパイルしたりできる、単純なコンソール アプリケーションとして実装されたデモがいくつかあります。
NuGet では、ドットネット コマンド ライン ツールも利用できます。これには、すべてのデモと、分割、マージ、セグメント情報のリスト表示、セグメントの修正、削除、アップグレードなどの操作を特徴とする Lucene.NET インデックスを維持するツールが含まれています。コマンドを実行する前に必ずインデックスをバックアップしてください。それには反対だ!
dotnet tool install lucene-cli -g --version 4.8.0-beta00015
注: インストールする CLI のバージョンは、使用する Lucene.NET のバージョンと一致する必要があります。
インストールしたら、コマンドlucene
を入力して、使用可能なコマンドとオプションを調べることができます。
lucene-cli ドキュメント
私たちは寄付を受け取るのが大好きです!私たちの貢献ガイドを読むか、あなたが支援できる方法を読んでください。
メーリングリストに参加する方法
一般的なハウツーに関する質問がある場合、または Lucene.NET コミュニティからのサポートが必要な場合は、[email protected] に電子メールを送信してuser
メーリング リストに登録し、指示に従って電子メール アドレスを確認してください。 。購読する必要があるのは 1 回だけであることに注意してください。
メーリング リストに登録したら、メッセージを [email protected] に電子メールで送信してください。
あるいは、StackOverflow のアクティブなコミュニティを通じてサポートを受けることもできます。
一般的なハウツーに関する質問を GitHub に送信しないでください。GitHub はバグ レポートとタスクにのみ使用してください。
バグを報告するには、GitHub 問題トラッカーを使用してください。
注:以前、Lucene.NET プロジェクトは JIRA 課題トラッカーを使用していましたが、現在は非推奨になっています。ただし、従来の問題を追跡するためにアクティブなままにしておきます。新しい問題があれば GitHub に送信してください。
Lucene.NET の技術機能に関する開発ディスカッションを開始するには、[email protected] に電子メールを送信してdev
メーリング リストに電子メールを送信し、指示に従って電子メール アドレスを確認してください。購読する必要があるのは 1 回だけであることに注意してください。
メーリング リストに登録したら、メッセージを [email protected] に電子メールで送信してください。
プル リクエストの作業を開始する前に、貢献ガイドをお読みください。
注:プロジェクトが Visual Studio で開かれている場合、そのバックグラウンド復元がこれらのコマンドに干渉する可能性があります。実行する前に、
Lucene.Net.sln
開いている Visual Studio のインスタンスをすべて閉じることをお勧めします。
ソースをビルドするには、リポジトリを複製するかダウンロードして解凍します。特定のリリースの場合は、特定のバージョンのダウンロード ページから.src.zip
ファイルをダウンロードして解凍します。リポジトリまたはディストリビューション ルートから、コマンド プロンプトからビルドコマンドを実行し、以下のビルド オプションの表から必要なオプションを含めます。
> build [options]
./build [options]
注:
build
ファイルには、最初の実行前にコマンドchmod u+x build
使用して実行権限を与える必要があります。
次のオプションでは大文字と小文字が区別されません。各オプションには、単一の-
で示される短い形式と--
で示される長い形式の両方があります。値を必要とするオプションの場合は、dotnet CLI の実行と同様に、スペース、値の順に続ける必要があります。
短い | 長さ | 説明 | 例 |
---|---|---|---|
‑設定 | - 構成 | ビルド構成 (「リリース」または「デバッグ」)。 | ビルド‑‑構成 デバッグ |
‑mp | ‑‑最大並列ジョブ数 | テスト中に実行する並列ジョブの最大数。指定しない場合、デフォルトは 8 です。 | ビルド-t-mp 10 |
‑pv | ‑‑パッケージバージョン | NuGet パッケージのバージョン。指定しない場合は、Version.proj ファイルのバージョンが使用されます。 | ビルド‑pv 4.8.0‑beta00001 |
‑t | - テスト | ビルド後にテストを実行します。このオプションには値は必要ありません。テストには通常、8 つの並列ジョブで約 40 分かかることに注意してください。 | ビルドする |
‑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/
ディレクトリに出力されます。
次の手順に従って、他の NuGet フィードと同様に NuGet パッケージを読み取るように Visual Studio をセットアップできます。
+
アイコンをクリックします (追加用)Lucene.Net Local Packages
などの名前を付けます。...
ボタンをクリックし、ローカル システムの/src/_artifacts/NuGetPackages
フォルダーを選択します。次に、(NuGet パッケージ マネージャーの) ドロップダウンからLucene.Net Local Packages
フィードを選択するだけで、インターネット ベースのフィードと同様に、NuGet パッケージを検索、インストール、更新できます。
Lucene.Net.sln
を開きます。.build/TestTargetFramework.props
を開き、対応する<TargetFramework>
のコメントを解除します (その他すべてをコメント化します)。テストするターゲット フレームワークを選択します。注: Visual Studio でテストを実行するときは、一部のテストで仮想メモリが不足しないように、デフォルトのプロセッサ アーキテクチャを必ず 64 ビットに設定してください。
Azure DevOps アカウントを持つ誰もが最小限の労力で Lucene.NET を構築し、テストを実行できるように、 azure-pipelines.yml
ファイルを論理的なデフォルトで設定しました。無料の Azure DevOps アカウントでも機能しますが、アカウントがパブリックとして設定されている場合、テストははるかに高速に実行され、最大 10 個の並列ジョブを同時に実行できます。
azure-pipelines.yml
の内容が表示されます。ファイルの先頭近くに、追加オプションを有効にするために設定できる変数を示すドキュメントがありますが、デフォルト構成ではビルドとすべてのテストが自動的に実行されることに注意してください。ビルドが完了すると、 nuget
アーティファクトに.nupkg
ファイルが含まれることに注意してください。このファイルはローカル マシンにダウンロードされ、そこで NuGet フィードとして機能するローカル フォルダーをセットアップできます。
Azure DevOps フィード ID を
ArtifactFeedID
という名前の新しい変数に追加することもできますが、アクセス許可の問題によりさまざまな結果が得られます。