You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@cordova.apache.org by ma...@apache.org on 2013/10/01 05:56:01 UTC

svn commit: r1527865 [16/25] - in /cordova/site/public/docs/en/3.1.0: ./ img/ img/guide/ img/guide/cli/ img/guide/platforms/ img/guide/platforms/android/ img/guide/platforms/bada/ img/guide/platforms/blackberry10/ img/guide/platforms/ios/ img/guide/pla...

Added: cordova/site/public/docs/en/3.1.0/guide_platforms_android_index.md.html
URL: http://svn.apache.org/viewvc/cordova/site/public/docs/en/3.1.0/guide_platforms_android_index.md.html?rev=1527865&view=auto
==============================================================================
--- cordova/site/public/docs/en/3.1.0/guide_platforms_android_index.md.html (added)
+++ cordova/site/public/docs/en/3.1.0/guide_platforms_android_index.md.html Tue Oct  1 03:55:57 2013
@@ -0,0 +1,333 @@
+<!DOCTYPE html>
+<!--
+    Licensed to the Apache Software Foundation (ASF) under one
+    or more contributor license agreements.  See the NOTICE file
+    distributed with this work for additional information
+    regarding copyright ownership.  The ASF licenses this file
+    to you under the Apache License, Version 2.0 (the
+    "License"); you may not use this file except in compliance
+    with the License.  You may obtain a copy of the License at
+
+      http://www.apache.org/licenses/LICENSE-2.0
+
+    Unless required by applicable law or agreed to in writing,
+    software distributed under the License is distributed on an
+    "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+    KIND, either express or implied.  See the License for the
+    specific language governing permissions and limitations
+    under the License.
+--><html lang="en">
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
+<meta name="viewport" content="initial-scale=1.0, maximum-scale=1.0, user-scalable=no, width=device-width">
+<meta name="generator" content="joDoc">
+<title>Apache Cordova API Documentation</title>
+<link rel="stylesheet" type="text/css" href="index.css">
+<link rel="stylesheet" type="text/css" href="mobile.css" media="only screen and (max-device-width: 1024px)">
+<link rel="stylesheet" type="text/css" href="prettify/prettify.css">
+</head>
+<body>
+        <div id="header">
+            <h1><a href="index.html">Apache <strong>Cordova</strong> Documentation</a></h1>
+            <small>
+                <select><optgroup label="Chinese" value="zh"><option value="edge">edge</option></optgroup>
+<optgroup label="English" value="en">
+<option value="edge">edge</option>
+<option selected value="3.1.0">3.1.0</option>
+<option value="3.0.0">3.0.0</option>
+<option value="2.9.0">2.9.0</option>
+<option value="2.8.0">2.8.0</option>
+<option value="2.7.0">2.7.0</option>
+<option value="2.6.0">2.6.0</option>
+<option value="2.5.0">2.5.0</option>
+<option value="2.4.0">2.4.0</option>
+<option value="2.3.0">2.3.0</option>
+<option value="2.2.0">2.2.0</option>
+<option value="2.1.0">2.1.0</option>
+<option value="2.0.0">2.0.0</option>
+<option value="1.9.0">1.9.0</option>
+<option value="1.8.1">1.8.1</option>
+<option value="1.8.0">1.8.0</option>
+<option value="1.7.0">1.7.0</option>
+<option value="1.6.1">1.6.1</option>
+<option value="1.6.0">1.6.0</option>
+<option value="1.5.0">1.5.0</option>
+</optgroup>
+<optgroup label="French" value="fr"><option value="edge">edge</option></optgroup>
+<optgroup label="German" value="de"><option value="edge">edge</option></optgroup>
+<optgroup label="Italian" value="it"><option value="edge">edge</option></optgroup>
+<optgroup label="Japanese" value="ja">
+<option value="edge">edge</option>
+<option value="2.2.0">2.2.0</option>
+<option value="2.1.0">2.1.0</option>
+<option value="2.0.0">2.0.0</option>
+<option value="1.9.0">1.9.0</option>
+<option value="1.8.1">1.8.1</option>
+<option value="1.7.0">1.7.0</option>
+</optgroup>
+<optgroup label="Korean" value="ko">
+<option value="edge">edge</option>
+<option value="2.0.0">2.0.0</option>
+</optgroup>
+<optgroup label="Russian" value="ru"><option value="edge">edge</option></optgroup>
+<optgroup label="Spanish" value="es"><option value="edge">edge</option></optgroup></select></small>
+        </div>
+        <div id="subheader">
+            <h1>Android Platform Guide</h1>
+            <small><select><option value="Android%2520Platform%2520Guide">Android Platform Guide</option>
+<option value="Android%20Platform%20Guide_requirements_and_support">      - Requirements and Support</option>
+<option value="Android%20Platform%20Guide_install_the_sdk">      - Install the SDK</option>
+<option value="Android%20Platform%20Guide_open_a_project_in_the_sdk">      - Open a Project in the SDK</option>
+<option value="Android%20Platform%20Guide_deploy_to_emulator">      - Deploy to Emulator</option>
+<option value="Android%20Platform%20Guide_deploy_to_device">      - Deploy to Device
+</option></select></small>
+        </div>
+
+        <div id="sidebar">
+            <div class="vertical_divider"></div>
+        <h1>Guides</h1>
+<ul>
+<li><a href="guide_overview_index.md.html#Overview">Overview</a></li>
+<li><a href="guide_cli_index.md.html#The%20Command-line%20Interface">The Command-line Interface</a></li>
+<li><a href="guide_platforms_index.md.html#Platform%20Guides">Platform Guides</a></li>
+<li><a href="config_ref_index.md.html#The%20config.xml%20File">The config.xml File</a></li>
+<li><a href="guide_hybrid_webviews_index.md.html#Embedding%20WebViews">Embedding WebViews</a></li>
+<li><a href="guide_hybrid_plugins_index.md.html#Plugin%20Development%20Guide">Plugin Development Guide</a></li>
+<li><a href="guide_appdev_privacy_index.md.html#Privacy%20Guide">Privacy Guide</a></li>
+<li><a href="guide_appdev_whitelist_index.md.html#Domain%20Whitelist%20Guide">Domain Whitelist Guide</a></li>
+<li><a href="_index.html">Keyword Index</a></li>
+</ul>
+<h1>API Reference</h1>
+<ul>
+<li><a href="cordova_accelerometer_accelerometer.md.html#Accelerometer">Accelerometer</a></li>
+<li><a href="cordova_camera_camera.md.html#Camera">Camera</a></li>
+<li><a href="cordova_media_capture_capture.md.html#Capture">Capture</a></li>
+<li><a href="cordova_compass_compass.md.html#Compass">Compass</a></li>
+<li><a href="cordova_connection_connection.md.html#Connection">Connection</a></li>
+<li><a href="cordova_contacts_contacts.md.html#Contacts">Contacts</a></li>
+<li><a href="cordova_device_device.md.html#Device">Device</a></li>
+<li><a href="cordova_events_events.md.html#Events">Events</a></li>
+<li><a href="cordova_file_file.md.html#File">File</a></li>
+<li><a href="cordova_geolocation_geolocation.md.html#Geolocation">Geolocation</a></li>
+<li><a href="cordova_globalization_globalization.md.html#Globalization">Globalization</a></li>
+<li><a href="cordova_inappbrowser_inappbrowser.md.html#InAppBrowser">InAppBrowser</a></li>
+<li><a href="cordova_media_media.md.html#Media">Media</a></li>
+<li><a href="cordova_notification_notification.md.html#Notification">Notification</a></li>
+<li><a href="cordova_splashscreen_splashscreen.md.html#Splashscreen">Splashscreen</a></li>
+<li><a href="cordova_storage_storage.md.html#Storage">Storage</a></li>
+</ul>
+</div>
+
+        <div id="scrollable">
+            <div id="content">
+                <h1><a name="Android%20Platform%20Guide">Android Platform Guide</a></h1>
+
+<p>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:</p>
+
+<ul>
+<li><a href="guide_platforms_android_config.md.html#Android%20Configuration">Android Configuration</a></li>
+<li><a href="guide_platforms_android_webview.md.html#Android%20WebViews">Android WebViews</a></li>
+<li><a href="guide_platforms_android_plugin.md.html#Android%20Plugins">Android Plugins</a></li>
+<li><a href="guide_platforms_android_upgrading.md.html#Upgrading%20Android">Upgrading Android</a></li>
+<li><a href="guide_platforms_android_tools.md.html#Android%20Command-line%20Tools">Android Command-line Tools</a></li>
+</ul>
+<p>The command-line tools above refer to versions prior to Cordova 3.0.
+See <a href="guide_cli_index.md.html#The%20Command-line%20Interface">The Command-line Interface</a> for information about the
+current interface.</p>
+
+<h2>
+<a name="Android%20Platform%20Guide_requirements_and_support">Requirements and Support</a>
+</h2>
+
+<p>See the <a class="external" href="http://developer.android.com/sdk/index.html">System Requirements</a>
+for the Android SDK.</p>
+
+<p>Cordova supports Android 2.2, 2.3, and 4.x.  As a general rule,
+platforms are deprecated as they dip below 5% on Google's
+<a class="external" href="http://developer.android.com/about/dashboards/index.html">distribution dashboard</a>.</p>
+
+<!--
+NOTE, doc said:
+- Android 2.1 (Deprecated May 2013)
+- Android 3.x (Deprecated May 2013)
+-->
+
+<p>Developers should use the <code>cordova</code> utility in conjunction with
+the Android SDK.  See <a href="guide_cli_index.md.html#The%20Command-line%20Interface">The Command-line Interface</a> for
+information how to install it, add projects, then build and deploy a
+project.</p>
+
+<h2>
+<a name="Android%20Platform%20Guide_install_the_sdk">Install the SDK</a>
+</h2>
+
+<p>Install the Android SDK from
+<a class="external" href="http://developer.android.com/sdk/">developer.android.com/sdk</a>.  You
+may be presented with a choice of where to install the SDK, otherwise
+move the downloaded <code>adt-bundle</code> tree to wherever you store
+development tools.</p>
+
+<p>For Cordova command-line tools to work, you need to include the SDK's
+<code>tools</code> and <code>platform-tools</code> directories in your PATH environment.  On
+Mac, you can use a text editor to create or modify the
+<code>~/.bash_profile</code> file, adding a line such as the following, depending
+on where the SDK installs:</p>
+
+<pre class="prettyprint"><code>export PATH=${PATH}:/Development/adt-bundle/sdk/platform-tools:/Development/adt-bundle/sdk/tools
+</code></pre>
+
+<p>This exposes SDK tools in newly opened terminal windows. Otherwise run
+this to make them available in the current session:</p>
+
+<pre class="prettyprint"><code>$ source ~/.bash_profile
+</code></pre>
+
+<p>To modify the PATH environment on Windows 7:</p>
+
+<ul>
+<li><p>Click on the <strong>Start</strong> menu in the lower-left corner of the desktop,
+right-click on <strong>Computer</strong>, then click <strong>Properties</strong>.</p></li>
+<li><p>Click <strong>Advanced System Settings</strong> in the column on the left.</p></li>
+<li><p>In the resulting dialog box, press <strong>Environment <a href="plugin_ref_spec.md.html#Variables">Variables</a></strong>.</p></li>
+<li><p>Select the <strong>PATH</strong> variable and press <strong>Edit</strong>.</p></li>
+<li>
+<p>Append the following to the PATH based on where you installed the
+SDK, for example:</p>
+
+<pre class="prettyprint"><code>;C:\Development\adt-bundle\sdk\platform-tools;C:\Development\adt-bundle\sdk\tools
+</code></pre>
+</li>
+<li><p>Save the value and <a href="cordova_inappbrowser_inappbrowser.md.html#close">close</a> both dialog boxes.</p></li>
+</ul>
+<p>You may also need to enable Java and Ant. Open a command prompt and
+type <code>java</code>, and also type <code>ant</code>. Append to the PATH whichever fail to
+run:</p>
+
+<pre class="prettyprint"><code>    ;%JAVA_HOME%\bin;%ANT_HOME%\bin
+</code></pre>
+
+<h2>
+<a name="Android%20Platform%20Guide_open_a_project_in_the_sdk">Open a Project in the SDK</a>
+</h2>
+
+<p>Use the <code>cordova</code> utility to set up a new project, as described in The
+Cordova <a href="guide_cli_index.md.html#The%20Command-line%20Interface">The Command-line Interface</a>. For example, in a source-code directory:</p>
+
+<pre class="prettyprint"><code>    $ cordova create hello com.example.hello "HelloWorld"
+    $ cd hello
+    $ cordova platform add android
+    $ cordova build
+</code></pre>
+
+<p>Once created, here's how to use the SDK to modify it:</p>
+
+<ul>
+<li><p>Launch the <strong>Eclipse</strong> application.</p></li>
+<li><p>Select the <strong>New Project</strong> menu item.</p></li>
+<li><p>Choose <strong>Android Project from Existing Code</strong> from the resulting dialog box, and press <strong>Next</strong>:
+<img src="img/guide/platforms/android/eclipse_new_project.png" alt="" title=""></p></li>
+<li><p>Navigate to <code>hello</code>, or whichever directory you created for the project, then to the <code>platforms/android</code> subdirectory.</p></li>
+<li><p>Press <strong>Finish</strong>.</p></li>
+</ul>
+<p>Once the Eclipse window opens, a red <strong>X</strong> may appear to indicate
+unresolved problems. If so, follow these additional steps:</p>
+
+<ul>
+<li><p>Right-click on the project directory.</p></li>
+<li><p>In the resulting <strong>Properties</strong> dialog, select <strong>Android</strong> from the navigation pane.</p></li>
+<li><p>For the project build target, select the highest Android API level you have installed.</p></li>
+<li><p>Click <strong>OK</strong>.</p></li>
+<li><p>Select <strong>Clean</strong> from the <strong>Project</strong> menu. This should correct all the errors in the project.</p></li>
+</ul>
+<h2>
+<a name="Android%20Platform%20Guide_deploy_to_emulator">Deploy to Emulator</a>
+</h2>
+
+<p>You can use the <code>cordova</code> utility to run an app in an emulator, or you
+can run it within the SDK.  Either way, the SDK must first be
+configured to display at least one device. To do so, use the Android
+SDK Manager, a Java application that runs separately from Eclipse.
+There are two ways to open it:</p>
+
+<ul>
+<li><p>Run <code>android</code> on the command line.</p></li>
+<li>
+<p>From within Eclipse, press this toolbar icon:</p>
+
+<p><img src="img/guide/platforms/android/eclipse_android_sdk_button.png" alt="" title=""></p>
+</li>
+</ul>
+<p>Once open, the Android SDK Manager displays various runtime libraries:</p>
+
+<p><img src="img/guide/platforms/android/asdk_window.png" alt="" title=""></p>
+
+<p>Choose <strong>Tools → Manage AVDs</strong> (Android Virtual Devices), then
+choose any item from <strong><a href="cordova_device_device.md.html#Device">Device</a> Definitions</strong> in the resulting dialog
+box:</p>
+
+<p><img src="img/guide/platforms/android/asdk_device.png" alt="" title=""></p>
+
+<p>Press <strong>Create AVD</strong>, optionally modifying the name, then press <strong>OK</strong>
+to accept the changes:</p>
+
+<p><img src="img/guide/platforms/android/asdk_newAVD.png" alt="" title=""></p>
+
+<p>The AVD then appears in the <strong>Android Virtual Devices</strong> list:</p>
+
+<p><img src="img/guide/platforms/android/asdk_avds.png" alt="" title=""></p>
+
+<p>To open the emulator as a separate application, select the AVD and
+press <strong>Start</strong>. It launches much as it would on the device, with
+additional controls available for hardware buttons:</p>
+
+<p><img src="img/guide/platforms/android/asdk_emulator.png" alt="" title=""></p>
+
+<p>At this point you can use the <code>cordova</code> utility to deploy the
+application to the emulator from the command line:</p>
+
+<pre class="prettyprint"><code>    $ cordova emulate android
+</code></pre>
+
+<p>If instead you are working within Eclipse, right-click the project and
+choose <strong>Run As → Android Application</strong>. You may be asked to
+specify an AVD if none are already open.</p>
+
+<p>For a faster experience, use an Intel-based emulator image:</p>
+
+<ul>
+<li><p>Install one or more <code>Intel x86 Atom</code> System Images as well as the
+<code>Intel Hardware Accelerated Execution Manager</code>, available under
+<strong>Extras</strong>.</p></li>
+<li><p>Run the Intel installer, which is available within your Android SDK
+at <code>extras/intel/Hardware_Accelerated_Execution_Manager</code>.</p></li>
+<li><p>Create a new AVD with the target set to an Intel image.</p></li>
+<li><p>When starting the emulator, ensure there are no error messages
+indicating a failure to load HAX modules.</p></li>
+</ul>
+<h2>
+<a name="Android%20Platform%20Guide_deploy_to_device">Deploy to Device
+</a>
+</h2>
+
+<p>To push an app directly to the device, make sure USB debugging is
+enabled on your device as described on the
+<a class="external" href="http://developer.android.com/tools/device.html">Android Developer Site</a>,
+and use a mini USB cable to plug it into your system.</p>
+
+<p>You can push the app to the device from the command line:</p>
+
+<pre class="prettyprint"><code>    $ cordova run android
+</code></pre>
+
+<p>Alternately within Eclipse, right-click the project and choose <strong>Run
+As → Android Application</strong>.</p>
+
+            </div>
+        </div>
+
+        <!-- Functionality and Syntax Highlighting -->
+        <script type="text/javascript" src="index.js"></script><script type="text/javascript" src="prettify/prettify.js"></script>
+</body>
+</html>

