Prerequisites
Before starting to work with Droids you need to install
- jdk >= 1.6
- maven >= 2.0.9
Download
First of all create a new directory and download the sources:
| Code Block |
|---|
mkdir droids cd droids svn co https://svn.apache.org/repos/asf/incubator/droids/trunk . |
Build
Create a distribution (all components of droids will be build) and install them to your local maven repository (usually ~/.m2/repository) with the following command.
| Code Block |
|---|
mvn clean install |
Eclipse integration
Before using the following command you should have deleted all old eclipse files (.classpath and .project) that you have in your project. Further make sure you have installed the maven eclipse plugin, For installation instructions, see the m2eclipse website.
| Code Block |
|---|
mvn eclipse:clean eclipse:eclipse |
Next go to eclipse, and make sure you haven't got trunk mounted as a project already.
Do File-Import->General->Maven projects, then point to your trunk directory and it should detect the newly created
components as projects.
Note that you need to declare the M2_REPO classpath variable in your workspace, it should point to your local m2 repository.
You can also get eclipse to download the sources of the dependent libraries and attach them to the jars in eclipse :
| Code Block |
|---|
mvn -Declipse.downloadSources=true eclipse:clean eclipse:eclipse |
For further information about the maven eclipse plugin visit http://maven.apache.org/plugins/maven-eclipse-plugin/
Eclipse projects
After you imported the projects you will find:
- droids-core - here we only have a minimum of dependencies to make it easy to integrate and extend droids.
- droids-norobots - this plugin provides the functionality to apply robots rules to droids.
- droids-solr - this plugin provides the functionality to use solr for indexing.
- droids-spring - this plugin provides spring support. Further it offers a dynamic extension of droids via the cocoon configurator.
- droids-tika - this plugin provides the functionality to use the Tika parsing facilities. Apache Tika is a toolkit for detecting and extracting metadata and structured text content from various documents using existing parser libraries.
- droids-wicket - this plugin provides the functionality to monitor different droids. It is implemented with Apache Wicket.
Using Droids as a NetBeans (version 6.7.1) Project
See Installation Guide for Netbeans 6.7.1 - Retrieving the source from svn and opening the Maven projects
Get started
Now that you are all setup you should go read getStarted to understand the best strategy to work with droids.