cordova-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
Subject docs commit: CB-3445: Add initial Gradle build instructions to Android platform docs
Date Fri, 03 Oct 2014 19:38:27 GMT
Repository: cordova-docs
Updated Branches:
  refs/heads/master fc69d715a -> 7fa6b72e1

CB-3445: Add initial Gradle build instructions to Android platform docs


Branch: refs/heads/master
Commit: 7fa6b72e160ccd935132029bccadb57e22d8cd07
Parents: fc69d71
Author: Ian Clelland <>
Authored: Fri Oct 3 15:37:27 2014 -0400
Committer: Ian Clelland <>
Committed: Fri Oct 3 15:37:27 2014 -0400

 docs/en/edge/guide/platforms/android/ | 33 ++++++++++++++++++++++
 1 file changed, 33 insertions(+)
diff --git a/docs/en/edge/guide/platforms/android/ b/docs/en/edge/guide/platforms/android/
index 2084368..dd8324a 100644
--- a/docs/en/edge/guide/platforms/android/
+++ b/docs/en/edge/guide/platforms/android/
@@ -114,3 +114,36 @@ the `cordova/build` and `cordova/run` scripts described above. For this
 reason it is recommended to use the `cordova/build` and `cordova/run` scripts
 instead of calling Ant directly from the command line.
+## Building with Gradle (Experimental!)
+Cordova for Android now supports building with [Gradle]( This is optional
in Cordova 3.x, but will be enabled by default in the future, probably with Cordova 4.0. The
build system is controlled with environment variables, which can be set for the shell, or
specified on the command line alongside the `cordova build` command.
+Please note that the Gradle build rules are still in development, and will likely be subject
to large changes before Gradle becomes the default build system. Developers are encouraged
to try it, and experiment with it, but if you base your own production build system on top
of it, you will probably experience several breaking changes over the next few releases, before
it stabilizes.
+### Relevant Environment Variables
+  This variable controls which build system is used to build the project. In can take either
of the values `ant` or `gradle`.
+  If not set, it currently defaults to `ant`, but this is expected to change.
+  If this is set, then multiple APK files will be generated: One per native platform supported
by library projects (x86, ARM, etc). This can be important if your project uses large native
libraries, which can drastically increase the size of the generated APK.
+  If not set, then a single APK will be generated which can be used on all devices.
+### Other Environment Variables
+  * **ANDROID\_HOME**
+  This should be set to the directory containing the Android SDK.
+  * **JAVA\_HOME**
+  On some machines, this will need to be set so that Gradle can find the Java compiler. On
OSX, the value for this variable can be found by running `/usr/libexec/java_home`
+### Example Build
+        ANDROID_BUILD=gradle cordova build android

To unsubscribe, e-mail:
For additional commands, e-mail:

View raw message