Added: cordova/site/public/docs/en/3.1.0/guide_platforms_android_plugin.md.html
URL: http://svn.apache.org/viewvc/cordova/site/public/docs/en/3.1.0/guide_platforms_android_plugin.md.html?rev=1527865&view=auto
==============================================================================
--- cordova/site/public/docs/en/3.1.0/guide_platforms_android_plugin.md.html (added)
+++ cordova/site/public/docs/en/3.1.0/guide_platforms_android_plugin.md.html Tue Oct  1 03:55:57 2013
@@ -0,0 +1,333 @@
+<!DOCTYPE html>
+<!--
+    Licensed to the Apache Software Foundation (ASF) under one
+    or more contributor license agreements.  See the NOTICE file
+    distributed with this work for additional information
+    regarding copyright ownership.  The ASF licenses this file
+    to you under the Apache License, Version 2.0 (the
+    "License"); you may not use this file except in compliance
+    with the License.  You may obtain a copy of the License at
+
+      http://www.apache.org/licenses/LICENSE-2.0
+
+    Unless required by applicable law or agreed to in writing,
+    software distributed under the License is distributed on an
+    "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+    KIND, either express or implied.  See the License for the
+    specific language governing permissions and limitations
+    under the License.
+--><html lang="en">
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
+<meta name="viewport" content="initial-scale=1.0, maximum-scale=1.0, user-scalable=no, width=device-width">
+<meta name="generator" content="joDoc">
+<title>Apache Cordova API Documentation</title>
+<link rel="stylesheet" type="text/css" href="index.css">
+<link rel="stylesheet" type="text/css" href="mobile.css" media="only screen and (max-device-width: 1024px)">
+<link rel="stylesheet" type="text/css" href="prettify/prettify.css">
+</head>
+<body>
+        <div id="header">
+            <h1><a href="index.html">Apache <strong>Cordova</strong> Documentation</a></h1>
+            <small>
+                <select><optgroup label="Chinese" value="zh"><option value="edge">edge</option></optgroup>
+<optgroup label="English" value="en">
+<option value="edge">edge</option>
+<option selected value="3.1.0">3.1.0</option>
+<option value="3.0.0">3.0.0</option>
+<option value="2.9.0">2.9.0</option>
+<option value="2.8.0">2.8.0</option>
+<option value="2.7.0">2.7.0</option>
+<option value="2.6.0">2.6.0</option>
+<option value="2.5.0">2.5.0</option>
+<option value="2.4.0">2.4.0</option>
+<option value="2.3.0">2.3.0</option>
+<option value="2.2.0">2.2.0</option>
+<option value="2.1.0">2.1.0</option>
+<option value="2.0.0">2.0.0</option>
+<option value="1.9.0">1.9.0</option>
+<option value="1.8.1">1.8.1</option>
+<option value="1.8.0">1.8.0</option>
+<option value="1.7.0">1.7.0</option>
+<option value="1.6.1">1.6.1</option>
+<option value="1.6.0">1.6.0</option>
+<option value="1.5.0">1.5.0</option>
+</optgroup>
+<optgroup label="French" value="fr"><option value="edge">edge</option></optgroup>
+<optgroup label="German" value="de"><option value="edge">edge</option></optgroup>
+<optgroup label="Italian" value="it"><option value="edge">edge</option></optgroup>
+<optgroup label="Japanese" value="ja">
+<option value="edge">edge</option>
+<option value="2.2.0">2.2.0</option>
+<option value="2.1.0">2.1.0</option>
+<option value="2.0.0">2.0.0</option>
+<option value="1.9.0">1.9.0</option>
+<option value="1.8.1">1.8.1</option>
+<option value="1.7.0">1.7.0</option>
+</optgroup>
+<optgroup label="Korean" value="ko">
+<option value="edge">edge</option>
+<option value="2.0.0">2.0.0</option>
+</optgroup>
+<optgroup label="Russian" value="ru"><option value="edge">edge</option></optgroup>
+<optgroup label="Spanish" value="es"><option value="edge">edge</option></optgroup></select></small>
+        </div>
+        <div id="subheader">
+            <h1>Android Plugins</h1>
+            <small><select><option value="Android%2520Plugins">Android Plugins</option>
+<option value="Android%20Plugins_plugin_class_mapping">      - Plugin Class Mapping</option>
+<option value="Android%20Plugins_writing_an_android_java_plugin">      - Writing an Android Java Plugin</option>
+<option value="Android%20Plugins_debugging_plugins">      - Debugging Plugins</option>
+<option value="Android%20Plugins_common_pitfalls">      - Common Pitfalls</option>
+<option value="Android%20Plugins_use_the_source">      - Use the Source</option></select></small>
+        </div>
+
+        <div id="sidebar">
+            <div class="vertical_divider"></div>
+        <h1>Guides</h1>
+<ul>
+<li><a href="guide_overview_index.md.html#Overview">Overview</a></li>
+<li><a href="guide_cli_index.md.html#The%20Command-line%20Interface">The Command-line Interface</a></li>
+<li><a href="guide_platforms_index.md.html#Platform%20Guides">Platform Guides</a></li>
+<li><a href="config_ref_index.md.html#The%20config.xml%20File">The config.xml File</a></li>
+<li><a href="guide_hybrid_webviews_index.md.html#Embedding%20WebViews">Embedding WebViews</a></li>
+<li><a href="guide_hybrid_plugins_index.md.html#Plugin%20Development%20Guide">Plugin Development Guide</a></li>
+<li><a href="guide_appdev_privacy_index.md.html#Privacy%20Guide">Privacy Guide</a></li>
+<li><a href="guide_appdev_whitelist_index.md.html#Domain%20Whitelist%20Guide">Domain Whitelist Guide</a></li>
+<li><a href="_index.html">Keyword Index</a></li>
+</ul>
+<h1>API Reference</h1>
+<ul>
+<li><a href="cordova_accelerometer_accelerometer.md.html#Accelerometer">Accelerometer</a></li>
+<li><a href="cordova_camera_camera.md.html#Camera">Camera</a></li>
+<li><a href="cordova_media_capture_capture.md.html#Capture">Capture</a></li>
+<li><a href="cordova_compass_compass.md.html#Compass">Compass</a></li>
+<li><a href="cordova_connection_connection.md.html#Connection">Connection</a></li>
+<li><a href="cordova_contacts_contacts.md.html#Contacts">Contacts</a></li>
+<li><a href="cordova_device_device.md.html#Device">Device</a></li>
+<li><a href="cordova_events_events.md.html#Events">Events</a></li>
+<li><a href="cordova_file_file.md.html#File">File</a></li>
+<li><a href="cordova_geolocation_geolocation.md.html#Geolocation">Geolocation</a></li>
+<li><a href="cordova_globalization_globalization.md.html#Globalization">Globalization</a></li>
+<li><a href="cordova_inappbrowser_inappbrowser.md.html#InAppBrowser">InAppBrowser</a></li>
+<li><a href="cordova_media_media.md.html#Media">Media</a></li>
+<li><a href="cordova_notification_notification.md.html#Notification">Notification</a></li>
+<li><a href="cordova_splashscreen_splashscreen.md.html#Splashscreen">Splashscreen</a></li>
+<li><a href="cordova_storage_storage.md.html#Storage">Storage</a></li>
+</ul>
+</div>
+
+        <div id="scrollable">
+            <div id="content">
+                <h1><a name="Android%20Plugins">Android Plugins</a></h1>
+
+<p>Writing a plugin requires an understanding of the architecture of
+Cordova-Android. Cordova-Android consists of an Android WebView with
+hooks attached to it. These plugins are represented as class mappings
+in the <code>config.xml</code> file.</p>
+
+<p>A plugin consists of at least one Java class that extends the
+<code>CordovaPlugin</code> class. A plugin must override one of the <code>execute</code>
+methods from <code>CordovaPlugin</code>.  As best practice, the plugin should
+handle <code><a href="cordova_events_events.md.html#pause">pause</a></code> and <code><a href="cordova_events_events.md.html#resume">resume</a></code> events, and any message passing between
+plugins.  Plugins with long-running requests, background activity such
+as media playback, listeners, or internal state should implement the
+<code>onReset()</code> method as well. It executes when the <code>WebView</code> navigates to
+a new page or refreshes, which reloads the JavaScript.</p>
+
+<h2>
+<a name="Android%20Plugins_plugin_class_mapping">Plugin Class Mapping</a>
+</h2>
+
+<p>The JavaScript portion of a plugin always uses the <code>cordova.exec</code> method as follows:</p>
+
+<pre class="prettyprint"><code>exec(&lt;successFunction&gt;, &lt;failFunction&gt;, &lt;service&gt;, &lt;action&gt;, [&lt;args&gt;]);
+</code></pre>
+
+<p>This marshals a request from the WebView to the Android native side,
+more or less boiling down to calling the <code>action</code> method on the
+<code>service</code> class, with the arguments passed in the <code>args</code> Array.</p>
+
+<p>Whether you distribute your plugin as Java file or as a JAR of its
+own, the plugin must be added to the <code>config.xml</code> file in your
+Cordova-Android application's <code>res/xml/</code> directory.</p>
+
+<pre class="prettyprint"><code>&lt;feature name="&lt;service_name&gt;"&gt;
+    &lt;param name="android-package" value="&lt;full_name_including_namespace&gt;" /&gt;
+&lt;/feature&gt;
+</code></pre>
+
+<p>The service name should match the one used in the JavaScript <code>exec</code>
+call, and the value is the Java classes full name, including the
+namespace.  Otherwise the plugin may compile but still be unreachable
+by Cordova.</p>
+
+<h2>
+<a name="Android%20Plugins_writing_an_android_java_plugin">Writing an Android Java Plugin</a>
+</h2>
+
+<p>JavaScript fires off a plugin request to the native side.  The Android
+Java plugin is mapped properly via the <code>config.xml</code> file.  So what
+does the final Android Java Plugin class look like?</p>
+
+<p>What gets dispatched to the plugin via JavaScript's <code>exec</code> function gets
+passed into the Plugin class's <code>execute</code> method. Most <code>execute</code>
+implementations look like this:</p>
+
+<pre class="prettyprint"><code>@Override
+public boolean execute(String action, JSONArray args, CallbackContext callbackContext) throws JSONException {
+    if ("beep".equals(action)) {
+        this.beep(args.getLong(0));
+        callbackContext.success();
+        return true;
+    }
+    return false;  // Returning false results in a "MethodNotFound" error.
+}
+</code></pre>
+
+<p>We compare the value of the <code>action</code> parameter, and dispatch the
+request off to a (private) method in the class, optionally passing
+some of the parameters to the method.</p>
+
+<p>When catching exceptions and returning errors, it's important for the
+sake of clarity that errors returned to JavaScript match Java's
+exception names as much as possible.</p>
+
+<h3>Threading</h3>
+
+<p>JavaScript in the WebView does <em>not</em> run on the UI thread. It runs on
+the WebCore thread. The <code>execute</code> method also runs on the WebCore thread.</p>
+
+<p>If you need to interact with the UI, you should use the following:</p>
+
+<pre class="prettyprint"><code>@Override
+public boolean execute(String action, JSONArray args, final CallbackContext callbackContext) throws JSONException {
+    if ("beep".equals(action)) {
+        final long duration = args.getLong(0);
+        cordova.getActivity().runOnUiThread(new Runnable() {
+            public void run() {
+                ...
+                callbackContext.success(); // Thread-safe.
+            }
+        });
+        return true;
+    }
+    return false;
+}
+</code></pre>
+
+<p>If you do not need to run on the UI thread, but do not want to block the WebCore thread:</p>
+
+<pre class="prettyprint"><code>@Override
+public boolean execute(String action, JSONArray args, final CallbackContext callbackContext) throws JSONException {
+    if ("beep".equals(action)) {
+        final long duration = args.getLong(0);
+        cordova.getThreadPool().execute(new Runnable() {
+            public void run() {
+                ...
+                callbackContext.success(); // Thread-safe.
+            }
+        });
+        return true;
+    }
+    return false;
+}
+</code></pre>
+
+<h3>Echo Android Plugin Example</h3>
+
+<p>Add the following to our <code>config.xml</code> file:</p>
+
+<pre class="prettyprint"><code>&lt;feature name="Echo"&gt;
+    &lt;param name="android-package" value="org.apache.cordova.plugin.Echo" /&gt;
+&lt;/feature&gt;
+</code></pre>
+
+<p>Then add the following file to
+<code>src/org/apache/cordova/plugin/Echo.java</code> inside our Cordova-Android
+application:</p>
+
+<pre class="prettyprint"><code>package org.apache.cordova.plugin;
+
+import org.apache.cordova.CordovaPlugin;
+import org.apache.cordova.CallbackContext;
+
+import org.json.JSONArray;
+import org.json.JSONException;
+import org.json.JSONObject;
+
+/**
+ * This class echoes a string called from JavaScript.
+ */
+public class Echo extends CordovaPlugin {
+
+    @Override
+    public boolean execute(String action, JSONArray args, CallbackContext callbackContext) throws JSONException {
+        if (action.equals("echo")) {
+            String message = args.getString(0);
+            this.echo(message, callbackContext);
+            return true;
+        }
+        return false;
+    }
+
+    private void echo(String message, CallbackContext callbackContext) {
+        if (message != null &amp;&amp; message.length() &gt; 0) {
+            callbackContext.success(message);
+        } else {
+            callbackContext.error("Expected one non-empty string argument.");
+        }
+    }
+}
+</code></pre>
+
+<p>Let's take a look at the code. The necessary <code>imports</code> are at
+the top. Our class extends from <code>CordovaPlugin</code>. We override the
+execute() method in order to recieve messages from exec(). Our method
+first compares against <code>action</code>: this plugin only supports one action,
+the <code>echo</code> action. Any other action returns <code>false</code>, which results in an
+error of type <code>INVALID_ACTION</code>, which translates into an error
+callback invocation on the JavaScript side. Next, we grab the echo
+string using the <code>getString</code> method on our <code>args</code>, telling it we want
+to get the 0th parameter in the parameter array. We do a bit of
+parameter checking: make sure it is not <code>null</code>, and make sure it is
+not a zero-length string. If it is, we call <code>callbackContext.error()</code>
+(which, by now, you should know invokes the error callback). If all of
+those checks pass, then we call <code>callbackContext.success()</code> and pass
+in the <code>message</code> string we received as a parameter. This finally
+translates into a success callback invocation on the JavaScript
+side. It also passes the <code>message</code> parameter as a parameter into the
+JavaScript success callback function.</p>
+
+<h2>
+<a name="Android%20Plugins_debugging_plugins">Debugging Plugins</a>
+</h2>
+
+<p>Eclipse can be used to debug an Android project, and the plugins can be debugged if the Java source is included in the project. Only the latest version of the Android Developer Tools is known to allow source code attachment to JAR dependencies, so this is not fully supported at this time.</p>
+
+<h2>
+<a name="Android%20Plugins_common_pitfalls">Common Pitfalls</a>
+</h2>
+
+<ul>
+<li><p>Plugins have access to a <code>CordovaInterface</code> object. This object has access to the Android <code>Activity</code> that is running the application. This is the <code>Context</code> required to launch
+a new Android <code>Intent</code>. The <code>CordovaInterface</code> allows plugins to start an <code>Activity</code> for a result, and to set the callback plugin for when the <code>Intent</code> comes back to the application. This is important, since the
+<code>Intent</code>s system is how Android communicates between processes.</p></li>
+<li><p>Plugins do not have direct access to the <code>Context</code> as they have in the past. The legacy <code>ctx</code> member is deprecated, and will be removed six months after 2.0 is released. All of <code>ctx</code> methods exist on the <code>Context</code>, so both <code>getContext()</code> and <code>getActivity()</code> are capable of returning the proper object required.</p></li>
+</ul>
+<h2>
+<a name="Android%20Plugins_use_the_source">Use the Source</a>
+</h2>
+
+<p>One of the best ways to prepare yourself to write your own plugin is to
+<a class="external" href="https://github.com/apache/cordova-android/tree/master/framework/src/org/apache/cordova">look over existing plugins</a>.</p>
+
+<p>You should also read through the comments in <a class="external" href="https://github.com/apache/cordova-android/blob/master/framework/src/org/apache/cordova/CordovaPlugin.java">CordovaPlugin.java</a>.</p>
+
+            </div>
+        </div>
+
+        <!-- Functionality and Syntax Highlighting -->
+        <script type="text/javascript" src="index.js"></script><script type="text/javascript" src="prettify/prettify.js"></script>
+</body>
+</html>

