appserver.io build

Introduction

This library provides generic ANT build- and deployment targets useful to build libraries for appserver.io.

The targets are mostly used for enabling continous integration with Travis-CI. The following targets are provied out-of-the-box with a default configuration:

• clean (Deletes the directory with the generated artefacts)
• prepare (Prepares the directory to temporarily store generated artefacts)
• copy (Copies the sources to the temporary directory)
• deploy (Copies the sources to the deploy directory)
• phpdoc (Generates the API documentation using PHPDocumentor)
• pdepend (Runs the PHPDepend tool and generats a graphs)
• phpcpd (Runs the copy and paste detection)
• phpcs (Runs the code sniffer and generates a report)
• phploc (Generate phploc.csv)
• phpmd (Runs the PHP Mess detector tool)
• build (Builds the library)
• run-tests (Runs the PHPUnit tests on Travis-CI and generates a report)

All artefacts that'll be generated during the one of the targets runtime will be stored in a temporarily generated directory.

Installation

If you want to install the generic build- and deployment targets to use with your library, you do this by add

{
"require": {
"appserver-io/build": "dev-master"
},
}

to your composer.json and invoke composer update in your project.

Usage

After installation you can import the XML file delivered with the library into your local ANT build file with:

<?xml version="1.0"?>
<!DOCTYPEproject>
<projectname="composer/package"basedir=".">
<!-- initialize ENV variable -->
<propertyenvironment="env" />
<!-- initialize the library specific properties -->
<propertyname="codepool"value="vendor"/>
<!-- initialize the directory where we can find the real build files -->
<propertyname="vendor.dir" value ="${basedir}/${codepool}" />
<propertyname="build.dir"value="${vendor.dir}/appserver-io/build" />
<!-- ==================================================================== --><!-- Import the common build configuration file --><!-- ==================================================================== -->
<importfile="${build.dir}/common.xml"optional="true"/>
</project>