跳到内容

apache/lucenenet公司

欢迎来到Apache Lucene。净值

Nuget公司 Azure DevOps生成(主) github

功能强大的全文搜索。净值

阿帕奇·卢森。NET是一个用C#编写的开源全文搜索库。它是流行的Java Apache Lucene项目的一个端口。

阿帕奇·卢森。NET是一个。NET库提供强大的索引和搜索功能,以及拼写检查、点击突出显示和高级分析/标记化功能。

卢塞纳。NET版本4.8(仍处于Beta版)到处都可以运行。NET运行,包括Windows、Unix、MacOS、Android和iOS。

阿帕奇Lucene。NET网站位于:http://lucenet.apache.org

支持的框架

卢塞纳。净3.0.3

  • .NET Framework 4.0
  • .NET Framework 3.5

卢塞纳。净值4.8.0

状态

最新版本:Lucene。净3.0.3

为Lucene工作。NET 4.8.0(目前为BETA版本)

  • 测试版非常稳定
  • 通过单元测试的人数超过7800人
  • 与很好地集成。NET 6.0。NET 5.0和。NET核心2+
  • 支架。NET标准2.1和。NET标准2.0
  • 支架。NET框架4.5+
  • 一些开发人员已经在生产环境中使用它

下载

卢塞纳。净3.0.3

核心库

NuGet版本

PM>安装软件包Lucene。净值
所有程序包

卢塞纳。净值4.8.0

核心库

NuGet版本

PM>安装软件包Lucene。净值-前期
所有程序包

文件

我们有Lucene的初步文档。净值4.8.0在Lucene上。NET网站.

该API类似于JavaLucene 4.8.0(卢森4.8.0),您可能会发现这也有助于复习。

注意:我们正在努力解决文档中的问题,但可能需要更多帮助,因为这是一个庞大的项目。请参见#206.

旧版本

演示和工具

有几个演示是作为简单的控制台应用程序实现的,可以复制并粘贴到Visual Studio中,也可以在中的命令行上进行编译卢塞纳。净值。演示项目.

NuGet上还有一个dotnet命令行工具。它包含了所有的演示以及维护Lucene的工具。NET索引,具有拆分、合并、列出段信息、修复、删除段、升级等操作。在对索引运行任何命令之前,请务必备份索引!

dotnet工具安装lucene-cli-g--版本4.8.0-beta00015

注意:您安装的CLI版本应与Lucene的版本匹配。NET。

安装后,您可以通过输入命令来浏览可用的命令和选项lucene公司.

lucene cli文档

如何贡献

我们喜欢收到捐款!阅读我们的贡献指南或者继续阅读你能提供帮助的方法。

加入邮件列表

如何加入邮件列表

提出问题

如果你有一个一般的操作问题或需要Lucene的帮助。NET社区,请订阅用户通过向发送电子邮件来发送邮件列表user-subscribe@lucenenet.apache.org然后按照说明验证您的电子邮件地址。请注意,您只需要订阅一次。

订阅邮件列表后,请将邮件发送至user@lucennet.apache.org.

或者,您可以通过以下方式获得帮助堆栈溢出的活跃社区。

请不要向GitHub提交一般的操作问题,仅将GitHup用于错误报告和任务。

报告Bug

要报告错误,请使用GitHub问题跟踪程序.

注:过去是Lucene。NET项目使用了JIRA问题跟踪器,现已弃用。然而,我们仍在积极跟踪遗留问题。请将任何新问题提交给GitHub。

开始讨论

开始关于Lucene技术特性的开发讨论。NET,请发送电子邮件至开发通过向发送电子邮件来发送邮件列表dev-subscribe@lucennet.apache.org然后按照说明验证您的电子邮件地址。请注意,您只需要订阅一次。

订阅邮件列表后,请将邮件发送至dev@lucennet.apache.org.

提交拉取请求

在开始处理拉取请求之前,请阅读我们的贡献指南。

建造和测试

命令行

前提条件
  1. PowerShell(PowerShell)5.0或更高版本(参见这个问题检查PowerShell版本)
  2. .NET 8.0 SDK或更高版本
执行

注:如果项目在VisualStudio中打开,其后台还原可能会干扰这些命令。建议关闭所有具有卢塞纳。净收入在执行之前打开。

要构建源代码,请克隆或下载并解压缩存储库。对于特定版本,请下载并解压缩.src.zip文件文件来自特定版本的下载页面。从存储库或分发根目录中,执行建造命令提示符中的命令,并包含以下构建选项表中所需的选项:

窗户
>构建[选项]
Linux或macOS
./build[选项]

注:这个建造需要授予文件权限才能使用命令运行chmod u+x版本在第一次执行之前。

生成选项

以下选项区分大小写。每个选项都有一个由单个-和表示为--。需要值的选项后面必须跟一个空格,然后是值,类似于运行dotnet CLI.