Added: cordova/site/public/docs/en/3.1.0/guide_platforms_android_tools.md.html
URL: http://svn.apache.org/viewvc/cordova/site/public/docs/en/3.1.0/guide_platforms_android_tools.md.html?rev=1527865&view=auto
==============================================================================
--- cordova/site/public/docs/en/3.1.0/guide_platforms_android_tools.md.html (added)
+++ cordova/site/public/docs/en/3.1.0/guide_platforms_android_tools.md.html Tue Oct  1 03:55:57 2013
@@ -0,0 +1,205 @@
+<!DOCTYPE html>
+<!--
+    Licensed to the Apache Software Foundation (ASF) under one
+    or more contributor license agreements.  See the NOTICE file
+    distributed with this work for additional information
+    regarding copyright ownership.  The ASF licenses this file
+    to you under the Apache License, Version 2.0 (the
+    "License"); you may not use this file except in compliance
+    with the License.  You may obtain a copy of the License at
+
+      http://www.apache.org/licenses/LICENSE-2.0
+
+    Unless required by applicable law or agreed to in writing,
+    software distributed under the License is distributed on an
+    "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+    KIND, either express or implied.  See the License for the
+    specific language governing permissions and limitations
+    under the License.
+--><html lang="en">
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
+<meta name="viewport" content="initial-scale=1.0, maximum-scale=1.0, user-scalable=no, width=device-width">
+<meta name="generator" content="joDoc">
+<title>Apache Cordova API Documentation</title>
+<link rel="stylesheet" type="text/css" href="index.css">
+<link rel="stylesheet" type="text/css" href="mobile.css" media="only screen and (max-device-width: 1024px)">
+<link rel="stylesheet" type="text/css" href="prettify/prettify.css">
+</head>
+<body>
+        <div id="header">
+            <h1><a href="index.html">Apache <strong>Cordova</strong> Documentation</a></h1>
+            <small>
+                <select><optgroup label="Chinese" value="zh"><option value="edge">edge</option></optgroup>
+<optgroup label="English" value="en">
+<option value="edge">edge</option>
+<option selected value="3.1.0">3.1.0</option>
+<option value="3.0.0">3.0.0</option>
+<option value="2.9.0">2.9.0</option>
+<option value="2.8.0">2.8.0</option>
+<option value="2.7.0">2.7.0</option>
+<option value="2.6.0">2.6.0</option>
+<option value="2.5.0">2.5.0</option>
+<option value="2.4.0">2.4.0</option>
+<option value="2.3.0">2.3.0</option>
+<option value="2.2.0">2.2.0</option>
+<option value="2.1.0">2.1.0</option>
+<option value="2.0.0">2.0.0</option>
+<option value="1.9.0">1.9.0</option>
+<option value="1.8.1">1.8.1</option>
+<option value="1.8.0">1.8.0</option>
+<option value="1.7.0">1.7.0</option>
+<option value="1.6.1">1.6.1</option>
+<option value="1.6.0">1.6.0</option>
+<option value="1.5.0">1.5.0</option>
+</optgroup>
+<optgroup label="French" value="fr"><option value="edge">edge</option></optgroup>
+<optgroup label="German" value="de"><option value="edge">edge</option></optgroup>
+<optgroup label="Italian" value="it"><option value="edge">edge</option></optgroup>
+<optgroup label="Japanese" value="ja">
+<option value="edge">edge</option>
+<option value="2.2.0">2.2.0</option>
+<option value="2.1.0">2.1.0</option>
+<option value="2.0.0">2.0.0</option>
+<option value="1.9.0">1.9.0</option>
+<option value="1.8.1">1.8.1</option>
+<option value="1.7.0">1.7.0</option>
+</optgroup>
+<optgroup label="Korean" value="ko">
+<option value="edge">edge</option>
+<option value="2.0.0">2.0.0</option>
+</optgroup>
+<optgroup label="Russian" value="ru"><option value="edge">edge</option></optgroup>
+<optgroup label="Spanish" value="es"><option value="edge">edge</option></optgroup></select></small>
+        </div>
+        <div id="subheader">
+            <h1>Android Command-line Tools</h1>
+            <small><select><option value="Android%2520Command-line%2520Tools">Android Command-line Tools</option>
+<option value="Android%20Command-line%20Tools_create_a_project">      - Create a project</option>
+<option value="Android%20Command-line%20Tools_build">      - Build</option>
+<option value="Android%20Command-line%20Tools_run_the_app">      - Run the App</option>
+<option value="Android%20Command-line%20Tools_logging">      - Logging</option></select></small>
+        </div>
+
+        <div id="sidebar">
+            <div class="vertical_divider"></div>
+        <h1>Guides</h1>
+<ul>
+<li><a href="guide_overview_index.md.html#Overview">Overview</a></li>
+<li><a href="guide_cli_index.md.html#The%20Command-line%20Interface">The Command-line Interface</a></li>
+<li><a href="guide_platforms_index.md.html#Platform%20Guides">Platform Guides</a></li>
+<li><a href="config_ref_index.md.html#The%20config.xml%20File">The config.xml File</a></li>
+<li><a href="guide_hybrid_webviews_index.md.html#Embedding%20WebViews">Embedding WebViews</a></li>
+<li><a href="guide_hybrid_plugins_index.md.html#Plugin%20Development%20Guide">Plugin Development Guide</a></li>
+<li><a href="guide_appdev_privacy_index.md.html#Privacy%20Guide">Privacy Guide</a></li>
+<li><a href="guide_appdev_whitelist_index.md.html#Domain%20Whitelist%20Guide">Domain Whitelist Guide</a></li>
+<li><a href="_index.html">Keyword Index</a></li>
+</ul>
+<h1>API Reference</h1>
+<ul>
+<li><a href="cordova_accelerometer_accelerometer.md.html#Accelerometer">Accelerometer</a></li>
+<li><a href="cordova_camera_camera.md.html#Camera">Camera</a></li>
+<li><a href="cordova_media_capture_capture.md.html#Capture">Capture</a></li>
+<li><a href="cordova_compass_compass.md.html#Compass">Compass</a></li>
+<li><a href="cordova_connection_connection.md.html#Connection">Connection</a></li>
+<li><a href="cordova_contacts_contacts.md.html#Contacts">Contacts</a></li>
+<li><a href="cordova_device_device.md.html#Device">Device</a></li>
+<li><a href="cordova_events_events.md.html#Events">Events</a></li>
+<li><a href="cordova_file_file.md.html#File">File</a></li>
+<li><a href="cordova_geolocation_geolocation.md.html#Geolocation">Geolocation</a></li>
+<li><a href="cordova_globalization_globalization.md.html#Globalization">Globalization</a></li>
+<li><a href="cordova_inappbrowser_inappbrowser.md.html#InAppBrowser">InAppBrowser</a></li>
+<li><a href="cordova_media_media.md.html#Media">Media</a></li>
+<li><a href="cordova_notification_notification.md.html#Notification">Notification</a></li>
+<li><a href="cordova_splashscreen_splashscreen.md.html#Splashscreen">Splashscreen</a></li>
+<li><a href="cordova_storage_storage.md.html#Storage">Storage</a></li>
+</ul>
+</div>
+
+        <div id="scrollable">
+            <div id="content">
+                <h1><a name="Android%20Command-line%20Tools">Android Command-line Tools</a></h1>
+
+<p>The <code>cordova</code> command-line utility is a high-level tool that allows
+you to build applications across several platforms at once. An older
+version of the Cordova framework provides sets of command-line tools
+specific to each platform. To use them as an alternative to the CLI,
+you need to download this version of Cordova from
+<a class="external" href="http://cordova.apache.org">cordova.apache.org</a>. The download contains
+separate archives for each platform. Expand the platform you wish to
+target. The tools described here are typically available in the
+top-level <code>bin</code> directory, otherwise consult the <strong>README</strong> file for
+more detailed directions.</p>
+
+<h2>
+<a name="Android%20Command-line%20Tools_create_a_project">Create a project</a>
+</h2>
+
+<p>Run the <code>create</code> command, specifying the existing path to the project,
+the reverse-domain-style package identifier, and the app's display
+name.  Here is the syntax for both Mac and Windows:</p>
+
+<pre class="prettyprint"><code>$ /path/to/cordova-android/bin/create /path/to/project com.example.project_name ProjectName
+$ C:\path\to\cordova-android\bin\create.bat C:\path\to\project com.example.project_name ProjectName
+</code></pre>
+
+<h2>
+<a name="Android%20Command-line%20Tools_build">Build</a>
+</h2>
+
+<p>This cleans then builds a project.</p>
+
+<p>Debug, on Mac or Windows:</p>
+
+<pre class="prettyprint"><code>$ /path/to/project/cordova/build --debug
+$ C:\path\to\project\cordova\build.bat --debug
+</code></pre>
+
+<p>Release, on Mac or Windows:</p>
+
+<pre class="prettyprint"><code>$ /path/to/project/cordova/build --release
+$ C:\path\to\project\cordova\build.bat --release
+</code></pre>
+
+<h2>
+<a name="Android%20Command-line%20Tools_run_the_app">Run the App</a>
+</h2>
+
+<p>The <code>run</code> command accepts the following <em>optional</em> parameters:</p>
+
+<ul>
+<li><p>Target specification. This includes <code>--emulator</code>, <code>--device</code>, or <code>--target=&lt;targetID&gt;</code>.</p></li>
+<li>
+<p>Build specification. This includes <code>--debug</code>, <code>--release</code>, or <code>--nobuild</code>.</p>
+
+<p>$ /path/to/project/cordova/run [Target] [Build]
+$ C:\path\to\project\cordova\run.bat [Target] [Build]</p>
+</li>
+</ul>
+<p>Make sure you create at least one Android Virtual <a href="cordova_device_device.md.html#Device">Device</a>, otherwise
+you're prompted to do so with the <code>android</code> command.  If more than one
+AVD is available as a target, you're prompted to select one. By
+default the <code>run</code> command detects a connected device, or a currently
+running emulator if no device is found.</p>
+
+<h2>
+<a name="Android%20Command-line%20Tools_logging">Logging</a>
+</h2>
+
+<pre class="prettyprint"><code>$ /path/to/project/cordova/log
+$ C:\path\to\project\cordova\log.bat
+</code></pre>
+
+<h3>Cleaning</h3>
+
+<pre class="prettyprint"><code>$ /path/to/project/cordova/clean
+$ C:\path\to\project\cordova\clean.bat
+</code></pre>
+
+            </div>
+        </div>
+
+        <!-- Functionality and Syntax Highlighting -->
+        <script type="text/javascript" src="index.js"></script><script type="text/javascript" src="prettify/prettify.js"></script>
+</body>
+</html>

