You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@cordova.apache.org by ia...@apache.org on 2014/10/03 21:38:27 UTC
docs commit: CB-3445: Add initial Gradle build instructions to
Android platform docs
Repository: cordova-docs
Updated Branches:
refs/heads/master fc69d715a -> 7fa6b72e1
CB-3445: Add initial Gradle build instructions to Android platform docs
Project: http://git-wip-us.apache.org/repos/asf/cordova-docs/repo
Commit: http://git-wip-us.apache.org/repos/asf/cordova-docs/commit/7fa6b72e
Tree: http://git-wip-us.apache.org/repos/asf/cordova-docs/tree/7fa6b72e
Diff: http://git-wip-us.apache.org/repos/asf/cordova-docs/diff/7fa6b72e
Branch: refs/heads/master
Commit: 7fa6b72e160ccd935132029bccadb57e22d8cd07
Parents: fc69d71
Author: Ian Clelland <ic...@chromium.org>
Authored: Fri Oct 3 15:37:27 2014 -0400
Committer: Ian Clelland <ic...@chromium.org>
Committed: Fri Oct 3 15:37:27 2014 -0400
----------------------------------------------------------------------
docs/en/edge/guide/platforms/android/tools.md | 33 ++++++++++++++++++++++
1 file changed, 33 insertions(+)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/7fa6b72e/docs/en/edge/guide/platforms/android/tools.md
----------------------------------------------------------------------
diff --git a/docs/en/edge/guide/platforms/android/tools.md b/docs/en/edge/guide/platforms/android/tools.md
index 2084368..dd8324a 100644
--- a/docs/en/edge/guide/platforms/android/tools.md
+++ b/docs/en/edge/guide/platforms/android/tools.md
@@ -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](http://www.gradle.org/) 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
+
+ * **ANDROID\_BUILD**
+
+ 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.
+
+ * **BUILD\_MULTIPLE\_APKS**
+
+ 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: commits-unsubscribe@cordova.apache.org
For additional commands, e-mail: commits-help@cordova.apache.org