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:

mkdir droids
cd droids
svn co https://svn.apache.org/repos/asf/incubator/droids/trunk .
cd 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.

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.

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 :

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.