说明 例子
‑配置 ‑‑配置 构建配置(“发布”或“调试”)。 构建配置调试
‑mp(最大功率) -最大并行作业数 测试期间要运行的最大并行作业数。如果未提供,默认值为8。 构建‑t‑mp 10
‑光伏 ‑‑package版本 NuGet包版本。如果未提供,将使用version.proj文件中的版本。 构建‑pv 4.8.0‑beta00001
‑t ‑‑测试 生成后运行测试。此选项不需要值。请注意,8个并行作业的测试通常需要大约40分钟。 构建–t
‑fv公司 ‑‑文件版本 程序集文件版本。如果未提供,则默认为--package-version值(不包括任何预发布标签)。程序集版本将从传入值的主版本组件派生,不包括次要、内部版本和修订组件。 构建‑pv 4.8.0‑beta00001‑fv 4.8.0

例如,以下命令使用NuGet包版本4.8.0‑ci00015和文件版本4.8.0创建发布版本。程序集版本将从传入值的主版本组件派生,不包括次要、内部版本和修订组件(在本例中为4.0.0)。

窗户
>构建配置版本‑pv 4.8.0‑ci00015‑fv 4.8.0
Linux或macOS
./build‑‑configuration版本‑pv 4.8.0‑ci00015‑fv 4.8.0

在上面的示例中,我们在包版本中使用“ci”表示这不是公开发布的beta版本,而是在beta00014之后、beta00015发布之前从master生成的持续集成版本的输出。

NuGet包由构建输出到/_工件/NuGetPackages/目录。测试结果(如果适用)输出到/_工件/测试结果/目录。

您可以按照以下步骤设置Visual Studio以像读取任何NuGet提要一样读取NuGet包:

  1. 在Visual Studio中,右键单击解决方案资源管理器中的解决方案,然后选择“管理解决方案的NuGet包”
  2. 单击Package sources(包裹来源)下拉列表旁边的装备图标。
  3. 单击+图标(用于添加)
  4. 为源提供一个名称,例如卢塞纳。网络本地包
  5. 单击...按钮,然后选择/src/_artifacts/NuGetPackages本地系统上的文件夹。
  6. 单击“确定”

那么你需要做的就是选择卢塞纳。网络本地包从下拉菜单(在NuGet软件包管理器中)获取feed,您可以像使用任何基于Internet的feed一样搜索、安装和更新NuGet包。

Visual Studio

前提条件

  1. Visual Studio 2022或更高版本
  2. .NET 8.0 SDK或更高版本

执行

  1. 正常开放卢塞纳。净收入在Visual Studio中。
  2. 通过打开选择要测试的目标框架.build/TestTargetFramework.props并取消注释相应的<目标框架>(以及评论所有其他内容)。
  3. 生成项目或整个解决方案,然后等待Visual Studio发现测试—这可能需要几分钟的时间。
  4. 在测试资源管理器中运行或调试测试,可以选择使用所需的过滤器。

注:在Visual Studio中运行测试时,请确保将默认处理器体系结构设置为64位以避免在某些测试中耗尽虚拟内存。

Azure开发运营

我们已经设置好了蓝色管道.yml具有逻辑默认值的文件,这样任何拥有Azure DevOps帐户的人都可以构建Lucene。NET并以最小的工作量运行测试。即使是一个免费的Azure DevOps帐户也可以运行,但如果将帐户设置为公共帐户,测试将运行得更快,这样最多可以同时运行10个并行作业。

前提条件

  1. Azure开发运营账户。
  2. GitHub或Azure DevOps上此存储库的分支。这些指令的其余部分假设GitHub分支.

执行

如果尚未设置管道:
  1. 创建Azure DevOps组织。如果您已经有一个想要使用的,您可以跳过此步骤。
  2. 创建Azure DevOps项目。我们建议将项目命名为Lucene。净利润。请注意,如果你正在使用免费的Azure DevOps帐户,你应该选择将项目公开,以便启用10个并行作业。如果你把这个项目设为私有项目,你将只能得到一份平行的工作。此外,如果禁用功能,请确保启用“管道”。
  3. 创建Azure DevOps管道。
    • 单击左侧菜单中的“管道”。
    • 根据管道是否已经存在,单击“创建管道”或“新建管道”按钮。
    • 选择GitHub作为查找YAML文件的位置。
    • 选择您在“前提条件”中创建的此存储库的分支。请注意,如果这是一个新的Azure DevOps帐户,您可能需要设置额外权限以访问GitHub帐户.
    • 接下来会出现一个“查看您的YAML”页面,显示蓝色管道.yml。文件顶部附近有文档,说明可以设置哪些变量来启用其他选项,但请注意,默认配置将自动运行生成和所有测试。
    • 单击页面右上角的“Run”(运行)按钮。
如果已经设置了管道:
  1. 单击左侧菜单中的“管道”。
  2. 选择要运行的管道。
  3. 单击右上角的“队列”按钮。
  4. (可选)选择分支并覆盖此运行的管道中的任何变量。
  5. 单击“Run”(运行)按钮。

请注意,构建完成后努吉工件包含.nupkg(空包)可以下载到本地计算机上的文件设置本地文件夹作为NuGet源.

也可以将Azure DevOps提要id添加到名为工件馈送ID,但由于权限问题,我们的结果好坏参半。