2017-06-27 18:04:15 -04:00
<!--
Licensed to the Apache Software Foundation (ASF) under one or more
contributor license agreements. See the NOTICE file distributed with
this work for additional information regarding copyright ownership.
The ASF licenses this file to You under the Apache License, Version 2.0
the "License"); you may not use this file except in compliance with
the License. You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
-->
2021-03-10 05:33:47 -05:00
# Apache Lucene
2017-06-27 18:04:15 -04:00
2021-03-10 15:28:52 -05:00
![Lucene Logo ](https://lucene.apache.org/theme/images/lucene/lucene_logo_green_300.png?v=0e493d7a )
2021-10-17 19:24:11 -04:00
Apache Lucene is a high-performance, full-featured text search engine library
2017-06-27 18:04:15 -04:00
written in Java.
2021-03-10 17:52:29 -05:00
[![Build Status ](https://ci-builds.apache.org/job/Lucene/job/Lucene-Artifacts-main/badge/icon?subject=Lucene )](https://ci-builds.apache.org/job/Lucene/job/Lucene-Artifacts-main/)
2019-06-29 08:01:54 -04:00
2017-06-27 18:04:15 -04:00
## Online Documentation
This README file only contains basic setup instructions. For more
comprehensive documentation, visit:
2021-09-19 20:24:13 -04:00
- Latest Releases: < https: // lucene . apache . org / core / documentation . html >
- Nightly: < https: // ci-builds . apache . org / job / Lucene / job / Lucene-Artifacts-main / javadoc />
- Build System Documentation: [help/ ](./help/ )
2021-10-17 19:24:11 -04:00
- Developer Documentation: [dev-docs/ ](./dev-docs/ )
2021-11-29 17:04:15 -05:00
- Migration Guide: [lucene/MIGRATE.md ](./lucene/MIGRATE.md )
2017-06-27 18:04:15 -04:00
2022-03-29 03:52:27 -04:00
## Building
2017-06-27 18:04:15 -04:00
2021-03-10 10:10:06 -05:00
### Basic steps:
2022-04-20 11:07:24 -04:00
1. Install OpenJDK 17 (exactly this version).
2022-03-29 03:52:27 -04:00
2. Clone Lucene's git repository (or download the source distribution).
3. Run gradle launcher script (`gradlew`).
2017-06-27 18:04:15 -04:00
2022-03-29 03:52:27 -04:00
We'll assume that you know how to get and set up the JDK - if you don't, then we suggest starting at https://jdk.java.net/ and learning more about Java, before returning to this README.
2020-09-07 06:08:38 -04:00
2022-03-29 03:52:27 -04:00
See [Contributing Guide ](./CONTRIBUTING.md ) for details.
2017-06-27 18:04:15 -04:00
## Contributing
2021-09-24 15:06:06 -04:00
Bug fixes, improvements and new features are always welcome!
2021-03-10 10:10:06 -05:00
Please review the [Contributing to Lucene
2022-03-29 03:52:27 -04:00
Guide](./CONTRIBUTING.md) for information on
2017-06-27 18:04:15 -04:00
contributing.
## Discussion and Support
2021-03-10 10:10:06 -05:00
- [Users Mailing List ](https://lucene.apache.org/core/discussion.html#java-user-list-java-userluceneapacheorg )
- [Developers Mailing List ](https://lucene.apache.org/core/discussion.html#developer-lists )
- [Issue Tracker ](https://issues.apache.org/jira/browse/LUCENE )
- IRC: `#lucene` and `#lucene-dev` on freenode.net