cordova-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From agri...@apache.org
Subject docs commit: Add gradle docs for ANDROID_VERSION_CODE and RELEASE_SIGNING_PROPERTIES_FILE
Date Mon, 06 Oct 2014 19:35:17 GMT
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 <agrieve@chromium.org>
Authored: Mon Oct 6 15:34:37 2014 -0400
Committer: Andrew Grieve <agrieve@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


Mime
View raw message