cordova-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From agri...@apache.org
Subject docs commit: CB-5982 Android Platform guide improvements
Date Fri, 14 Feb 2014 16:47:08 GMT
Updated Branches:
  refs/heads/master 3318b2dee -> 57df3251e


CB-5982 Android Platform guide improvements

I have clarified some steps(same for Amazon FireOS), and improved the
AVD Emulator guidance in the Android Platform.

Some more information about how to work with Intel Atom x86 System
Images as well detailed information about how to use Virtualization
Technologies with the AVD Emulator.

References about the information provided:

http://software.intel.com/en-us/android/articles/speeding-up-the-android-emulator-on-intel-architecture
http://ark.intel.com/products/virtualizationtechnology
http://en.wikipedia.org/wiki/X86_virtualization

http://support.amd.com/TechDocs/50911_15h_Mod_10h-1Fh_A-Series_PDS.pdf#search=AMD%2DV%20support
http://developer.amd.com/wordpress/media/2012/10/33610_0Fh_Rev_Gd.pdf
http://support.amd.com/en-us/kb-articles/Pages/emb-309-npt.aspx
http://news.cnet.com/8301-13924_3-10235329-64.html
http://developer.android.com/tools/help/emulator.html
http://developer.android.com/tools/devices/emulator.html


Project: http://git-wip-us.apache.org/repos/asf/cordova-docs/repo
Commit: http://git-wip-us.apache.org/repos/asf/cordova-docs/commit/57df3251
Tree: http://git-wip-us.apache.org/repos/asf/cordova-docs/tree/57df3251
Diff: http://git-wip-us.apache.org/repos/asf/cordova-docs/diff/57df3251

Branch: refs/heads/master
Commit: 57df3251ebadaf9c5d1639175df2bcc7ade36150
Parents: 3318b2d
Author: martincgg <martin.c.glez.glez@gmail.com>
Authored: Thu Feb 13 16:14:23 2014 -0600
Committer: Andrew Grieve <agrieve@chromium.org>
Committed: Fri Feb 14 11:46:47 2014 -0500

----------------------------------------------------------------------
 .../edge/guide/platforms/amazonfireos/index.md  |   2 +-
 docs/en/edge/guide/platforms/android/index.md   |  45 ++++++++++++++-----
 .../android/asdk_man_intel_image_haxm.png       | Bin 0 -> 21027 bytes
 .../android/asdk_new_and_dev_intel.png          | Bin 0 -> 89574 bytes
 .../platforms/android/intel_pid_util_620px.png  | Bin 0 -> 157685 bytes
 5 files changed, 36 insertions(+), 11 deletions(-)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/57df3251/docs/en/edge/guide/platforms/amazonfireos/index.md
----------------------------------------------------------------------
diff --git a/docs/en/edge/guide/platforms/amazonfireos/index.md b/docs/en/edge/guide/platforms/amazonfireos/index.md
index 6c71051..f4b81ac 100644
--- a/docs/en/edge/guide/platforms/amazonfireos/index.md
+++ b/docs/en/edge/guide/platforms/amazonfireos/index.md
@@ -103,7 +103,7 @@ Cordova The Command-line Interface. For example, in a source-code directory:
     $ cordova platform add amazon-fireos
     $ cordova build
 
-Once created, here's how to use the SDK to modify it:
+Once created, you can use the Eclipse that comes along with the Android SDK to modify it:
 
 * Launch the __Eclipse__ application.
 

http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/57df3251/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 7fae14b..1bb1ec1 100644
--- a/docs/en/edge/guide/platforms/android/index.md
+++ b/docs/en/edge/guide/platforms/android/index.md
@@ -114,7 +114,7 @@ Cordova The Command-Line Interface. For example, in a source-code directory:
         $ cordova platform add android
         $ cordova build
 
-Once created, here's how to use the SDK to modify it:
+Once created, you can use the Eclipse that comes along with the Android SDK to modify it:
 
 * Launch the __Eclipse__ application.
 
@@ -190,19 +190,44 @@ If instead you work within Eclipse, right-click the project and
 choose __Run As &rarr; Android Application__. You may be asked to
 specify an AVD if none are already open.
 
-For a faster experience, use an Intel-based emulator image:
+For a faster experience, you can use the `Virtual Machine Acceleration` to improve 
+the execution speed.
+Many modern CPUs provide extensions to execute Virtual Machines more efficiently.
+Before attempting to use this type of acceleration, you need to determine if your 
+current development system's CPU, supports one the following virtualization technologies:
 