Added: cordova/site/public/docs/en/3.1.0/guide_platforms_android_upgrading.md.html
URL: http://svn.apache.org/viewvc/cordova/site/public/docs/en/3.1.0/guide_platforms_android_upgrading.md.html?rev=1527865&view=auto
==============================================================================
--- cordova/site/public/docs/en/3.1.0/guide_platforms_android_upgrading.md.html (added)
+++ cordova/site/public/docs/en/3.1.0/guide_platforms_android_upgrading.md.html Tue Oct  1 03:55:57 2013
@@ -0,0 +1,506 @@
+<!DOCTYPE html>
+<!--
+    Licensed to the Apache Software Foundation (ASF) under one
+    or more contributor license agreements.  See the NOTICE file
+    distributed with this work for additional information
+    regarding copyright ownership.  The ASF licenses this file
+    to you under the Apache License, Version 2.0 (the
+    "License"); you may not use this file except in compliance
+    with the License.  You may obtain a copy of the License at
+
+      http://www.apache.org/licenses/LICENSE-2.0
+
+    Unless required by applicable law or agreed to in writing,
+    software distributed under the License is distributed on an
+    "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+    KIND, either express or implied.  See the License for the
+    specific language governing permissions and limitations
+    under the License.
+--><html lang="en">
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
+<meta name="viewport" content="initial-scale=1.0, maximum-scale=1.0, user-scalable=no, width=device-width">
+<meta name="generator" content="joDoc">
+<title>Apache Cordova API Documentation</title>
+<link rel="stylesheet" type="text/css" href="index.css">
+<link rel="stylesheet" type="text/css" href="mobile.css" media="only screen and (max-device-width: 1024px)">
+<link rel="stylesheet" type="text/css" href="prettify/prettify.css">
+</head>
+<body>
+        <div id="header">
+            <h1><a href="index.html">Apache <strong>Cordova</strong> Documentation</a></h1>
+            <small>
+                <select><optgroup label="Chinese" value="zh"><option value="edge">edge</option></optgroup>
+<optgroup label="English" value="en">
+<option value="edge">edge</option>
+<option selected value="3.1.0">3.1.0</option>
+<option value="3.0.0">3.0.0</option>
+<option value="2.9.0">2.9.0</option>
+<option value="2.8.0">2.8.0</option>
+<option value="2.7.0">2.7.0</option>
+<option value="2.6.0">2.6.0</option>
+<option value="2.5.0">2.5.0</option>
+<option value="2.4.0">2.4.0</option>
+<option value="2.3.0">2.3.0</option>
+<option value="2.2.0">2.2.0</option>
+<option value="2.1.0">2.1.0</option>
+<option value="2.0.0">2.0.0</option>
+<option value="1.9.0">1.9.0</option>
+<option value="1.8.1">1.8.1</option>
+<option value="1.8.0">1.8.0</option>
+<option value="1.7.0">1.7.0</option>
+<option value="1.6.1">1.6.1</option>
+<option value="1.6.0">1.6.0</option>
+<option value="1.5.0">1.5.0</option>
+</optgroup>
+<optgroup label="French" value="fr"><option value="edge">edge</option></optgroup>
+<optgroup label="German" value="de"><option value="edge">edge</option></optgroup>
+<optgroup label="Italian" value="it"><option value="edge">edge</option></optgroup>
+<optgroup label="Japanese" value="ja">
+<option value="edge">edge</option>
+<option value="2.2.0">2.2.0</option>
+<option value="2.1.0">2.1.0</option>
+<option value="2.0.0">2.0.0</option>
+<option value="1.9.0">1.9.0</option>
+<option value="1.8.1">1.8.1</option>
+<option value="1.7.0">1.7.0</option>
+</optgroup>
+<optgroup label="Korean" value="ko">
+<option value="edge">edge</option>
+<option value="2.0.0">2.0.0</option>
+</optgroup>
+<optgroup label="Russian" value="ru"><option value="edge">edge</option></optgroup>
+<optgroup label="Spanish" value="es"><option value="edge">edge</option></optgroup></select></small>
+        </div>
+        <div id="subheader">
+            <h1>Upgrading Android</h1>
+            <small><select><option value="Upgrading%2520Android">Upgrading Android</option>
+<option value="Upgrading%20Android_upgrading_to_3_1_0_from_3_0_0">      - Upgrading to 3.1.0 from 3.0.0</option>
+<option value="Upgrading%20Android_upgrade_to_the_cli_3_0_0_from_2_9_0">      - Upgrade to the CLI (3.0.0) from 2.9.0</option>
+<option value="Upgrading%20Android_upgrade_to_3_0_0_from_2_9_0">      - Upgrade to 3.0.0 from 2.9.0</option>
+<option value="Upgrading%20Android_upgrade_to_2_9_0_from_2_8_0">      - Upgrade to 2.9.0 from 2.8.0</option>
+<option value="Upgrading%20Android_upgrade_to_2_8_0_from_2_7_0">      - Upgrade to 2.8.0 from 2.7.0</option>
+<option value="Upgrading%20Android_upgrade_to_2_7_0_from_2_6_0">      - Upgrade to 2.7.0 from 2.6.0</option>
+<option value="Upgrading%20Android_upgrade_to_2_6_0_from_2_5_0">      - Upgrade to 2.6.0 from 2.5.0</option>
+<option value="Upgrading%20Android_upgrade_to_2_5_0_from_2_4_0">      - Upgrade to 2.5.0 from 2.4.0</option>
+<option value="Upgrading%20Android_upgrade_to_2_4_0_from_2_3_0">      - Upgrade to 2.4.0 from 2.3.0</option>
+<option value="Upgrading%20Android_upgrade_to_2_3_0_from_2_2_0">      - Upgrade to 2.3.0 from 2.2.0</option>
+<option value="Upgrading%20Android_upgrade_to_2_2_0_from_2_1_0">      - Upgrade to 2.2.0 from 2.1.0</option>
+<option value="Upgrading%20Android_upgrade_to_2_1_0_from_2_0_0">      - Upgrade to 2.1.0 from 2.0.0</option>
+<option value="Upgrading%20Android_upgrade_to_2_0_0_from_1_9_0">      - Upgrade to 2.0.0 from 1.9.0</option>
+<option value="Upgrading%20Android_upgrade_to_1_9_0_from_1_8_1">      - Upgrade to 1.9.0 from 1.8.1</option>
+<option value="Upgrading%20Android_upgrade_to_1_8_0_from_1_8_0">      - Upgrade to 1.8.0 from 1.8.0</option>
+<option value="Upgrading%20Android_upgrade_to_1_8_0_from_1_7_0">      - Upgrade to 1.8.0 from 1.7.0</option>
+<option value="Upgrading%20Android_upgrade_to_1_8_0_from_1_7_0">      - Upgrade to 1.8.0 from 1.7.0</option>
+<option value="Upgrading%20Android_upgrade_to_1_7_0_from_1_6_1">      - Upgrade to 1.7.0 from 1.6.1</option>
+<option value="Upgrading%20Android_upgrade_to_1_6_1_from_1_6_0">      - Upgrade to 1.6.1 from 1.6.0</option>
+<option value="Upgrading%20Android_upgrade_to_1_6_0_from_1_5_0">      - Upgrade to 1.6.0 from 1.5.0</option>
+<option value="Upgrading%20Android_upgrade_to_1_5_0_from_1_4_0">      - Upgrade to 1.5.0 from 1.4.0</option>
+<option value="Upgrading%20Android_upgrade_to_1_4_0_from_1_3_0">      - Upgrade to 1.4.0 from 1.3.0</option>
+<option value="Upgrading%20Android_upgrade_to_1_3_0_from_1_2_0">      - Upgrade to 1.3.0 from 1.2.0</option>
+<option value="Upgrading%20Android_upgrade_to_1_2_0_from_1_1_0">      - Upgrade to 1.2.0 from 1.1.0</option>
+<option value="Upgrading%20Android_upgrade_to_1_1_0_from_1_0_0">      - Upgrade to 1.1.0 from 1.0.0</option>
+<option value="Upgrading%20Android_upgrade_to_1_0_0_from_0_9_6">      - Upgrade to 1.0.0 from 0.9.6</option></select></small>
+        </div>
+
+        <div id="sidebar">
+            <div class="vertical_divider"></div>
+        <h1>Guides</h1>
+<ul>
+<li><a href="guide_overview_index.md.html#Overview">Overview</a></li>
+<li><a href="guide_cli_index.md.html#The%20Command-line%20Interface">The Command-line Interface</a></li>
+<li><a href="guide_platforms_index.md.html#Platform%20Guides">Platform Guides</a></li>
+<li><a href="config_ref_index.md.html#The%20config.xml%20File">The config.xml File</a></li>
+<li><a href="guide_hybrid_webviews_index.md.html#Embedding%20WebViews">Embedding WebViews</a></li>
+<li><a href="guide_hybrid_plugins_index.md.html#Plugin%20Development%20Guide">Plugin Development Guide</a></li>
+<li><a href="guide_appdev_privacy_index.md.html#Privacy%20Guide">Privacy Guide</a></li>
+<li><a href="guide_appdev_whitelist_index.md.html#Domain%20Whitelist%20Guide">Domain Whitelist Guide</a></li>
+<li><a href="_index.html">Keyword Index</a></li>
+</ul>
+<h1>API Reference</h1>
+<ul>
+<li><a href="cordova_accelerometer_accelerometer.md.html#Accelerometer">Accelerometer</a></li>
+<li><a href="cordova_camera_camera.md.html#Camera">Camera</a></li>
+<li><a href="cordova_media_capture_capture.md.html#Capture">Capture</a></li>
+<li><a href="cordova_compass_compass.md.html#Compass">Compass</a></li>
+<li><a href="cordova_connection_connection.md.html#Connection">Connection</a></li>
+<li><a href="cordova_contacts_contacts.md.html#Contacts">Contacts</a></li>
+<li><a href="cordova_device_device.md.html#Device">Device</a></li>
+<li><a href="cordova_events_events.md.html#Events">Events</a></li>
+<li><a href="cordova_file_file.md.html#File">File</a></li>
+<li><a href="cordova_geolocation_geolocation.md.html#Geolocation">Geolocation</a></li>
+<li><a href="cordova_globalization_globalization.md.html#Globalization">Globalization</a></li>
+<li><a href="cordova_inappbrowser_inappbrowser.md.html#InAppBrowser">InAppBrowser</a></li>
+<li><a href="cordova_media_media.md.html#Media">Media</a></li>
+<li><a href="cordova_notification_notification.md.html#Notification">Notification</a></li>
+<li><a href="cordova_splashscreen_splashscreen.md.html#Splashscreen">Splashscreen</a></li>
+<li><a href="cordova_storage_storage.md.html#Storage">Storage</a></li>
+</ul>
+</div>
+
+        <div id="scrollable">
+            <div id="content">
+                <h1><a name="Upgrading%20Android">Upgrading Android</a></h1>
+
+<p>This guide shows how to modify Android projects to upgrade from older versions of Cordova.
+Most of these instructions apply to projects created with an older set
+of command-line tools that precede the <code>cordova</code> CLI utility. See <a href="guide_cli_index.md.html#The%20Command-line%20Interface">The Command-line Interface</a> for information how to update the
+version of the CLI.</p>
+
+<h2>
+<a name="Upgrading%20Android_upgrading_to_3_1_0_from_3_0_0">Upgrading to 3.1.0 from 3.0.0</a>
+</h2>
+
+<p>For projects that were created with the cordova CLI: </p>
+
+<ol>
+<li>Update the <code>cordova</code> CLI version - see <a href="guide_cli_index.md.html#The%20Command-line%20Interface">The Command-line Interface</a> </li>
+<li>Run <code>cordova platform update android</code>
+</li>
+</ol>
+<p>For projects not created with the cordova CLI, run:</p>
+
+<ol>
+<li><code>bin/update &lt;project_path&gt;</code></li>
+</ol>
+<h2>
+<a name="Upgrading%20Android_upgrade_to_the_cli_3_0_0_from_2_9_0">Upgrade to the CLI (3.0.0) from 2.9.0</a>
+</h2>
+
+<ol>
+<li><p>Create a new Apache Cordova 3.0.0 project using the cordova CLI, as
+described in <a href="guide_cli_index.md.html#The%20Command-line%20Interface">The Command-line Interface</a>.</p></li>
+<li><p>Add your platforms the the cordova project, for example: <code>cordova
+platform add android</code>.</p></li>
+<li><p>Copy the contents of your project's <code>www</code> directory to the <code>www</code> directory
+at the root of the cordova project you just created.</p></li>
+<li><p>Copy any native assets from your old project into the appropriate
+directories under <code>platforms/android</code>: this directory is where your
+native cordova-android project exists.</p></li>
+<li><p>Use the cordova CLI tool to install any plugins you need. Note that
+the CLI handles all core APIs as plugins, so they may need to be
+added. Only 3.0.0 plugins are compatible with the CLI.</p></li>
+</ol>
+<h2>
+<a name="Upgrading%20Android_upgrade_to_3_0_0_from_2_9_0">Upgrade to 3.0.0 from 2.9.0</a>
+</h2>
+
+<ol>
+<li><p>Create a new Apache Cordova Android project.</p></li>
+<li><p>Copy the contents of your <code>www</code> directory to the new project.</p></li>
+<li><p>Copy any native Android assets from your <code>res</code> directory to the new project.</p></li>
+<li><p>Copy over any plugins you installed from the <code>src</code> subdirectories into the new project.</p></li>
+<li><p>Make sure to upgrade any deprecated <code>&lt;plugin&gt;</code> references from your old <code>config.xml</code> file to the new <code>&lt;feature&gt;</code> specification.</p></li>
+<li><p>Update any references to the <code>org.apache.cordova.api</code> package to be <code>org.apache.cordova</code>.</p></li>
+<li><p><strong>NOTE:</strong> all core APIs have been removed and must be installed as plugins. Please see the <a href="plugin_ref_plugman.md.html#Using%20Plugman%20to%20Manage%20Plugins">Using Plugman to Manage Plugins</a> Guide for details.</p></li>
+</ol>
+<h2>
+<a name="Upgrading%20Android_upgrade_to_2_9_0_from_2_8_0">Upgrade to 2.9.0 from 2.8.0</a>
+</h2>
+
+<ol>
+<li>Run <code>bin/update &lt;project_path&gt;</code>.</li>
+</ol>
+<h2>
+<a name="Upgrading%20Android_upgrade_to_2_8_0_from_2_7_0">Upgrade to 2.8.0 from 2.7.0</a>
+</h2>
+
+<ol>
+<li><p>Remove <code>cordova-2.7.0.jar</code> from the project's <code>libs</code> directory.</p></li>
+<li><p>Add <code>cordova-2.8.0.jar</code> to the project's <code>libs</code> directory.</p></li>
+<li><p>If you are using Eclipse, please refresh your eclipse project and do a clean.</p></li>
+<li><p>Copy the new <code>cordova.js</code> into your project.</p></li>
+<li><p>Update your HTML to use the new <code>cordova.js</code> file.</p></li>
+<li><p>Copy the <code>res/xml/config.xml</code> file to match <code>framework/res/xml/config.xml</code>.</p></li>
+<li><p>Update <code>framework/res/xml/config.xml</code> to have similar settings as it did previously.</p></li>
+<li><p>Copy files from <code>bin/templates/cordova</code> to the project's <code>cordova</code> directory.</p></li>
+</ol>
+<h2>
+<a name="Upgrading%20Android_upgrade_to_2_7_0_from_2_6_0">Upgrade to 2.7.0 from 2.6.0</a>
+</h2>
+
+<ol>
+<li><p>Remove <code>cordova-2.6.0.jar</code> from the project's <code>libs</code> directory.</p></li>
+<li><p>Add <code>cordova-2.7.0.jar</code> to the project's <code>libs</code> directory.</p></li>
+<li><p>If you are using Eclipse, please refresh your eclipse project and do a clean.</p></li>
+<li><p>Copy the new <code>cordova-2.7.0.js</code> into your project.</p></li>
+<li><p>Update your HTML to use the new <code>cordova-2.7.0.js</code> file.</p></li>
+<li><p>Copy the <code>res/xml/config.xml</code> to match <code>framework/res/xml/config.xml</code>.</p></li>
+<li><p>Update <code>framework/res/xml/config.xml</code> to have similar settings as it did previously.</p></li>
+<li><p>Copy files from <code>bin/templates/cordova</code> to the project's <code>cordova</code> directory.</p></li>
+</ol>
+<h2>
+<a name="Upgrading%20Android_upgrade_to_2_6_0_from_2_5_0">Upgrade to 2.6.0 from 2.5.0</a>
+</h2>
+
+<ol>
+<li><p>Remove <code>cordova-2.5.0.jar</code> from the project's <code>libs</code> directory.</p></li>
+<li><p>Add <code>cordova-2.6.0.jar</code> to the project's <code>libs</code> directory.</p></li>
+<li><p>If you are using Eclipse, please refresh your eclipse project and do a clean.</p></li>
+<li><p>Copy the new <code>cordova-2.6.0.js</code> into your project.</p></li>
+<li><p>Update your HTML to use the new <code>cordova-2.6.0.js</code> file.</p></li>
+<li><p>Copy the <code>res/xml/config.xml</code> to match <code>framework/res/xml/config.xml</code>.</p></li>
+<li><p>Update <code>framework/res/xml/config.xml</code> to have similar settings as it did previously.</p></li>
+<li><p>Copy files from <code>bin/templates/cordova</code> to the project's <code>cordova</code> directory.</p></li>
+</ol>
+<p>Run <code>bin/update &lt;project&gt;</code> with the project path listed in the Cordova Source directory.</p>
+
+<h2>
+<a name="Upgrading%20Android_upgrade_to_2_5_0_from_2_4_0">Upgrade to 2.5.0 from 2.4.0</a>
+</h2>
+
+<ol>
+<li><p>Remove <code>cordova-2.4.0.jar</code> from the project's <code>libs</code> directory.</p></li>
+<li><p>Add <code>cordova-2.5.0.jar</code> to the project's <code>libs</code> directory.</p></li>
+<li><p>If you are using Eclipse, please refresh your eclipse project and do a clean.</p></li>
+<li><p>Copy the new <code>cordova-2.5.0.js</code> into your project.</p></li>
+<li><p>Update your HTML to use the new <code>cordova-2.5.0.js</code> file.</p></li>
+<li><p>Copy the <code>res/xml/config.xml</code> to match <code>framework/res/xml/config.xml</code>.</p></li>
+<li><p>Update <code>framework/res/xml/config.xml</code> to have similar settings as it did previously.</p></li>
+<li><p>Copy files from <code>bin/templates/cordova</code> to the project's <code>cordova</code> directory.</p></li>
+</ol>
+<h2>
+<a name="Upgrading%20Android_upgrade_to_2_4_0_from_2_3_0">Upgrade to 2.4.0 from 2.3.0</a>
+</h2>
+
+<ol>
+<li><p>Remove <code>cordova-2.3.0.jar</code> from the project's <code>libs</code> directory.</p></li>
+<li><p>Add <code>cordova-2.4.0.jar</code> to the project's <code>libs</code> directory.</p></li>
+<li><p>If you are using Eclipse, please refresh your eclipse project and do a clean.</p></li>
+<li><p>Copy the new <code>cordova-2.4.0.js</code> into your project.</p></li>
+<li><p>Update your HTML to use the new <code>cordova-2.4.0.js</code> file.</p></li>
+<li><p>Copy the <code>res/xml/config.xml</code> to match <code>framework/res/xml/config.xml</code>.</p></li>
+<li><p>Copy files from <code>bin/templates/cordova</code> to the project's <code>cordova</code> directory.</p></li>
+</ol>
+<h2>
+<a name="Upgrading%20Android_upgrade_to_2_3_0_from_2_2_0">Upgrade to 2.3.0 from 2.2.0</a>
+</h2>
+
+<ol>
+<li><p>Remove <code>cordova-2.2.0.jar</code> from the project's <code>libs</code> directory.</p></li>
+<li><p>Add <code>cordova-2.3.0.jar</code> to the project's <code>libs</code> directory.</p></li>
+<li><p>If you are using Eclipse, please refresh your eclipse project and do a clean.</p></li>
+<li><p>Copy the new <code>cordova-2.3.0.js</code> into your project.</p></li>
+<li><p>Update your HTML to use the new <code>cordova-2.3.0.js</code> file.</p></li>
+<li><p>Copy the <code>res/xml/config.xml</code> to match <code>framework/res/xml/config.xml</code>.</p></li>
+<li><p>Copy files from <code>bin/templates/cordova</code> to the project's <code>cordova</code> directory.</p></li>
+</ol>
+<h2>
+<a name="Upgrading%20Android_upgrade_to_2_2_0_from_2_1_0">Upgrade to 2.2.0 from 2.1.0</a>
+</h2>
+
+<ol>
+<li><p>Remove <code>cordova-2.1.0.jar</code> from the project's <code>libs</code> directory.</p></li>
+<li><p>Add <code>cordova-2.2.0.jar</code> to the project's <code>libs</code> directory.</p></li>
+<li><p>If you are using Eclipse, please refresh your eclipse project and do a clean.</p></li>
+<li><p>Copy the new <code>cordova-2.2.0.js</code> into your project.</p></li>
+<li><p>Update your HTML to use the new <code>cordova-2.2.0.js</code> file.</p></li>
+<li><p>Copy the <code>res/xml/config.xml</code> to match <code>framework/res/xml/config.xml</code>.</p></li>
+<li><p>Copy files from <code>bin/templates/cordova</code> to the project's <code>cordova</code> directory.</p></li>
+</ol>
+<h2>
+<a name="Upgrading%20Android_upgrade_to_2_1_0_from_2_0_0">Upgrade to 2.1.0 from 2.0.0</a>
+</h2>
+
+<ol>
+<li><p>Remove <code>cordova-2.0.0.jar</code> from the project's <code>libs</code> directory.</p></li>
+<li><p>Add <code>cordova-2.1.0.jar</code> to the project's <code>libs</code> directory.</p></li>
+<li><p>If you are using Eclipse, please refresh your eclipse project and do a clean.</p></li>
+<li><p>Copy the new <code>cordova-2.1.0.js</code> into your project.</p></li>
+<li><p>Update your HTML to use the new <code>cordova-2.1.0.js</code> file.</p></li>
+<li><p>Copy the <code>res/xml/config.xml</code> to match <code>framework/res/xml/config.xml</code>.</p></li>
+<li><p>Copy files from <code>bin/templates/cordova</code> to the project's <code>cordova</code> directory.</p></li>
+</ol>
+<h2>
+<a name="Upgrading%20Android_upgrade_to_2_0_0_from_1_9_0">Upgrade to 2.0.0 from 1.9.0</a>
+</h2>
+
+<ol>
+<li><p>Remove <code>cordova-1.9.0.jar</code> from the project's <code>libs</code> directory.</p></li>
+<li><p>Add <code>cordova-2.0.0.jar</code> to the project's <code>libs</code> directory.</p></li>
+<li><p>If you are using Eclipse, please refresh your eclipse project and do a clean.</p></li>
+<li><p>Copy the new <code>cordova-2.0.0.js</code> into your project.</p></li>
+<li><p>Update your HTML to use the new <code>cordova-2.0.0.js</code> file.</p></li>
+<li><p>Copy the <code>res/xml/config.xml</code> to match <code>framework/res/xml/config.xml</code>.</p></li>
+</ol>
+<h3>Notes about 2.0.0 release</h3>
+
+<p><code>config.xml</code> will be replacing <code>cordova.xml</code> and <code>plugins.xml</code>.  This
+new file is a combination of the previous two.  However, the old files
+are deprecated, and while currently still work, will cease working in
+a future release.</p>
+
+<h2>
+<a name="Upgrading%20Android_upgrade_to_1_9_0_from_1_8_1">Upgrade to 1.9.0 from 1.8.1</a>
+</h2>
+
+<ol>
+<li><p>Remove <code>cordova-1.8.0.jar</code> from the project's <code>libs</code> directory.</p></li>
+<li><p>Add <code>cordova-1.9.0.jar</code> to the project's <code>libs</code> directory.</p></li>
+<li><p>If you are using Eclipse, please refresh your eclipse project and do a clean.</p></li>
+<li><p>Copy the new <code>cordova-1.9.0.js</code> into your project.</p></li>
+<li><p>Update your HTML to use the new <code>cordova-1.9.0.js</code> file.</p></li>
+<li><p>Update <code>res/xml/plugins.xml</code> to match <code>framework/res/xml/plugins.xml</code>.</p></li>
+</ol>
+<h3>Notes about 1.9.0 release</h3>
+
+<p>Due to the introduction of the <code>CordovaWebView</code>, third-Party plugins
+may not work.  These plugins need to get a context from the
+<code>CordovaInterface</code> using <code>getContext()</code> or <code>getActivity()</code>.  If you
+are not an experienced Android developer, please contact the plugin
+maintainer and add this task to their bug tracker.</p>
+
+<h2>
+<a name="Upgrading%20Android_upgrade_to_1_8_0_from_1_8_0">Upgrade to 1.8.0 from 1.8.0</a>
+</h2>
+
+<ol>
+<li><p>Remove <code>cordova-1.8.0.jar</code> from the project's <code>libs</code> directory.</p></li>
+<li><p>Add <code>cordova-1.8.1.jar</code> to the project's <code>libs</code> directory.</p></li>
+<li><p>If you are using Eclipse, please refresh your eclipse project and do a clean.</p></li>
+<li><p>Copy the new <code>cordova-1.8.1.js</code> into your project.</p></li>
+<li><p>Update your HTML to use the new <code>cordova-1.8.1.js</code> file.</p></li>
+<li><p>Update <code>res/xml/plugins.xml</code> to match <code>framework/res/xml/plugins.xml</code>.</p></li>
+</ol>
+<h2>
+<a name="Upgrading%20Android_upgrade_to_1_8_0_from_1_7_0">Upgrade to 1.8.0 from 1.7.0</a>
+</h2>
+
+<ol>
+<li><p>Remove <code>cordova-1.7.0.jar</code> from the project's <code>libs</code> directory.</p></li>
+<li><p>Add <code>cordova-1.8.0.jar</code> to the project's <code>libs</code> directory.</p></li>
+<li><p>If you are using Eclipse, please refresh your eclipse project and do a clean.</p></li>
+<li><p>Copy the new <code>cordova-1.8.0.js</code> into your project.</p></li>
+<li><p>Update your HTML to use the new <code>cordova-1.8.0.js</code> file.</p></li>
+<li><p>Update <code>res/xml/plugins.xml</code> to match <code>framework/res/xml/plugins.xml</code>.</p></li>
+</ol>
+<h2>
+<a name="Upgrading%20Android_upgrade_to_1_8_0_from_1_7_0">Upgrade to 1.8.0 from 1.7.0</a>
+</h2>
+
+<ol>
+<li><p>Remove <code>cordova-1.7.0.jar</code> from the project's <code>libs</code> directory.</p></li>
+<li><p>Add <code>cordova-1.8.0.jar</code> to the project's <code>libs</code> directory.</p></li>
+<li><p>If you are using Eclipse, please refresh your eclipse project and do a clean.</p></li>
+<li><p>Copy the new <code>cordova-1.8.0.js</code> into your project.</p></li>
+<li><p>Update your HTML to use the new <code>cordova-1.8.0.js</code> file.</p></li>
+<li><p>Update <code>res/xml/plugins.xml</code> to match <code>framework/res/xml/plugins.xml</code>.</p></li>
+</ol>
+<h2>
+<a name="Upgrading%20Android_upgrade_to_1_7_0_from_1_6_1">Upgrade to 1.7.0 from 1.6.1</a>
+</h2>
+
+<ol>
+<li><p>Remove <code>cordova-1.6.1.jar</code> from the project's <code>libs</code> directory.</p></li>
+<li><p>Add <code>cordova-1.7.0.jar</code> to the project's <code>libs</code> directory.</p></li>
+<li><p>If you are using Eclipse, please refresh your eclipse project and do a clean.</p></li>
+<li><p>Copy the new <code>cordova-1.7.0.js</code> into your project.</p></li>
+<li><p>Update <code>res/xml/plugins.xml</code> to match <code>framework/res/xml/plugins.xml</code>.</p></li>
+</ol>
+<h2>
+<a name="Upgrading%20Android_upgrade_to_1_6_1_from_1_6_0">Upgrade to 1.6.1 from 1.6.0</a>
+</h2>
+
+<ol>
+<li><p>Remove <code>cordova-1.6.0.jar</code> from the project's <code>libs</code> directory.</p></li>
+<li><p>Add <code>cordova-1.6.1.jar</code> to the project's <code>libs</code> directory.</p></li>
+<li><p>If you are using Eclipse, please refresh your eclipse project and do a clean.</p></li>
+<li><p>Copy the new <code>cordova-1.6.1.js</code> into your project.</p></li>
+<li><p>Update <code>res/xml/plugins.xml</code> to match <code>framework/res/xml/plugins.xml</code>.</p></li>
+</ol>
+<h2>
+<a name="Upgrading%20Android_upgrade_to_1_6_0_from_1_5_0">Upgrade to 1.6.0 from 1.5.0</a>
+</h2>
+
+<ol>
+<li><p>Remove <code>cordova-1.5.0.jar</code> from the project's <code>libs</code> directory.</p></li>
+<li><p>Add <code>cordova-1.6.0.jar</code> to the project's <code>libs</code> directory.</p></li>
+<li><p>If you are using Eclipse, please refresh your eclipse project and do a clean.</p></li>
+<li><p>Copy the new <code>cordova-1.6.0.js</code> into your project.</p></li>
+<li><p>Update your HTML to use the new <code>cordova-1.6.0.js</code> file.</p></li>
+<li><p>Update <code>res/xml/plugins.xml</code> to match <code>framework/res/xml/plugins.xml</code>.</p></li>
+<li><p>Replace <code>res/xml/phonegap.xml</code> with <code>res/xml/cordova.xml</code> to match <code>framework/res/xml/cordova.xml</code>.</p></li>
+</ol>
+<h2>
+<a name="Upgrading%20Android_upgrade_to_1_5_0_from_1_4_0">Upgrade to 1.5.0 from 1.4.0</a>
+</h2>
+
+<ol>
+<li><p>Remove <code>phonegap-1.4.0.jar</code> from the project's <code>libs</code> directory.</p></li>
+<li><p>Add <code>cordova-1.5.0.jar</code> to the project's <code>libs</code> directory.</p></li>
+<li><p>If you are using Eclipse, please refresh your eclipse project and do a clean.</p></li>
+<li><p>Copy the new <code>cordova-1.5.0.js</code> into your project.</p></li>
+<li><p>Update your HTML to use the new <code>cordova-1.5.0.js</code> file.</p></li>
+<li><p>Update <code>res/xml/plugins.xml</code> to match <code>framework/res/xml/plugins.xml</code>.</p></li>
+<li><p>Replace <code>res/xml/phonegap.xml</code> with <code>res/xml/cordova.xml</code> to match <code>framework/res/xml/cordova.xml</code>.</p></li>
+</ol>
+<h2>
+<a name="Upgrading%20Android_upgrade_to_1_4_0_from_1_3_0">Upgrade to 1.4.0 from 1.3.0</a>
+</h2>
+
+<ol>
+<li><p>Remove <code>phonegap-1.3.0.jar</code> from the project's <code>libs</code> directory.</p></li>
+<li><p>Add <code>phonegap-1.4.0.jar</code> to the project's <code>libs</code> directory.</p></li>
+<li><p>If you are using Eclipse, please refresh your eclipse project and do a clean.</p></li>
+<li><p>Copy the new <code>phonegap-1.4.0.js</code> into your project.</p></li>
+<li><p>Update your HTML to use the new <code>phonegap-1.4.0.js</code> file.</p></li>
+<li><p>Update <code>res/xml/plugins.xml</code> to match <code>framework/res/xml/plugins.xml</code>.</p></li>
+<li><p>Update <code>res/xml/phonegap.xml</code> to match <code>framework/res/xml/phonegap.xml</code>.</p></li>
+</ol>
+<h2>
+<a name="Upgrading%20Android_upgrade_to_1_3_0_from_1_2_0">Upgrade to 1.3.0 from 1.2.0</a>
+</h2>
+
+<ol>
+<li><p>Remove <code>phonegap-1.2.0.jar</code> from the project's <code>libs</code> directory.</p></li>
+<li><p>Add <code>phonegap-1.3.0.jar</code> to the project's <code>libs</code> directory.</p></li>
+<li><p>If you are using Eclipse, please refresh your eclipse project and do a clean.</p></li>
+<li><p>Copy the new <code>phonegap-1.3.0.js</code> into your project.</p></li>
+<li><p>Update your HTML to use the new <code>phonegap-1.2.0.js</code> file.</p></li>
+<li><p>Update <code>res/xml/plugins.xml</code> to match <code>framework/res/xml/plugins.xml</code>.</p></li>
+<li><p>Update <code>res/xml/phonegap.xml</code> to match <code>framework/res/xml/phonegap.xml</code>.</p></li>
+</ol>
+<h2>
+<a name="Upgrading%20Android_upgrade_to_1_2_0_from_1_1_0">Upgrade to 1.2.0 from 1.1.0</a>
+</h2>
+
+<ol>
+<li><p>Remove <code>phonegap-1.1.0.jar</code> from the project's <code>libs</code> directory.</p></li>
+<li><p>Add <code>phonegap-1.2.0.jar</code> to the project's <code>libs</code> directory.</p></li>
+<li><p>If you are using Eclipse, please refresh your eclipse project and do a clean.</p></li>
+<li><p>Copy the new <code>phonegap-1.2.0.js</code> into your project.</p></li>
+<li><p>Update your HTML to use the new <code>phonegap-1.2.0.js</code> file.</p></li>
+<li><p>Update <code>res/xml/plugins.xml</code> to match <code>framework/res/xml/plugins.xml</code>.</p></li>
+<li><p>Update <code>res/xml/phonegap.xml</code> to match <code>framework/res/xml/phonegap.xml</code>.</p></li>
+</ol>
+<h2>
+<a name="Upgrading%20Android_upgrade_to_1_1_0_from_1_0_0">Upgrade to 1.1.0 from 1.0.0</a>
+</h2>
+
+<ol>
+<li><p>Remove <code>phonegap-1.0.0.jar</code> from the project's <code>libs</code> directory.</p></li>
+<li><p>Add <code>phonegap-1.1.0.jar</code> to the project's <code>libs</code> directory.</p></li>
+<li><p>If you are using Eclipse, please refresh your eclipse project and do a clean.</p></li>
+<li><p>Copy the new <code>phonegap-1.1.0.js</code> into your project.</p></li>
+<li><p>Update your HTML to use the new <code>phonegap-1.1.0.js</code> file.</p></li>
+<li><p>Update <code>res/xml/plugins.xml</code> to match <code>framework/res/xml/plugins.xml</code>.</p></li>
+</ol>
+<h2>
+<a name="Upgrading%20Android_upgrade_to_1_0_0_from_0_9_6">Upgrade to 1.0.0 from 0.9.6</a>
+</h2>
+
+<ol>
+<li><p>Remove <code>phonegap-0.9.6.jar</code> from the project's <code>libs</code> directory.</p></li>
+<li><p>Add <code>phonegap-1.0.0.jar</code> to the project's <code>libs</code> directory.</p></li>
+<li><p>If you are using Eclipse, please refresh your eclipse project and do a clean.</p></li>
+<li><p>Copy the new <code>phonegap-1.0.0.js</code> into your project.</p></li>
+<li><p>Update your HTML to use the new <code>phonegap-1.0.0.js</code> file.</p></li>
+<li><p>Add the <code>res/xml/plugins.xml</code> to match <code>framework/res/xml/plugins.xml</code>.</p></li>
+</ol>
+</div>
+        </div>
+
+        <!-- Functionality and Syntax Highlighting -->
+        <script type="text/javascript" src="index.js"></script><script type="text/javascript" src="prettify/prettify.js"></script>
+</body>
+</html>

