RubyGems - mobox - Versions diffs - 0.0.1 - Mend

mobox 0.0.1

Files changed (833) hide show

data/vendor/phonegap/doc/guide_getting-started_webos_index.md.html ADDED Viewed

@@ -0,0 +1,200 @@
+<!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="English" value="en">
+<option value="edge">edge</option>
+<option value="2.0.0rc1">2.0.0rc1</option>
+<option selected value="2.0.0">2.0.0</option>
+<option value="1.9.0rc1">1.9.0rc1</option>
+<option value="1.9.0">1.9.0</option>
+<option value="1.8.1">1.8.1</option>
+<option value="1.8.0rc1">1.8.0rc1</option>
+<option value="1.8.0">1.8.0</option>
+<option value="1.7.0rc1">1.7.0rc1</option>
+<option value="1.7.0">1.7.0</option>
+<option value="1.6.1">1.6.1</option>
+<option value="1.6.0rc1">1.6.0rc1</option>
+<option value="1.6.0">1.6.0</option>
+<option value="1.5.0rc1">1.5.0rc1</option>
+<option value="1.5.0">1.5.0</option>
+<option value="1.4.1">1.4.1</option>
+<option value="1.4.0rc1">1.4.0rc1</option>
+<option value="1.4.0">1.4.0</option>
+<option value="1.3.0">1.3.0</option>
+<option value="1.2.0">1.2.0</option>
+<option value="1.1.0">1.1.0</option>
+<option value="1.0.0rc3">1.0.0rc3</option>
+<option value="1.0.0rc2">1.0.0rc2</option>
+<option value="1.0.0rc1">1.0.0rc1</option>
+<option value="1.0.0">1.0.0</option>
+<option value="0.9.6">0.9.6</option>
+<option value="0.9.5.1">0.9.5.1</option>
+<option value="0.9.5">0.9.5</option>
+<option value="0.9.4">0.9.4</option>
+<option value="0.9.3">0.9.3</option>
+<option value="0.9.2">0.9.2</option>
+</optgroup>
+<optgroup label="Español" value="es"><option value="1.0.0">1.0.0</option></optgroup>
+<optgroup label="Français" value="fr">
+<option value="1.3.0">1.3.0</option>
+<option value="1.2.0">1.2.0</option>
+<option value="1.1.0">1.1.0</option>
+</optgroup>
+<optgroup label="Japanese" value="jp">
+<option value="1.8.1">1.8.1</option>
+<option value="1.7.0">1.7.0</option>
+<option value="0.9.5">0.9.5</option>
+</optgroup></select></small>
+        </div>
+        <div id="subheader">
+            <h1>Getting Started with WebOS</h1>
+            <small><select><option value="Getting%2520Started%2520with%2520WebOS">Getting Started with WebOS</option>
+<option value="Getting%20Started%20with%20WebOS_video_tutorials">      - Video Tutorials:</option>
+<option value="Getting%20Started%20with%20WebOS_1_requirements">      - 1. Requirements</option>
+<option value="Getting%20Started%20with%20WebOS_2_install_sdk_cordova">      - 2. Install SDK + Cordova</option>
+<option value="Getting%20Started%20with%20WebOS_3_setup_new_project">      - 3. Setup New Project</option>
+<option value="Getting%20Started%20with%20WebOS_4_hello_world">      - 4. Hello World</option>
+<option value="Getting%20Started%20with%20WebOS_5a_deploy_to_simulator">      - 5A. Deploy to Simulator</option>
+<option value="Getting%20Started%20with%20WebOS_5b_deploy_to_device">      - 5B. Deploy to Device
+</option>
+<option value="Getting%20Started%20with%20WebOS_done">      - Done!</option></select></small>
+        </div>
+        <div id="sidebar">
+            <div class="vertical_divider"></div>
+        <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_media_media.md.html#Media">Media</a></li>
+<li><a href="cordova_notification_notification.md.html#Notification">Notification</a></li>
+<li><a href="cordova_storage_storage.md.html#Storage">Storage</a></li>
+</ul>
+<h1>Guides</h1>
+<ul>
+<li><a href="guide_getting-started_index.md.html#Getting%20Started%20Guides">Getting Started Guides</a></li>
+<li><a href="guide_command-line_index.md.html#Command-Line%20Usage">Command-Line Usage</a></li>
+<li><a href="guide_upgrading_index.md.html#Upgrading%20Guides">Upgrading Guides</a></li>
+<li><a href="guide_plugin-development_index.md.html#Plugin%20Development%20Guide">Plugin Development Guide</a></li>
+<li><a href="guide_whitelist_index.md.html#Domain%20Whitelist%20Guide">Domain Whitelist Guide</a></li>
+<li><a href="guide_cordova-webview_index.md.html#Embedding%20WebView">Embedding WebView</a></li>
+<li><a href="_index.html">Keyword Index</a></li>
+</ul>
+</div>
+        <div id="scrollable">
+            <div id="content">
+                <h1><a name="Getting%20Started%20with%20WebOS">Getting Started with WebOS</a></h1>
+<p>This guide describes how to set up your development environment for Cordova and run a sample application.  Note that Cordova used to be called PhoneGap, so some of the sites still use the old PhoneGap name.</p>
+<h2>
+<a name="Getting%20Started%20with%20WebOS_video_tutorials">Video Tutorials:</a>
+</h2>
+<ul>
+<li><a class="external" href="http://www.youtube.com/v/XEnAUbDRZfw?autoplay=1">Cordova and HP Palm webOS quick start video</a></li>
+<li><a class="external" href="http://www.youtube.com/v/wWoJfQw79XI?autoplay=1">How to convert iPhone app to a Palm</a></li>
+</ul>
+<h2>
+<a name="Getting%20Started%20with%20WebOS_1_requirements">1. Requirements</a>
+</h2>
+<ul>
+<li>Windows, OS X, or Linux</li>
+</ul>
+<h2>
+<a name="Getting%20Started%20with%20WebOS_2_install_sdk_cordova">2. Install SDK + Cordova</a>
+</h2>
+<ul>
+<li>Download and install <a class="external" href="http://www.virtualbox.org/">Virtual Box</a>
+</li>
+<li>Download and install <a class="external" href="http://developer.palm.com/index.php?option=com_content&amp;view=article&amp;layout=page&amp;id=1788&amp;Itemid=321/">WebOS SDK</a>
+</li>
+<li>Download and install <a class="external" href="http://developer.palm.com/index.php?option=com_content&amp;view=article&amp;layout=page&amp;id=1788&amp;Itemid=321">cygwin SDK</a>  (Windows only). Make sure you select "make" as it is not included by default</li>
+<li>Download the latest copy of <a class="external" href="http://phonegap.com/download">Cordova</a> and extract its contents. We will be working with the webOS directory.</li>
+<li>Download and install XCode from the <a class="external" href="http://itunes.apple.com/ca/app/xcode/id497799835?mt=12">Mac App Store</a> (OSX only)</li>
+<li>Download and install Command Line Tools for XCode (OSX only); this can be done by going to XCode's Preferences -&gt; Downloads -&gt; Components and then click install on Command Line Tools</li>
+</ul>
+<h2>
+<a name="Getting%20Started%20with%20WebOS_3_setup_new_project">3. Setup New Project</a>
+</h2>
+<ul>
+<li>Open up terminal/cygwin and navigate to where you extracted your Cordova Download. Go into the webOS directory.</li>
+</ul>
+<h2>
+<a name="Getting%20Started%20with%20WebOS_4_hello_world">4. Hello World</a>
+</h2>
+<p>In phonegap/webOS/framework/www, open up index.html with your favourite editor. After the body tag add <code>&lt;h1&gt;Hello World&lt;/h1&gt;</code></p>
+<h2>
+<a name="Getting%20Started%20with%20WebOS_5a_deploy_to_simulator">5A. Deploy to Simulator</a>
+</h2>
+<ul>
+<li>Open up your Palm Emulator from your applications folder/start menu.</li>
+<li>Type <code>make</code> in your terminal/cygwin while in the webOS directory.</li>
+</ul>
+<h2>
+<a name="Getting%20Started%20with%20WebOS_5b_deploy_to_device">5B. Deploy to Device
+</a>
+</h2>
+<ul>
+<li>Make sure your device is in <a class="external" href="http://developer.palm.com/index.php?option=com_content&amp;view=article&amp;id=1552&amp;Itemid=59#dev_mode">Developer Mode and plug it in.</a>
+</li>
+<li>Type <code>make</code> in your terminal/cygwin while in the webOS directory.</li>
+</ul>
+<h2>
+<a name="Getting%20Started%20with%20WebOS_done">Done!</a>
+</h2>
+<p>You can also checkout more detailed version of this guide <a class="external" href="http://wiki.phonegap.com/w/page/16494781/Getting-Started-with-PhoneGap-webOS">here</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>

data/vendor/phonegap/doc/guide_getting-started_windows-phone_index.md.html ADDED Viewed

@@ -0,0 +1,228 @@
+<!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="English" value="en">
+<option value="edge">edge</option>
+<option value="2.0.0rc1">2.0.0rc1</option>
+<option selected value="2.0.0">2.0.0</option>
+<option value="1.9.0rc1">1.9.0rc1</option>
+<option value="1.9.0">1.9.0</option>
+<option value="1.8.1">1.8.1</option>
+<option value="1.8.0rc1">1.8.0rc1</option>
+<option value="1.8.0">1.8.0</option>
+<option value="1.7.0rc1">1.7.0rc1</option>
+<option value="1.7.0">1.7.0</option>
+<option value="1.6.1">1.6.1</option>
+<option value="1.6.0rc1">1.6.0rc1</option>
+<option value="1.6.0">1.6.0</option>
+<option value="1.5.0rc1">1.5.0rc1</option>
+<option value="1.5.0">1.5.0</option>
+<option value="1.4.1">1.4.1</option>
+<option value="1.4.0rc1">1.4.0rc1</option>
+<option value="1.4.0">1.4.0</option>
+<option value="1.3.0">1.3.0</option>
+<option value="1.2.0">1.2.0</option>
+<option value="1.1.0">1.1.0</option>
+<option value="1.0.0rc3">1.0.0rc3</option>
+<option value="1.0.0rc2">1.0.0rc2</option>
+<option value="1.0.0rc1">1.0.0rc1</option>
+<option value="1.0.0">1.0.0</option>
+<option value="0.9.6">0.9.6</option>
+<option value="0.9.5.1">0.9.5.1</option>
+<option value="0.9.5">0.9.5</option>
+<option value="0.9.4">0.9.4</option>
+<option value="0.9.3">0.9.3</option>
+<option value="0.9.2">0.9.2</option>
+</optgroup>
+<optgroup label="Español" value="es"><option value="1.0.0">1.0.0</option></optgroup>
+<optgroup label="Français" value="fr">
+<option value="1.3.0">1.3.0</option>
+<option value="1.2.0">1.2.0</option>
+<option value="1.1.0">1.1.0</option>
+</optgroup>
+<optgroup label="Japanese" value="jp">
+<option value="1.8.1">1.8.1</option>
+<option value="1.7.0">1.7.0</option>
+<option value="0.9.5">0.9.5</option>
+</optgroup></select></small>
+        </div>
+        <div id="subheader">
+            <h1>Getting Started with Windows Phone</h1>
+            <small><select><option value="Getting%2520Started%2520with%2520Windows%2520Phone">Getting Started with Windows Phone</option>
+<option value="Getting%20Started%20with%20Windows%20Phone_video_tutorials">      - Video Tutorials:</option>
+<option value="Getting%20Started%20with%20Windows%20Phone_1_requirements">      - 1. Requirements</option>
+<option value="Getting%20Started%20with%20Windows%20Phone_2_install_sdk_cordova">      - 2. Install SDK + Cordova</option>
+<option value="Getting%20Started%20with%20Windows%20Phone_3_setup_new_project">      - 3. Setup New Project</option>
+<option value="Getting%20Started%20with%20Windows%20Phone_4_review_the_project_structure">      - 4. Review the project structure</option>
+<option value="Getting%20Started%20with%20Windows%20Phone_5_build_and_deploy_to_emulator">      - 5. Build and Deploy to Emulator</option>
+<option value="Getting%20Started%20with%20Windows%20Phone_6_build_your_project_for_the_device">      - 6. Build your project for the device</option>
+<option value="Getting%20Started%20with%20Windows%20Phone_done">      - Done!</option></select></small>
+        </div>
+        <div id="sidebar">
+            <div class="vertical_divider"></div>
+        <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_media_media.md.html#Media">Media</a></li>
+<li><a href="cordova_notification_notification.md.html#Notification">Notification</a></li>
+<li><a href="cordova_storage_storage.md.html#Storage">Storage</a></li>
+</ul>
+<h1>Guides</h1>
+<ul>
+<li><a href="guide_getting-started_index.md.html#Getting%20Started%20Guides">Getting Started Guides</a></li>
+<li><a href="guide_command-line_index.md.html#Command-Line%20Usage">Command-Line Usage</a></li>
+<li><a href="guide_upgrading_index.md.html#Upgrading%20Guides">Upgrading Guides</a></li>
+<li><a href="guide_plugin-development_index.md.html#Plugin%20Development%20Guide">Plugin Development Guide</a></li>
+<li><a href="guide_whitelist_index.md.html#Domain%20Whitelist%20Guide">Domain Whitelist Guide</a></li>
+<li><a href="guide_cordova-webview_index.md.html#Embedding%20WebView">Embedding WebView</a></li>
+<li><a href="_index.html">Keyword Index</a></li>
+</ul>
+</div>
+        <div id="scrollable">
+            <div id="content">
+                <h1><a name="Getting%20Started%20with%20Windows%20Phone">Getting Started with Windows Phone</a></h1>
+<p>This guide describes how to set up your development environment for Cordova and run a sample application.  Note that Cordova used to be called PhoneGap, so some of the sites still use the old PhoneGap name.</p>
+<h2>
+<a name="Getting%20Started%20with%20Windows%20Phone_video_tutorials">Video Tutorials:</a>
+</h2>
+<ul>
+<li><a class="external" href="http://www.youtube.com/v/wO9xdRcNHIM?autoplay=1">Cordova and Windows Phone quick setup video</a></li>
+<li><a class="external" href="http://www.youtube.com/v/BJFX1GRUXj8?autoplay=1">Cordova and Windows Phone deep dive</a></li>
+</ul>
+<h2>
+<a name="Getting%20Started%20with%20Windows%20Phone_1_requirements">1. Requirements</a>
+</h2>
+<ul>
+<li>Windows 7 or Windows Vista with SP2</li>
+</ul>
+<p>Note: Running in VM has issues, if you are on a Mac, you will need to setup a bootcamp partition with Windows 7 or Vista</p>
+<p>Necessary for Installing on <a href="cordova_device_device.md.html#Device">Device</a> and Submitting to Market Place:</p>
+<ul>
+<li>Become an <a class="external" href="http://create.msdn.com/en-US/home/membership">App Hub member</a>.</li>
+</ul>
+<h2>
+<a name="Getting%20Started%20with%20Windows%20Phone_2_install_sdk_cordova">2. Install SDK + Cordova</a>
+</h2>
+<ul>
+<li>Download and install <a class="external" href="http://www.microsoft.com/download/en/details.aspx?displaylang=en&amp;id=27570/">Windows Phone  SDK</a>
+</li>
+<li>Download the latest copy of <a class="external" href="http://phonegap.com/download">Cordova</a> and extract its contents. We will be working with the subfolder: lib\windows-phone\</li>
+<li>copy the file CordovaStarter-x.x.x.zip to the folder : \My Documents\Visual Studio 2010\Templates\ProjectTemplates\
+if you have just installed VisualStudio, you should launch it once to create this folder
+if you prefer, you may add the project instead to the "Silverlight for Windows Phone" subfolder of "Visual C#". This is up to you, and only affects where the project template is shown when creating a new project. Also, You may need to create this folder.</li>
+</ul>
+<h2>
+<a name="Getting%20Started%20with%20Windows%20Phone_3_setup_new_project">3. Setup New Project</a>
+</h2>
+<ul>
+<li>Open Visual Studio Express for Windows Phone and choose <strong>New Project</strong>.</li>
+<li>Select <strong>CordovaStarter</strong>. ( the version number will be displayed in the template description )</li>
+<li><ul>
+<li>note: If you do not see it, you may have to select the top level 'Visual C#' to see it</li>
+</ul></li>
+<li>
+<p>Give your project a name, and select OK.</p>
+<p><img src="img/guide/getting-started/windows-phone/wpnewproj.PNG" alt="" title=""></p>
+</li>
+</ul>
+<h2>
+<a name="Getting%20Started%20with%20Windows%20Phone_4_review_the_project_structure">4. Review the project structure</a>
+</h2>
+<ul>
+<li>The 'www' folder contains your Cordova html/js/css and any other resources included in your app.</li>
+<li>
+<p>Any content that you add here needs to be a part of the Visual Studio project, and it must be set as content. </p>
+<p><img src="img/guide/getting-started/windows-phone/wp7projectstructure.PNG" alt="" title=""></p>
+</li>
+</ul>
+<h2>
+<a name="Getting%20Started%20with%20Windows%20Phone_5_build_and_deploy_to_emulator">5. Build and Deploy to Emulator</a>
+</h2>
+<ul>
+<li>Make sure to have <strong>Windows Phone Emulator</strong> selected in the top drop-down menu.</li>
+<li>
+<p>Hit the green <strong>play button</strong> beside the Windows Phone Emulator drop-down menu to start debugging or press F5.</p>
+<p><img src="img/guide/getting-started/windows-phone/wprun.png" alt="" title=""><img src="img/guide/getting-started/windows-phone/wpfirstrun.PNG" alt="" title=""></p>
+</li>
+</ul>
+<h2>
+<a name="Getting%20Started%20with%20Windows%20Phone_6_build_your_project_for_the_device">6. Build your project for the device</a>
+</h2>
+<p>In order to test your application on a device, the device must be registered. Click <a class="external" href="http://msdn.microsoft.com/en-us/library/gg588378(v=VS.92">here</a>.aspx) to read documentation on deploying and testing on your Windows Phone.</p>
+<ul>
+<li>Make sure your phone is connected, and the screen is unlocked</li>
+<li>In Visual Studio, select 'Windows Phone <a href="cordova_device_device.md.html#Device">Device</a>' from the top drop-down menu.</li>
+<li>
+<p>Hit the green <strong>play button</strong> beside the drop-down menu to start debugging or press F5.</p>
+<p><img src="img/guide/getting-started/windows-phone/wpd.png" alt="" title=""></p>
+</li>
+</ul>
+<h2>
+<a name="Getting%20Started%20with%20Windows%20Phone_done">Done!</a>
+</h2>
+<p>You can also checkout more detailed version of this guide <a class="external" href="http://wiki.phonegap.com/w/page/48672055/Getting%20Started%20with%20PhoneGap%20Windows%20Phone%207">here</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>

data/vendor/phonegap/doc/guide_plugin-development_android_index.md.html ADDED Viewed

@@ -0,0 +1,275 @@
+<!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="English" value="en">
+<option value="edge">edge</option>
+<option value="2.0.0rc1">2.0.0rc1</option>
+<option selected value="2.0.0">2.0.0</option>
+<option value="1.9.0rc1">1.9.0rc1</option>
+<option value="1.9.0">1.9.0</option>
+<option value="1.8.1">1.8.1</option>
+<option value="1.8.0rc1">1.8.0rc1</option>
+<option value="1.8.0">1.8.0</option>
+<option value="1.7.0rc1">1.7.0rc1</option>
+<option value="1.7.0">1.7.0</option>
+<option value="1.6.1">1.6.1</option>
+<option value="1.6.0rc1">1.6.0rc1</option>
+<option value="1.6.0">1.6.0</option>
+<option value="1.5.0rc1">1.5.0rc1</option>
+<option value="1.5.0">1.5.0</option>
+<option value="1.4.1">1.4.1</option>
+<option value="1.4.0rc1">1.4.0rc1</option>
+<option value="1.4.0">1.4.0</option>
+<option value="1.3.0">1.3.0</option>
+<option value="1.2.0">1.2.0</option>
+<option value="1.1.0">1.1.0</option>
+<option value="1.0.0rc3">1.0.0rc3</option>
+<option value="1.0.0rc2">1.0.0rc2</option>
+<option value="1.0.0rc1">1.0.0rc1</option>
+<option value="1.0.0">1.0.0</option>
+<option value="0.9.6">0.9.6</option>
+<option value="0.9.5.1">0.9.5.1</option>
+<option value="0.9.5">0.9.5</option>
+<option value="0.9.4">0.9.4</option>
+<option value="0.9.3">0.9.3</option>
+<option value="0.9.2">0.9.2</option>
+</optgroup>
+<optgroup label="Español" value="es"><option value="1.0.0">1.0.0</option></optgroup>
+<optgroup label="Français" value="fr">
+<option value="1.3.0">1.3.0</option>
+<option value="1.2.0">1.2.0</option>
+<option value="1.1.0">1.1.0</option>
+</optgroup>
+<optgroup label="Japanese" value="jp">
+<option value="1.8.1">1.8.1</option>
+<option value="1.7.0">1.7.0</option>
+<option value="0.9.5">0.9.5</option>
+</optgroup></select></small>
+        </div>
+        <div id="subheader">
+            <h1>Developing a Plugin on Android</h1>
+            <small><select><option value="Developing%2520a%2520Plugin%2520on%2520Android">Developing a Plugin on Android</option>
+<option value="Developing%20a%20Plugin%20on%20Android_plugin_class_mapping">      - Plugin Class Mapping</option>
+<option value="Developing%20a%20Plugin%20on%20Android_writing_an_android_java_plugin">      - Writing an Android Java Plugin</option>
+<option value="Developing%20a%20Plugin%20on%20Android_debugging_plugins">      - Debugging Plugins</option>
+<option value="Developing%20a%20Plugin%20on%20Android_common_pitfalls">      - Common Pitfalls</option></select></small>
+        </div>
+        <div id="sidebar">
+            <div class="vertical_divider"></div>
+        <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_media_media.md.html#Media">Media</a></li>
+<li><a href="cordova_notification_notification.md.html#Notification">Notification</a></li>
+<li><a href="cordova_storage_storage.md.html#Storage">Storage</a></li>
+</ul>
+<h1>Guides</h1>
+<ul>
+<li><a href="guide_getting-started_index.md.html#Getting%20Started%20Guides">Getting Started Guides</a></li>
+<li><a href="guide_command-line_index.md.html#Command-Line%20Usage">Command-Line Usage</a></li>
+<li><a href="guide_upgrading_index.md.html#Upgrading%20Guides">Upgrading Guides</a></li>
+<li><a href="guide_plugin-development_index.md.html#Plugin%20Development%20Guide">Plugin Development Guide</a></li>
+<li><a href="guide_whitelist_index.md.html#Domain%20Whitelist%20Guide">Domain Whitelist Guide</a></li>
+<li><a href="guide_cordova-webview_index.md.html#Embedding%20WebView">Embedding WebView</a></li>
+<li><a href="_index.html">Keyword Index</a></li>
+</ul>
+</div>
+        <div id="scrollable">
+            <div id="content">
+                <h1><a name="Developing%20a%20Plugin%20on%20Android">Developing a Plugin on Android</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 config.xml
+file.</p>
+<p>A plugin will consist of at least a single Java class that extends the <code>Plugin</code> class. A plugin <strong>must</strong>
+have a method called <code>execute</code> that must return a <code>PluginResult</code> object. In addition to this, there is a best practice that
+the plugin should handle <a href="cordova_events_events.md.html#pause">pause</a> and <a href="cordova_events_events.md.html#resume">resume</a> events, and should handle message passing between plugins.</p>
+<h2>
+<a name="Developing%20a%20Plugin%20on%20Android_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 will marshall 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> folder.</p>
+<pre class="prettyprint"><code>&lt;plugin name="&lt;service_name&gt;" value="&lt;full_name_including_namespace&gt;"/&gt;
+</code></pre>
+<p>The service name should match what you use in the JavaScript <code>exec</code> call, and the value will be the full name of the Java class including the namespace. Without this added, the plugin may compile but
+will not be reachable by Cordova.</p>
+<h2>
+<a name="Developing%20a%20Plugin%20on%20Android_writing_an_android_java_plugin">Writing an Android Java Plugin</a>
+</h2>
+<p>We have JavaScript to fire off a plugin request to the native side. We
+have the Android Java plugin 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>public PluginResult execute(String action, JSONArray args, String callbackId) {
+    PluginResult.Status status = PluginResult.Status.OK;
+    String result = "";
+    try {
+        if (action.equals("beep")) {
+            this.beep(args.getLong(0));
+        }
+        return new PluginResult(status, result);
+    } catch (JSONException e) {
+        return new PluginResult(PluginResult.Status.JSON_EXCEPTION);
+    }
+}
+</code></pre>
+<p>Essentially 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 that the error we return to JavaScript match the Java exception as much as possible, for clarity.</p>
+<h3>Echo Plugin Android Plugin</h3>
+<p>We would add the following to our config.xml:</p>
+<pre class="prettyprint"><code>&lt;plugin name="Echo" value="org.apache.cordova.plugin.Echo" /&gt;
+</code></pre>
+<p>Then we would 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.api.Plugin;
+import org.apache.cordova.api.PluginResult;
+import org.json.JSONArray;
+import org.json.JSONException;
+import org.json.JSONObject;
+/**
+ * This class echoes a string called from JavaScript.
+ */
+public class App extends Plugin {
+    /**
+     * Executes the request and returns PluginResult.
+     *
+     * @param action        The action to execute.
+     * @param args          JSONArry of arguments for the plugin.
+     * @param callbackId    The callback id used when calling back into JavaScript.
+     * @return              A PluginResult object with a status and message.
+     */
+    public PluginResult execute(String action, JSONArray args, String callbackId) {
+        try {
+            if (action.equals("echo")) {
+                String echo = args.getString(0);
+                if (echo != null &amp;&amp; echo.length() &gt; 0) {
+                    return new PluginResult(PluginResult.Status.OK, echo);
+                } else {
+                    return new PluginResult(PluginResult.Status.ERROR);
+                }
+            } else {
+                return new PluginResult(PluginResult.Status.INVALID_ACTION);
+            }
+        } catch (JSONException e) {
+            return new PluginResult(PluginResult.Status.JSON_EXCEPTION);
+        }
+    }
+}
+</code></pre>
+<p>Let's take a look at the code. At the top we have all of the necessary
+Cordova <code>import</code>s. Our class extends from <code>Plugin</code> - very important. The
+one method that the <code>Plugin</code> interface demands is the <code>execute</code> method.
+The method first compares against <code>action</code>: this plugin only supports
+one action, the <code>echo</code> action. Any other action will return a
+<code>PluginResult</code> with a status of <code>INVALID_ACTION</code> - this will translate
+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 return a <code>PluginResult</code> with an
+<code>ERROR</code> status (which, by now, you should now will invoke the error
+callback). If all of those checks pass, then we return a <code>PluginResult</code>
+with an <code>OK</code> status, and pass in the <code>echo</code> string we received in the
+first place as a parameter. This will finally translate into a success
+callback invocation on the JavaScript side. It will also pass the <code>echo</code>
+parameter as a parameter into the JavaScript success callback function.</p>
+<h2>
+<a name="Developing%20a%20Plugin%20on%20Android_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 Dev Tools is known to allow source code attachment to JAR dependencies, this is not fully supported at this time.</p>
+<h2>
+<a name="Developing%20a%20Plugin%20on%20Android_common_pitfalls">Common Pitfalls</a>
+</h2>
+<ul>
+<li>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.</li>
+<li>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 the methods that <code>ctx</code> has exist on the <code>Context</code>, so both <code>getContext()</code> and <code>getActivity()</code> are capable of returning the proper object required.</li>
+<li>Avoid calling JavaScript using <code>webView.loadUrl()</code>. The reason we have a callback server is to allow JavaScript execution to be thread-safe, and <code>loadUrl</code> explicitly interrupts the UI thread, and can affect the usability of your plugin.</li>
+</ul>
+</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>