You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@cordova.apache.org by ag...@apache.org on 2014/10/06 21:35:17 UTC
docs commit: Add gradle docs for ANDROID_VERSION_CODE and
RELEASE_SIGNING_PROPERTIES_FILE
Repository: cordova-docs
Updated Branches:
refs/heads/master 6fab90fb3 -> b7ed92648
Add gradle docs for ANDROID_VERSION_CODE and RELEASE_SIGNING_PROPERTIES_FILE
Project: http://git-wip-us.apache.org/repos/asf/cordova-docs/repo
Commit: http://git-wip-us.apache.org/repos/asf/cordova-docs/commit/b7ed9264
Tree: http://git-wip-us.apache.org/repos/asf/cordova-docs/tree/b7ed9264
Diff: http://git-wip-us.apache.org/repos/asf/cordova-docs/diff/b7ed9264
Branch: refs/heads/master
Commit: b7ed92648302d93a214b367de4dd343d2aeece91
Parents: 6fab90f
Author: Andrew Grieve <ag...@chromium.org>
Authored: Mon Oct 6 15:34:37 2014 -0400
Committer: Andrew Grieve <ag...@chromium.org>
Committed: Mon Oct 6 15:35:13 2014 -0400
----------------------------------------------------------------------
docs/en/edge/guide/platforms/android/tools.md | 57 +++++++++++++++++++---
1 file changed, 50 insertions(+), 7 deletions(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/b7ed9264/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 dd8324a..300819b 100644
--- a/docs/en/edge/guide/platforms/android/tools.md
+++ b/docs/en/edge/guide/platforms/android/tools.md
@@ -116,25 +116,66 @@ 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.
+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`.
+ 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 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.
+
+ * **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\_VERSION\_CODE**
+
+ Overrides the versionCode set in `AndroidManifest.xml`
+
+ * **RELEASE\_SIGNING\_PROPERTIES\_FILE**
+
+ Path to a .properties file that contains signing information for release builds.
+ The file should look like:
+ ```
+ storeFile=relative/path/to/keystore.p12
+ storePassword=SECRET1
+ storeType=pkcs12
+ keyAlias=DebugSigningKey
+ keyPassword=SECRET2
+ ```
+
+ `storePassword` and `keyPassword` are optional, and will be prompted for if omitted.
+
+
+### Other Environment Variables (you don't normally need to set these)
* **ANDROID\_HOME**
@@ -142,7 +183,9 @@ Please note that the Gradle build rules are still in development, and will likel
* **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`
+ 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
---------------------------------------------------------------------
To unsubscribe, e-mail: commits-unsubscribe@cordova.apache.org
For additional commands, e-mail: commits-help@cordova.apache.org