Added: cordova/site/public/docs/en/3.1.0/guide_platforms_android_webview.md.html
URL: http://svn.apache.org/viewvc/cordova/site/public/docs/en/3.1.0/guide_platforms_android_webview.md.html?rev=1527865&view=auto
==============================================================================
--- cordova/site/public/docs/en/3.1.0/guide_platforms_android_webview.md.html (added)
+++ cordova/site/public/docs/en/3.1.0/guide_platforms_android_webview.md.html Tue Oct  1 03:55:57 2013
@@ -0,0 +1,239 @@
+<!DOCTYPE html>
+<!--
+    Licensed to the Apache Software Foundation (ASF) under one
+    or more contributor license agreements.  See the NOTICE file
+    distributed with this work for additional information
+    regarding copyright ownership.  The ASF licenses this file
+    to you under the Apache License, Version 2.0 (the
+    "License"); you may not use this file except in compliance
+    with the License.  You may obtain a copy of the License at
+
+      http://www.apache.org/licenses/LICENSE-2.0
+
+    Unless required by applicable law or agreed to in writing,
+    software distributed under the License is distributed on an
+    "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+    KIND, either express or implied.  See the License for the
+    specific language governing permissions and limitations
+    under the License.
+--><html lang="en">
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
+<meta name="viewport" content="initial-scale=1.0, maximum-scale=1.0, user-scalable=no, width=device-width">
+<meta name="generator" content="joDoc">
+<title>Apache Cordova API Documentation</title>
+<link rel="stylesheet" type="text/css" href="index.css">
+<link rel="stylesheet" type="text/css" href="mobile.css" media="only screen and (max-device-width: 1024px)">
+<link rel="stylesheet" type="text/css" href="prettify/prettify.css">
+</head>
+<body>
+        <div id="header">
+            <h1><a href="index.html">Apache <strong>Cordova</strong> Documentation</a></h1>
+            <small>
+                <select><optgroup label="Chinese" value="zh"><option value="edge">edge</option></optgroup>
+<optgroup label="English" value="en">
+<option value="edge">edge</option>
+<option selected value="3.1.0">3.1.0</option>
+<option value="3.0.0">3.0.0</option>
+<option value="2.9.0">2.9.0</option>
+<option value="2.8.0">2.8.0</option>
+<option value="2.7.0">2.7.0</option>
+<option value="2.6.0">2.6.0</option>
+<option value="2.5.0">2.5.0</option>
+<option value="2.4.0">2.4.0</option>
+<option value="2.3.0">2.3.0</option>
+<option value="2.2.0">2.2.0</option>
+<option value="2.1.0">2.1.0</option>
+<option value="2.0.0">2.0.0</option>
+<option value="1.9.0">1.9.0</option>
+<option value="1.8.1">1.8.1</option>
+<option value="1.8.0">1.8.0</option>
+<option value="1.7.0">1.7.0</option>
+<option value="1.6.1">1.6.1</option>
+<option value="1.6.0">1.6.0</option>
+<option value="1.5.0">1.5.0</option>
+</optgroup>
+<optgroup label="French" value="fr"><option value="edge">edge</option></optgroup>
+<optgroup label="German" value="de"><option value="edge">edge</option></optgroup>
+<optgroup label="Italian" value="it"><option value="edge">edge</option></optgroup>
+<optgroup label="Japanese" value="ja">
+<option value="edge">edge</option>
+<option value="2.2.0">2.2.0</option>
+<option value="2.1.0">2.1.0</option>
+<option value="2.0.0">2.0.0</option>
+<option value="1.9.0">1.9.0</option>
+<option value="1.8.1">1.8.1</option>
+<option value="1.7.0">1.7.0</option>
+</optgroup>
+<optgroup label="Korean" value="ko">
+<option value="edge">edge</option>
+<option value="2.0.0">2.0.0</option>
+</optgroup>
+<optgroup label="Russian" value="ru"><option value="edge">edge</option></optgroup>
+<optgroup label="Spanish" value="es"><option value="edge">edge</option></optgroup></select></small>
+        </div>
+        <div id="subheader">
+            <h1>Android WebViews</h1>
+            <small><select><option value="Android%2520WebViews">Android WebViews</option>
+<option value="Android%20WebViews_prerequisites">      - Prerequisites</option>
+<option value="Android%20WebViews_guide_to_using_cordovawebview_in_an_android_project">      - Guide to using CordovaWebView in an Android Project</option></select></small>
+        </div>
+
+        <div id="sidebar">
+            <div class="vertical_divider"></div>
+        <h1>Guides</h1>
+<ul>
+<li><a href="guide_overview_index.md.html#Overview">Overview</a></li>
+<li><a href="guide_cli_index.md.html#The%20Command-line%20Interface">The Command-line Interface</a></li>
+<li><a href="guide_platforms_index.md.html#Platform%20Guides">Platform Guides</a></li>
+<li><a href="config_ref_index.md.html#The%20config.xml%20File">The config.xml File</a></li>
+<li><a href="guide_hybrid_webviews_index.md.html#Embedding%20WebViews">Embedding WebViews</a></li>
+<li><a href="guide_hybrid_plugins_index.md.html#Plugin%20Development%20Guide">Plugin Development Guide</a></li>
+<li><a href="guide_appdev_privacy_index.md.html#Privacy%20Guide">Privacy Guide</a></li>
+<li><a href="guide_appdev_whitelist_index.md.html#Domain%20Whitelist%20Guide">Domain Whitelist Guide</a></li>
+<li><a href="_index.html">Keyword Index</a></li>
+</ul>
+<h1>API Reference</h1>
+<ul>
+<li><a href="cordova_accelerometer_accelerometer.md.html#Accelerometer">Accelerometer</a></li>
+<li><a href="cordova_camera_camera.md.html#Camera">Camera</a></li>
+<li><a href="cordova_media_capture_capture.md.html#Capture">Capture</a></li>
+<li><a href="cordova_compass_compass.md.html#Compass">Compass</a></li>
+<li><a href="cordova_connection_connection.md.html#Connection">Connection</a></li>
+<li><a href="cordova_contacts_contacts.md.html#Contacts">Contacts</a></li>
+<li><a href="cordova_device_device.md.html#Device">Device</a></li>
+<li><a href="cordova_events_events.md.html#Events">Events</a></li>
+<li><a href="cordova_file_file.md.html#File">File</a></li>
+<li><a href="cordova_geolocation_geolocation.md.html#Geolocation">Geolocation</a></li>
+<li><a href="cordova_globalization_globalization.md.html#Globalization">Globalization</a></li>
+<li><a href="cordova_inappbrowser_inappbrowser.md.html#InAppBrowser">InAppBrowser</a></li>
+<li><a href="cordova_media_media.md.html#Media">Media</a></li>
+<li><a href="cordova_notification_notification.md.html#Notification">Notification</a></li>
+<li><a href="cordova_splashscreen_splashscreen.md.html#Splashscreen">Splashscreen</a></li>
+<li><a href="cordova_storage_storage.md.html#Storage">Storage</a></li>
+</ul>
+</div>
+
+        <div id="scrollable">
+            <div id="content">
+                <h1><a name="Android%20WebViews">Android WebViews</a></h1>
+
+<p>Beginning in Cordova 1.9, with the assistance of the
+<code>CordovaActivity</code>, you can use Cordova as a component in a larger
+native Android application. Android refers to this component as the
+<code>CordovaWebView</code>. New Cordova-based applications from 1.9 onwards use
+the <code>CordovaWebView</code> as its main view, regardless of whether the
+legacy <code>CordovaActivity</code> approach is used.</p>
+
+<p>If you're unfamiliar with Android application development, please read
+the <a href="guide_platforms_android_index.md.html#Android%20Platform%20Guide">Android Platform Guide</a> to developing a Cordova Application before
+attempting to include a WebView. It's not the main way to author
+Android Cordova applications. These instructions are currently manual,
+but may be eventually be automated.</p>
+
+<h2>
+<a name="Android%20WebViews_prerequisites">Prerequisites</a>
+</h2>
+
+<ul>
+<li><p>Cordova 1.9 or greater</p></li>
+<li><p>Android SDK updated to the latest SDK</p></li>
+</ul>
+<h2>
+<a name="Android%20WebViews_guide_to_using_cordovawebview_in_an_android_project">Guide to using CordovaWebView in an Android Project</a>
+</h2>
+
+<ol>
+<li><p><code>cd</code> into <code>/framework</code> and run <code>ant jar</code> to build the cordova jar. It creates the .jar file formed as <code>cordova-3.1.0.jar</code> in the <code>/framework</code> directory.</p></li>
+<li><p>Copy the cordova jar into your Android project's <code>/libs</code> directory.</p></li>
+<li>
+<p>Edit your application's <code>main.xml</code> file (under <code>/res/xml</code>) to look like the following, with the <code>layout_height</code>, <code>layout_width</code> and <code>id</code> modified to suit your application:</p>
+
+<pre class="prettyprint"><code>&lt;org.apache.cordova.CordovaWebView
+    android:id="@+id/tutorialView"
+    android:layout_width="match_parent"
+    android:layout_height="match_parent" /&gt;
+</code></pre>
+</li>
+<li>
+<p>Modify your activity so that it implements the <code>CordovaInterface</code>.  You should implement the included methods.  You may wish to copy them from <code>/framework/src/org/apache/cordova/CordovaActivity.java</code>, or implement them on your own.  The code fragment below shows a basic application that uses the interface. Note how the referenced view id matches the <code>id</code> attribute specified in the XML fragment shown above:</p>
+
+<pre class="prettyprint"><code>public class CordovaViewTestActivity extends Activity implements CordovaInterface {
+    CordovaWebView cwv;
+    /* Called when the activity is first created. */
+    @Override
+    public void onCreate(Bundle savedInstanceState) {
+        super.onCreate(savedInstanceState);
+        setContentView(R.layout.main);
+        cwv = (CordovaWebView) findViewById(R.id.tutorialView);
+        Config.init(this);
+        cwv.loadUrl(Config.getStartUrl());
+    }
+</code></pre>
+</li>
+</ol>
+<p>If you use the camera, you should also implement this:</p>
+
+<pre class="prettyprint"><code>    @Override
+    public void setActivityResultCallback(CordovaPlugin plugin) {
+        this.activityResultCallback = plugin;
+    }
+    /**
+     * Launch an activity for which you would like a result when it finished. When this activity exits,
+     * your onActivityResult() method is called.
+     *
+     * @param command           The command object
+     * @param intent            The intent to start
+     * @param requestCode       The request code that is passed to callback to identify the activity
+     */
+    public void startActivityForResult(CordovaPlugin command, Intent intent, int requestCode) {
+        this.activityResultCallback = command;
+        this.activityResultKeepRunning = this.keepRunning;
+
+        // If multitasking turned on, then disable it for activities that return results
+        if (command != null) {
+            this.keepRunning = false;
+        }
+
+        // Start activity
+        super.startActivityForResult(intent, requestCode);
+    }   
+
+    @Override
+    /**
+     * Called when an activity you launched exits, giving you the requestCode you started it with,
+     * the resultCode it returned, and any additional data from it.
+     *
+     * @param requestCode       The request code originally supplied to startActivityForResult(),
+     *                          allowing you to identify who this result came from.
+     * @param resultCode        The integer result code returned by the child activity through its setResult().
+     * @param data              An Intent, which can return result data to the caller (various data can be attached to Intent "extras").
+     */
+    protected void onActivityResult(int requestCode, int resultCode, Intent intent) {
+        super.onActivityResult(requestCode, resultCode, intent);
+        CordovaPlugin callback = this.activityResultCallback;
+        if (callback != null) {
+            callback.onActivityResult(requestCode, resultCode, intent);
+        }
+    }
+</code></pre>
+
+<p>Finally, remember to add the thread pool, otherwise the plugins have no threads to run on:</p>
+
+<pre class="prettyprint"><code>    @Override
+    public ExecutorService getThreadPool() {
+        return threadPool;
+    }
+</code></pre>
+
+<ol>
+<li><p>Copy your application's HTML and JavaScript files to your Android project's <code>/assets/www</code> directory.</p></li>
+<li><p>Copy <code>config.xml</code> from <code>/framework/res/xml</code> to your project's <code>/res/xml</code> directory.</p></li>
+</ol>
+</div>
+        </div>
+
+        <!-- Functionality and Syntax Highlighting -->
+        <script type="text/javascript" src="index.js"></script><script type="text/javascript" src="prettify/prettify.js"></script>
+</body>
+</html>