gump-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
Subject svn commit: r1658763 - in /gump/live/src/documentation/content/xdocs: index.xml metadata/builder.xml metadata/project.xml
Date Tue, 10 Feb 2015 17:18:49 GMT
Author: bodewig
Date: Tue Feb 10 17:18:49 2015
New Revision: 1658763

document gradle builder


Modified: gump/live/src/documentation/content/xdocs/index.xml
--- gump/live/src/documentation/content/xdocs/index.xml (original)
+++ gump/live/src/documentation/content/xdocs/index.xml Tue Feb 10 17:18:49 2015
@@ -107,7 +107,9 @@ Gump project maintains its own dedicated
       So far Gump's support for Maven 2.x and later uses the most complex
       approach, for the full story see <link
       href="metadata/builder.html#mvn2">the section on the mvn2
-      builder</link>.
+      builder</link>.  Support for Gradle hooks into the approach
+      taken for Maven and uses the same local repositories and
+      repository proxy.
@@ -154,8 +156,8 @@ Gump project maintains its own dedicated
         <td><fork href="">Apache
-            (vmgump - Ubuntu Linux 10.04)</fork> </td>
-        <td>OpenJDK 6</td>
+            (vmgump - Ubuntu Linux 14.04)</fork> </td>
+        <td>Oracle Java 8</td>
         <td>up to 4 times daily</td>

Modified: gump/live/src/documentation/content/xdocs/metadata/builder.xml
--- gump/live/src/documentation/content/xdocs/metadata/builder.xml (original)
+++ gump/live/src/documentation/content/xdocs/metadata/builder.xml Tue Feb 10 17:18:49 2015
@@ -56,7 +56,7 @@
         <td>No. Defaults to <em>project basedir</em>.</td>
-        <td>debug (Ant/Maven/NAnt only)</td>
+        <td>debug (Ant/Maven/NAnt/Gradle only)</td>
         <td>Set to "true" to turn on debugging.</td>
@@ -64,9 +64,9 @@
-      <p>Java Property overrides to be passed to the Ant/Maven command
+      <p>Java Property overrides to be passed to the Ant/Maven/Gradle command
       or command line arguments passed to Script/Configure/Make.  The
-      Java builders Ant and Maven as well as NAnt use &lt;property&gt;
+      Java builders Ant, Maven and Gradle as well as NAnt use &lt;property&gt;
       while Script, Configure and Make use &lt;arg&gt; as the name of
       the nested element.</p>
@@ -147,8 +147,8 @@
       that has become a common enough practice that it makes sense to
       introduce this element.</p>
-      <p>Depend is only supported by the Java builders Ant and Maven
-        (any version).</p>
+      <p>Depend is only supported by the Java builders Ant, Maven
+        (any version) and Gradle.</p>
@@ -184,7 +184,7 @@
       <p>Additional command line parameters to pass to the Java
-      Virtual Machine running Ant or Maven (any version).  Doesn't
+      Virtual Machine running Ant, Maven (any version) and Gradle.  Doesn't
       have any effect on any of the other builders.</p>
@@ -205,7 +205,7 @@
       <p>Java system property to be passed to the Java Virtual Machine.</p>
-      <p>Sysproperty is only supported by the Ant builder.</p>
+      <p>Sysproperty is only supported by the Ant and Gradle builders.</p>
@@ -672,6 +672,73 @@
+  <section><title>gradle</title>
+    <p>Specifies the arguments to be passed to <fork
+    href="">Gradle</fork>.</p>
+    <p>The <fork href="">Gradle</fork>
+    component of Gump (&lt;gradle&gt;) uses a
+    <strong>pre-installed</strong> version of <fork
+    href="">Gradle</fork>, it does
+    <strong>NOT</strong> bootstrap Gradle itself.</p>
+    <p>
+      All gradle builds use the same local repository as the Maven
+      builds and are told to always refresh the dependency cache.
+      This can be overriden on a per build basis, see below.  The
+      local repository is wiped out after each Gump run.
+    </p>
+    <p>
+      The Gradle build uses the same mvn repository proxy used by Gump
+      for Apache Maven builds.  This is achieved by injecting a Gradle
+      Init-Script that replaces the URIs of all known configured Maven
+      Repositories - in particular <code>mavenCentral()</code>.
+    </p>  
+    <p>
+      Technically it is not necessary to declare the dependencies of a
+      gradle built project since artifacts will be retrieved from the
+      proxy even if Gump doesn't know about the dependency.  This can
+      only work if the dependency has already been built, though, so
+      it is still better to list all dependencies inside the Gump
+      descriptor in order to maintain correct build order.
+    </p>
+    <table>
+      <tr>
+        <th>Attribute</th>
+        <th>Description</th>
+        <th>Required?</th>
+      </tr>
+      <tr>
+        <td>task</td>
+        <td>The Gradle task to invoke.  <em>This can be a comma
+        separated list. Spaces are preserved.</em></td>
+        <td>No. Defaults to <strong>build</strong>.</td>
+      </tr>
+      <tr>
+        <td>separateLocalRepository</td>
+        <td>Normally all &lt;mvn&gt; and &lt;gradle&gt; builds share
the same local
+          repository that will be removed after each complete Gump run.
+          Sometimes a project needs to use a separate local repository
+          from the others, the most common case is that a project needs
+          to be built against a released dependency instead of a Gump
+          built one in order to break a dependency cycle.<br/>
+          The value of this attribute can be a boolean or an
+          identifier.  If you use a boolean it simply en- or
+          disables a local repository separate from the other
+          directories and Gump will choose a directory name (if the
+          value is true).  If several projects are tightly related
+          and should share the same local repository different from
+          the other projects you can use an id instead of a boolean
+          and use the same id for each project.
+        </td>
+        <td>No. Defaults to <strong>false</strong>.</td>
+      </tr>
+    </table>
+  </section>

Modified: gump/live/src/documentation/content/xdocs/metadata/project.xml
--- gump/live/src/documentation/content/xdocs/metadata/project.xml (original)
+++ gump/live/src/documentation/content/xdocs/metadata/project.xml Tue Feb 10 17:18:49 2015
@@ -36,7 +36,7 @@
     <li><link href="builder.html">Build instructions</link>:
     &lt;ant&gt;, &lt;nant&gt;, &lt;mvn1&gt;, &lt;mvn2&gt;,
&lt;mvn3&gt;, &lt;configure&gt;,
-    &lt;make&gt; and &lt;script&gt;.<br/>
+    &lt;gradle&gt;, &lt;make&gt; and &lt;script&gt;.<br/>
           Describes how to produce the outputs from the inputs.</li>
     <li>Inputs: &lt;depend&gt;, &lt;option&gt;, and &lt;work&gt;.
     where to find the inputs (primarily jar files, but can be directories and

View raw message