Merge branch 'android'

* android:
  Added Ant file to Android example to automatically download required jars.

Author: mfellner

examples/android/cukeulator-test/README.md

@@ -6,21 +6,20 @@ Features must be placed in `assets/features/`. Subdirectories are allowed.
 
 Read `libs/README.md` for details on dependencies.
 
-### Using ant
+### Using Ant
 1. Please read ["Building and Running from the Command Line"](https://developer.android.com/tools/building/building-cmdline.html).
-2. Make sure you have the required jars in `libs/` (read libs/README.md).
-3. Run `ant test`.
+2. Run `ant test`.
 
 ### Using an IDE
 1. Please read ["Building and Running from Eclipse with ADT"](https://developer.android.com/tools/building/building-eclipse.html).
 2. Create an Android test-project from these sources with `cucumber-example/` as the tested project.
 3. Create a run configuration with `cucumber.android.api.CucumberInstrumentation` as the instrumentation.
-4. Put the required jar dependencies into `libs/`.
+4. Make sure you have the required jar dependencies in `libs/`.
 
 ### Using Maven
 To build:
 
-````
+```
 mvn package -pl examples/android/cukeulator-test -am -P android,android-examples
 ```
 

examples/android/cukeulator-test/custom_rules.xml

@@ -11,7 +11,9 @@
             -post-build
             -pre-clean
     -->
+    <import file="./libs/init.xml"/>
+
     <target name="-pre-build">
-        <!-- TODO: see libs/README.md -->
+        <antcall target="libs.init"/>
     </target>
 </project>

examples/android/cukeulator-test/libs/README.md

@@ -1,15 +1,18 @@
 If you intend to build this project with Ant or with an IDE,
-you will need to place the required jars inside this directory.
+you will need to have the required jars inside this directory.
+
+If you're building this project with **Ant,** just run ../build.xml
+and the required jars will **automatically be downloaded.**
 
 ### Required jars for Cukeulator Test App
 * cucumber-core
 * cucumber-java
 * cucumber-android
 
-Run `./init.sh`
 
-**TODO:** Ant file for downloading jars from sonatype (when building with Ant, Maven should not be required).
+* To download the release versions run `ant -f init.xml`.
+* Or run `./init.sh` to build snaphsots with Maven.
 
-*Note: For each Android project, Ant and Eclipse will automatically include all .jars from the libs/ directory.*
+*Note for Eclipse users: The IDE should automatically include all .jars from the libs/ directory.*
 
 *Note for IDEA users: You need to manually include jars from /libs for your module.*

examples/android/cukeulator-test/libs/init.xml

@@ -0,0 +1,39 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project name="AndroidCucumberExampleTest" default="libs.init">
+    <property name="url.variant" value="releases"/>
+    <property name="url.base" value="https://oss.sonatype.org/content/repositories/${url.variant}/info/cukes"/>
+    <property name="name.cucumber" value="cucumber-jvm"/>
+    <property name="name.core" value="cucumber-core"/>
+    <property name="name.java" value="cucumber-java"/>
+    <property name="name.android" value="cucumber-android"/>
+    <property name="file.metadata" value="maven-metadata.xml"/>
+    <property name="file.dest" value="."/>
+    <property name="file.libs" value="libs"/>
+    <available file="${file.libs}" type="dir" property="file.libs.present"/>
+
+    <target name="libs.getmetadata">
+        <get src="${url.base}/${name.cucumber}/${file.metadata}" dest="./"/>
+    </target>
+
+    <target name="libs.getjar.libs" depends="libs.getmetadata" if="file.libs.present">
+        <xmlproperty file="${file.metadata}" collapseAttributes="true"/>
+        <get dest="${file.dest}/${file.libs}/">
+            <url url="${url.base}/${name.core}/${metadata.versioning.latest}/${name.core}-${metadata.versioning.latest}.jar"/>
+            <url url="${url.base}/${name.java}/${metadata.versioning.latest}/${name.java}-${metadata.versioning.latest}.jar"/>
+            <url url="${url.base}/${name.android}/${metadata.versioning.latest}/${name.android}-${metadata.versioning.latest}.jar"/>
+        </get>
+        <delete file="${file.metadata}"/>
+    </target>
+
+    <target name="libs.getjar.root" depends="libs.getmetadata" unless="file.libs.present">
+        <xmlproperty file="${file.metadata}" collapseAttributes="true"/>
+        <get dest="${file.dest}/">
+            <url url="${url.base}/${name.core}/${metadata.versioning.latest}/${name.core}-${metadata.versioning.latest}.jar"/>
+            <url url="${url.base}/${name.java}/${metadata.versioning.latest}/${name.java}-${metadata.versioning.latest}.jar"/>
+            <url url="${url.base}/${name.android}/${metadata.versioning.latest}/${name.android}-${metadata.versioning.latest}.jar"/>
+        </get>
+        <delete file="${file.metadata}"/>
+    </target>
+
+    <target name="libs.init" depends="libs.getjar.libs, libs.getjar.root"/>
+</project>