Building HttpComponents Client ============================ (1) Requisites -------------- JDK 1.5+ is required in order to compile and run HttpClient. HttpClient utilizes Maven as a distribution management and packaging tool. Version 3.0.3 or later is recommended. Maven 3.0.x, however it is known to be incompatible with the Clover plugin. Use Maven 2.2.1 to generate web site content with Clover coverage reports. Maven installation and configuration instructions can be found here: http://maven.apache.org/run-maven/index.html (2) Executing test cases Execute the following command in order to compile and test the components mvn test (3) Building packages Execute the following command in order to build the JAR packages and install them to the local repository: mvn install The JAR packages can be found in the target folders of their respective modules httpclient/target/httpclient-.jar httpmime/target/httpmime-.jar httpclient-cache/target/httpclient-cache-.jar fluent-hc/target/fluent-hc-.jar httpclient-osgi/target/org.apache.httpcomponents.httpclient_.jar where is the release version (4) Building documentation Execute the following command in order to generate javadoc: mvn javadoc:aggregate Execute the following command in order to generate the tutorial in html and pdf formats mvn docbkx:generate-pdf docbkx:generate-html (5) Building distribution assemblies Execute the following command in order to build the distribution assemblies mvn package assembly:assembly (6) Fix EOL in source files Fix the archive files so the source files have the correct EOL settings: mvn antrun:run (7) Building project web site Execute the following command in order to generate the project web site: mvn site -Dmaven.clover.licenseLocation=/clover.license where is a full path to Clover license file ASF committers can obtain a copy of Clover license donated to the ASF from the SVN repository at the following location: https://svn.apache.org/repos/private/committers/donated-licenses/clover