-* Install one or more `Intel x86 Atom` System Images as well as the
-  `Intel Hardware Accelerated Execution Manager`, available under
-  __Extras__.
+* __Intel Virtualization Technology__ (VT-x, vmx) &rarr; [Intel VT-x supported processor
list](http://ark.intel.com/products/virtualizationtechnology)
+* __AMD Virtualization__ (AMD-V, SVM), only supported for Linux (Since May 2006, all CPUs
AMD include AMD-V, except Sempron).
 
-* Run the Intel installer, which is available within your Android SDK
-  at `extras/intel/Hardware_Accelerated_Execution_Manager`.
+Another way to find out if your Intel processor supports VT-x Technology, it's by executing
the 
+`Intel Processor Identification Utility`, for `Windows`you can download it from the Intel
[Download Center](https://downloadcenter.intel.com/Detail_Desc.aspx?ProductID=1881&DwnldID=7838),
+or you can use the [booteable utility](https://downloadcenter.intel.com/Detail_Desc.aspx?ProductID=1881&DwnldID=7840&lang=eng),
which is `OS Independent`.
 
-* Create a new AVD with the target set to an Intel image.
+After install and execute the `Intel Processor Identification Utility` over Windows, you
will get the following window, 
+in order to check if your CPU supports the Virtualization Technologies:
 
-* When starting the emulator, ensure there are no error messages
-  indicating a failure to load HAX modules.
+![](img/guide/platforms/android/intel_pid_util_620px.png)
+
+In order to speed up the emulator, you need to download and install one or more `Intel x86
Atom` System Images, 
+as well as the `Intel Hardware Accelerated Execution Manager (HAXM)`.
+
+Open your Android SDK Manager, and select the `Intel x86 Atom` System Image, for whichever
version that you want to test. Then go to `Extras` 
+and select `Intel x86 Emulator Accelerator (HAXM)`, and install those packages:
+
+![](img/guide/platforms/android/asdk_man_intel_image_haxm.png)
+
+After download, run the Intel installer, which is available within your
+Android SDK at `extras/intel/Hardware_Accelerated_Execution_Manager`. 
+__Note__:`If you have any problems installing the package, you can find more information
and step by step guidance check this` 
+[Intel Article](http://software.intel.com/en-us/android/articles/speeding-up-the-android-emulator-on-intel-architecture).
+
+Once installed, in order to test it, create new a AVD  with the `CPU/ABI` set to an `Intel
(Atom) x86`  Image:
+
+![](img/guide/platforms/android/asdk_new_and_dev_intel.png)
+
+If you are using `Linux-based system`, follow the instructions in the [Android Developer
Site](http://developer.android.com/tools/devices/emulator.html#vm-linux).
+
+When starting the emulator, ensure there are no error messages indicating a failure to load
HAXM modules.
 
 ## Deploy to Device
 

http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/57df3251/template/docs/default/img/guide/platforms/android/asdk_man_intel_image_haxm.png
----------------------------------------------------------------------
diff --git a/template/docs/default/img/guide/platforms/android/asdk_man_intel_image_haxm.png
b/template/docs/default/img/guide/platforms/android/asdk_man_intel_image_haxm.png
new file mode 100644
index 0000000..540611b
Binary files /dev/null and b/template/docs/default/img/guide/platforms/android/asdk_man_intel_image_haxm.png
differ

http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/57df3251/template/docs/default/img/guide/platforms/android/asdk_new_and_dev_intel.png
----------------------------------------------------------------------
diff --git a/template/docs/default/img/guide/platforms/android/asdk_new_and_dev_intel.png
b/template/docs/default/img/guide/platforms/android/asdk_new_and_dev_intel.png
new file mode 100644
index 0000000..78b4a8e
Binary files /dev/null and b/template/docs/default/img/guide/platforms/android/asdk_new_and_dev_intel.png
differ

http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/57df3251/template/docs/default/img/guide/platforms/android/intel_pid_util_620px.png
----------------------------------------------------------------------
diff --git a/template/docs/default/img/guide/platforms/android/intel_pid_util_620px.png b/template/docs/default/img/guide/platforms/android/intel_pid_util_620px.png
new file mode 100644
index 0000000..80ea235
Binary files /dev/null and b/template/docs/default/img/guide/platforms/android/intel_pid_util_620px.png
differ


Mime
View raw message