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 2013/12/18 16:41:25 UTC
[1/2] docs commit: CB-5232 Add note about cordova as lib
Updated Branches:
refs/heads/master 03c24a41b -> 549954424
CB-5232 Add note about cordova as lib
Project: http://git-wip-us.apache.org/repos/asf/cordova-docs/repo
Commit: http://git-wip-us.apache.org/repos/asf/cordova-docs/commit/cb9d7c75
Tree: http://git-wip-us.apache.org/repos/asf/cordova-docs/tree/cb9d7c75
Diff: http://git-wip-us.apache.org/repos/asf/cordova-docs/diff/cb9d7c75
Branch: refs/heads/master
Commit: cb9d7c75766cb30e57c694751559854be8d1cfb7
Parents: 03c24a4
Author: mbillau <mi...@gmail.com>
Authored: Wed Dec 18 10:03:15 2013 -0500
Committer: Andrew Grieve <ag...@chromium.org>
Committed: Wed Dec 18 15:17:27 2013 +0000
----------------------------------------------------------------------
docs/en/edge/guide/platforms/android/index.md | 2 ++
1 file changed, 2 insertions(+)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/cb9d7c75/docs/en/edge/guide/platforms/android/index.md
----------------------------------------------------------------------
diff --git a/docs/en/edge/guide/platforms/android/index.md b/docs/en/edge/guide/platforms/android/index.md
index 039294b..c6e50e9 100644
--- a/docs/en/edge/guide/platforms/android/index.md
+++ b/docs/en/edge/guide/platforms/android/index.md
@@ -125,6 +125,8 @@ Once created, here's how to use the SDK to modify it:
* Navigate to `hello`, or whichever directory you created for the project, then to the `platforms/android` subdirectory.
+* Make sure both `hello` and `hello-CordovaLib` projects are selected to be imported. The `hello-CordovaLib` project is needed as of Cordova 3.3.0 because Cordova is now used as an Android Library instead of a .jar file.
+
* Press __Finish__.
Once the Eclipse window opens, a red __X__ may appear to indicate
[2/2] docs commit: CB-5232 Add note about android subproject to
upgrade guide as well
Posted by ag...@apache.org.
CB-5232 Add note about android subproject to upgrade guide as well
Project: http://git-wip-us.apache.org/repos/asf/cordova-docs/repo
Commit: http://git-wip-us.apache.org/repos/asf/cordova-docs/commit/54995442
Tree: http://git-wip-us.apache.org/repos/asf/cordova-docs/tree/54995442
Diff: http://git-wip-us.apache.org/repos/asf/cordova-docs/diff/54995442
Branch: refs/heads/master
Commit: 5499544244b4555f969a9b5b6c3dfd07e24224f4
Parents: cb9d7c7
Author: Andrew Grieve <ag...@chromium.org>
Authored: Wed Dec 18 15:40:51 2013 +0000
Committer: Andrew Grieve <ag...@chromium.org>
Committed: Wed Dec 18 15:40:51 2013 +0000
----------------------------------------------------------------------
docs/en/3.0.0/guide/platforms/android/index.md | 32 ++++++++++++--------
.../3.3.0/guide/platforms/android/upgrading.md | 9 ++++++
.../edge/guide/platforms/android/upgrading.md | 9 ++++++
3 files changed, 38 insertions(+), 12 deletions(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/54995442/docs/en/3.0.0/guide/platforms/android/index.md
----------------------------------------------------------------------
diff --git a/docs/en/3.0.0/guide/platforms/android/index.md b/docs/en/3.0.0/guide/platforms/android/index.md
index 4e42f50..c6e50e9 100644
--- a/docs/en/3.0.0/guide/platforms/android/index.md
+++ b/docs/en/3.0.0/guide/platforms/android/index.md
@@ -20,8 +20,14 @@ license: Licensed to the Apache Software Foundation (ASF) under one
# Android Platform Guide
This guide shows how to set up your SDK development environment to
-deploy Cordova apps for Android devices. See the following for more
-detailed platform-specific information:
+deploy Cordova apps for Android devices. It walks you through the process
+of installing the Android SDK, opening an Android project in Eclipse SDK,
+and deploying to an emulator or device. You will need to follow this guide
+to at least Install the Android SDK, regardless of which workflow you
+are following. (Both the _Web Project Dev_ and _Native Platform Dev_ workflows
+require the Android SDK to be installed and accessable via your PATH.)
+
+See the following for more detailed platform-specific information:
* Android Configuration
* Android WebViews
@@ -30,7 +36,7 @@ detailed platform-specific information:
* Android Command-line Tools
The command-line tools above refer to versions prior to Cordova 3.0.
-See The Command-line Interface for information about the
+See The Command-Line Interface for information about the
current interface.
## Requirements and Support
@@ -49,17 +55,17 @@ NOTE, doc said:
-->
Developers should use the `cordova` utility in conjunction with
-the Android SDK. See The Command-line Interface for
+the Android SDK. See The Command-Line Interface for
information how to install it, add projects, then build and deploy a
project.
-## Install the SDK
-
Install the Android SDK from
-[developer.android.com/sdk](http://developer.android.com/sdk/). You
-may be presented with a choice of where to install the SDK, otherwise
-move the downloaded `adt-bundle` tree to wherever you store
-development tools.
+[developer.android.com/sdk](http://developer.android.com/sdk/). The android sdk
+is distributed as an 'adt-bundle-<os>-<arch>-<ver>' file.
+On windows, the adt-bundle is packaged with an installer.
+On OSX and Linux, simply unpack the 'adt-bundle' in the location you store development tools.
+[More detailed information on Android SDK setup can be found here](http://developer.android.com/sdk/installing/bundle.html)
+
For Cordova command-line tools to work, you need to include the SDK's
`tools` and `platform-tools` directories in your PATH environment. On
@@ -101,7 +107,7 @@ run:
## Open a Project in the SDK
Use the `cordova` utility to set up a new project, as described in The
-Cordova The Command-line Interface. For example, in a source-code directory:
+Cordova The Command-Line Interface. For example, in a source-code directory:
$ cordova create hello com.example.hello "HelloWorld"
$ cd hello
@@ -119,6 +125,8 @@ Once created, here's how to use the SDK to modify it:
* Navigate to `hello`, or whichever directory you created for the project, then to the `platforms/android` subdirectory.
+* Make sure both `hello` and `hello-CordovaLib` projects are selected to be imported. The `hello-CordovaLib` project is needed as of Cordova 3.3.0 because Cordova is now used as an Android Library instead of a .jar file.
+
* Press __Finish__.
Once the Eclipse window opens, a red __X__ may appear to indicate
@@ -178,7 +186,7 @@ application to the emulator from the command line:
$ cordova emulate android
-If instead you are working within Eclipse, right-click the project and
+If instead you work within Eclipse, right-click the project and
choose __Run As → Android Application__. You may be asked to
specify an AVD if none are already open.
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/54995442/docs/en/3.3.0/guide/platforms/android/upgrading.md
----------------------------------------------------------------------
diff --git a/docs/en/3.3.0/guide/platforms/android/upgrading.md b/docs/en/3.3.0/guide/platforms/android/upgrading.md
index 8e87dd5..c258bea 100644
--- a/docs/en/3.3.0/guide/platforms/android/upgrading.md
+++ b/docs/en/3.3.0/guide/platforms/android/upgrading.md
@@ -24,6 +24,15 @@ Most of these instructions apply to projects created with an older set
of command-line tools that precede the `cordova` CLI utility. See The Command-Line Interface for information how to update the
version of the CLI.
+## Upgrading to 3.3.0 from 3.2.0
+
+Follow the same instructinos as for `3.2.0`.
+
+Starting with 3.3.0, the Cordova runtime is now compiled as an Android Library
+instead of a Jar. This should have no effect for command-line usage, but IDE
+users will need to import the newly added `MyProject-CordovaLib` project into
+their workspace.
+
## Upgrading to 3.2.0 from 3.1.0
For projects that were created with the cordova CLI:
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/54995442/docs/en/edge/guide/platforms/android/upgrading.md
----------------------------------------------------------------------
diff --git a/docs/en/edge/guide/platforms/android/upgrading.md b/docs/en/edge/guide/platforms/android/upgrading.md
index 8e87dd5..c258bea 100644
--- a/docs/en/edge/guide/platforms/android/upgrading.md
+++ b/docs/en/edge/guide/platforms/android/upgrading.md
@@ -24,6 +24,15 @@ Most of these instructions apply to projects created with an older set
of command-line tools that precede the `cordova` CLI utility. See The Command-Line Interface for information how to update the
version of the CLI.
+## Upgrading to 3.3.0 from 3.2.0
+
+Follow the same instructinos as for `3.2.0`.
+
+Starting with 3.3.0, the Cordova runtime is now compiled as an Android Library
+instead of a Jar. This should have no effect for command-line usage, but IDE
+users will need to import the newly added `MyProject-CordovaLib` project into
+their workspace.
+
## Upgrading to 3.2.0 from 3.1.0
For projects that were created with the cordova CLI: