You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@cordova.apache.org by mw...@apache.org on 2013/02/23 00:43:56 UTC
svn commit: r1449255 [25/34] - in /cordova/site/public/docs: en/1.5.0/
en/1.5.0rc1/ en/1.6.0/ en/1.6.0rc1/ en/1.6.1/ en/1.7.0/ en/1.7.0rc1/
en/1.8.0/ en/1.8.0rc1/ en/1.8.1/ en/1.9.0/ en/1.9.0rc1/ en/2.0.0/
en/2.0.0rc1/ en/2.1.0/ en/2.1.0rc1/ en/2.1.0rc...
Added: cordova/site/public/docs/en/2.5.0rc1/guide_getting-started_webos_index.md.html
URL: http://svn.apache.org/viewvc/cordova/site/public/docs/en/2.5.0rc1/guide_getting-started_webos_index.md.html?rev=1449255&view=auto
==============================================================================
--- cordova/site/public/docs/en/2.5.0rc1/guide_getting-started_webos_index.md.html (added)
+++ cordova/site/public/docs/en/2.5.0rc1/guide_getting-started_webos_index.md.html Fri Feb 22 23:42:47 2013
@@ -0,0 +1,198 @@
+<!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 selected value="2.5.0rc1">2.5.0rc1</option>
+<option value="2.4.0rc1">2.4.0rc1</option>
+<option value="2.4.0">2.4.0</option>
+<option value="2.3.0rc2">2.3.0rc2</option>
+<option value="2.3.0rc1">2.3.0rc1</option>
+<option value="2.3.0">2.3.0</option>
+<option value="2.2.0rc2">2.2.0rc2</option>
+<option value="2.2.0rc1">2.2.0rc1</option>
+<option value="2.2.0">2.2.0</option>
+<option value="2.1.0rc2">2.1.0rc2</option>
+<option value="2.1.0rc1">2.1.0rc1</option>
+<option value="2.1.0">2.1.0</option>
+<option value="2.0.0rc1">2.0.0rc1</option>
+<option 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>
+</optgroup>
+<optgroup label="Japanese" value="jp">
+<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="kr"><option value="2.0.0">2.0.0</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_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>
+<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_project-settings_index.md.html#Project%20Settings">Project Settings</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&view=article&layout=page&id=1788&Itemid=321/">WebOS SDK</a>
+</li>
+<li>Download and install <a class="external" href="http://developer.palm.com/index.php?option=com_content&view=article&layout=page&id=1788&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 -> Downloads -> 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><h1>Hello World</h1></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&view=article&id=1552&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>
Added: cordova/site/public/docs/en/2.5.0rc1/guide_getting-started_windows-8_index.md.html
URL: http://svn.apache.org/viewvc/cordova/site/public/docs/en/2.5.0rc1/guide_getting-started_windows-8_index.md.html?rev=1449255&view=auto
==============================================================================
--- cordova/site/public/docs/en/2.5.0rc1/guide_getting-started_windows-8_index.md.html (added)
+++ cordova/site/public/docs/en/2.5.0rc1/guide_getting-started_windows-8_index.md.html Fri Feb 22 23:42:47 2013
@@ -0,0 +1,223 @@
+<!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 selected value="2.5.0rc1">2.5.0rc1</option>
+<option value="2.4.0rc1">2.4.0rc1</option>
+<option value="2.4.0">2.4.0</option>
+<option value="2.3.0rc2">2.3.0rc2</option>
+<option value="2.3.0rc1">2.3.0rc1</option>
+<option value="2.3.0">2.3.0</option>
+<option value="2.2.0rc2">2.2.0rc2</option>
+<option value="2.2.0rc1">2.2.0rc1</option>
+<option value="2.2.0">2.2.0</option>
+<option value="2.1.0rc2">2.1.0rc2</option>
+<option value="2.1.0rc1">2.1.0rc1</option>
+<option value="2.1.0">2.1.0</option>
+<option value="2.0.0rc1">2.0.0rc1</option>
+<option 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>
+</optgroup>
+<optgroup label="Japanese" value="jp">
+<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="kr"><option value="2.0.0">2.0.0</option></optgroup></select></small>
+ </div>
+ <div id="subheader">
+ <h1>Getting Started with Windows 8</h1>
+ <small><select><option value="Getting%2520Started%2520with%2520Windows%25208">Getting Started with Windows 8</option>
+<option value="Getting%20Started%20with%20Windows%208_1_requirements">Â Â Â Â Â Â - 1. Requirements</option>
+<option value="Getting%20Started%20with%20Windows%208_2_install_sdk_cordova">Â Â Â Â Â Â - 2. Install SDK + Cordova</option>
+<option value="Getting%20Started%20with%20Windows%208_3_setup_new_project">Â Â Â Â Â Â - 3. Setup New Project</option>
+<option value="Getting%20Started%20with%20Windows%208_5_test_the_project">Â Â Â Â Â Â - 5. Test the Project</option>
+<option value="Getting%20Started%20with%20Windows%208_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_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>
+<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_project-settings_index.md.html#Project%20Settings">Project Settings</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%208">Getting Started with Windows 8</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>
+
+<p>During development of Windows 8 and Windows RT, Microsoft deprecated the name "Metro-style apps". On MSDN, this type of app is now called a "Windows Store" app. That's the name that we'll use in this guide. Also in this guide whenever we refer to Windows 8, you should take that to mean both Windows 8 and Windows RT.</p>
+
+<h2>
+<a name="Getting%20Started%20with%20Windows%208_1_requirements">1. Requirements</a>
+</h2>
+
+<ul>
+<li><p>Windows 8</p></li>
+<li><p>Visual Studio 2012 Professional or better, or Visual Studio 2012 Express for Windows 8</p></li>
+</ul>
+<p>Follow the instructions <a class="external" href="http://www.windowsstore.com/">here</a> to submit your apps Windows Store.</p>
+
+<h2>
+<a name="Getting%20Started%20with%20Windows%208_2_install_sdk_cordova">2. Install SDK + Cordova</a>
+</h2>
+
+<ul>
+<li>Setup your preferred variant of Visual Studio 2012. All of the paid versions of the product (Professional, etc) let you build Windows Store apps. To build Windows Store apps using the <a class="external" href="http://www.microsoft.com/visualstudio/eng/products/visual-studio-express-products">Express editions</a>, you will need <strong>Express for Windows 8</strong>.</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 <strong>lib\windows-8</strong>.</li>
+</ul>
+<h2>
+<a name="Getting%20Started%20with%20Windows%208_3_setup_new_project">3. Setup New Project</a>
+</h2>
+
+<p>You can already build Windows 8 apps using the "HTML/JavaScript track" available in Windows Store apps. The purpose of Cordova in Windows Store apps is to expose the same APIs used on all the other Cordova platforms.</p>
+
+<ul>
+<li>Open Visual Studio 2012 and choose <strong>New Project</strong>.</li>
+<li>
+<p>Select <strong>Installed - Template - Other Languages - JavaScript - Windows Store</strong> from the tree, and then <strong>Blank App</strong> from the projects list. Enter whatever project name you like. We're using <strong>CordovaWin8Foo</strong> in this guide.</p>
+
+<p><img src="img/guide/getting-started/windows-8/wsnewproject.PNG" alt="" title=""></p>
+</li>
+<li>
+<p>Microsoft continues to use <strong>default.html</strong> as the default page for use in websites, whereas most "open web" developers use <strong>index.html</strong>. (Plus it's likely that in the other platform variants of your project you are using <strong>index.html</strong> as the name of your default page.) To fix this, in Solution Explorer rename the <strong>default.html</strong> file to <strong>index.html</strong>. Then double-click the <strong>package.appxmanifest</strong> file and change the <strong>Start page</strong> value to <strong>index.html</strong>. </p>
+
+<p><img src="img/guide/getting-started/windows-8/wschangemanifest.PNG" alt="" title=""></p>
+</li>
+<li><p>To include <strong>cordova.js</strong> in your project, right-click on the <strong>js</strong> folder in Solution Explorer and select <strong>Add - New Item</strong>. Locate the <strong>cordova.js</strong> file in the <strong>lib\windows-8</strong> folder that we called out previously. </p></li>
+<li><p>Edit the code for <strong>index.html</strong>. Add a reference to <strong>cordova.js</strong>. You can do this manually, or by dragging the file from Solution Explorer.</p></li>
+</ul>
+<h3>Adding the reference...</h3>
+
+<pre class="prettyprint"><code> <!-- WinJS references -->
+ <link href="//Microsoft.WinJS.1.0/css/ui-dark.css" rel="stylesheet" />
+ <script src="//Microsoft.WinJS.1.0/js/base.js"></script>
+ <script src="//Microsoft.WinJS.1.0/js/ui.js"></script>
+
+ <!-- Cordova -->
+ <script src="/js/cordova.js"></script>
+
+ <!-- CordovaWin8Foo references -->
+ <link href="/css/default.css" rel="stylesheet" />
+ <script src="/js/default.js"></script>
+</code></pre>
+
+<ul>
+<li>Next we want to add some code that will demonstrate that Cordova is working. </li>
+</ul>
+<h3>Adding a '<a href="cordova_events_events.md.html#deviceready">deviceready</a>' handler...</h3>
+
+<pre class="prettyprint"><code><body>
+ <p>Content goes here</p>
+
+ <script type="text/javascript">
+
+ console.log("Subscribing...");
+ document.<a href="cordova_inappbrowser_inappbrowser.md.html#addEventListener">addEventListener</a>("<a href="cordova_events_events.md.html#deviceready">deviceready</a>", function () {
+
+ navigator.<a href="cordova_notification_notification.md.html#notification.alert">notification.alert</a>("The device is ready!");
+
+ });
+
+ </script>
+
+</body>
+</code></pre>
+
+<h2>
+<a name="Getting%20Started%20with%20Windows%208_5_test_the_project">5. Test the Project</a>
+</h2>
+
+<ul>
+<li>
+<p>Run the project from Visual Studio. You'll see the message box appear.</p>
+
+<p><img src="img/guide/getting-started/windows-8/wsalert.PNG" alt="" title=""></p>
+</li>
+</ul>
+<h2>
+<a name="Getting%20Started%20with%20Windows%208_done">Done!</a>
+</h2>
+
+<p>That's it! You're now ready to build Windows Store apps with Cordova.</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/2.5.0rc1/guide_getting-started_windows-phone-7_index.md.html
URL: http://svn.apache.org/viewvc/cordova/site/public/docs/en/2.5.0rc1/guide_getting-started_windows-phone-7_index.md.html?rev=1449255&view=auto
==============================================================================
--- cordova/site/public/docs/en/2.5.0rc1/guide_getting-started_windows-phone-7_index.md.html (added)
+++ cordova/site/public/docs/en/2.5.0rc1/guide_getting-started_windows-phone-7_index.md.html Fri Feb 22 23:42:47 2013
@@ -0,0 +1,241 @@
+<!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 selected value="2.5.0rc1">2.5.0rc1</option>
+<option value="2.4.0rc1">2.4.0rc1</option>
+<option value="2.4.0">2.4.0</option>
+<option value="2.3.0rc2">2.3.0rc2</option>
+<option value="2.3.0rc1">2.3.0rc1</option>
+<option value="2.3.0">2.3.0</option>
+<option value="2.2.0rc2">2.2.0rc2</option>
+<option value="2.2.0rc1">2.2.0rc1</option>
+<option value="2.2.0">2.2.0</option>
+<option value="2.1.0rc2">2.1.0rc2</option>
+<option value="2.1.0rc1">2.1.0rc1</option>
+<option value="2.1.0">2.1.0</option>
+<option value="2.0.0rc1">2.0.0rc1</option>
+<option 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>
+</optgroup>
+<optgroup label="Japanese" value="jp">
+<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="kr"><option value="2.0.0">2.0.0</option></optgroup></select></small>
+ </div>
+ <div id="subheader">
+ <h1>Getting Started with Windows Phone 7</h1>
+ <small><select><option value="Getting%2520Started%2520with%2520Windows%2520Phone%25207">Getting Started with Windows Phone 7</option>
+<option value="Getting%20Started%20with%20Windows%20Phone%207_video_tutorials">Â Â Â Â Â Â - Video Tutorials:</option>
+<option value="Getting%20Started%20with%20Windows%20Phone%207_1_requirements">Â Â Â Â Â Â - 1. Requirements</option>
+<option value="Getting%20Started%20with%20Windows%20Phone%207_2_install_sdk_cordova">Â Â Â Â Â Â - 2. Install SDK + Cordova</option>
+<option value="Getting%20Started%20with%20Windows%20Phone%207_2_1_building_the_template">Â Â Â Â Â Â - 2.1. Building the template</option>
+<option value="Getting%20Started%20with%20Windows%20Phone%207_3_setup_new_project">Â Â Â Â Â Â - 3. Setup New Project</option>
+<option value="Getting%20Started%20with%20Windows%20Phone%207_4_review_the_project_structure">Â Â Â Â Â Â - 4. Review the project structure</option>
+<option value="Getting%20Started%20with%20Windows%20Phone%207_5_build_and_deploy_to_emulator">Â Â Â Â Â Â - 5. Build and Deploy to Emulator</option>
+<option value="Getting%20Started%20with%20Windows%20Phone%207_6_build_your_project_for_the_device">Â Â Â Â Â Â - 6. Build your project for the device</option>
+<option value="Getting%20Started%20with%20Windows%20Phone%207_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_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>
+<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_project-settings_index.md.html#Project%20Settings">Project Settings</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%207">Getting Started with Windows Phone 7</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%207_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%207_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%207_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&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 the template file does not exist, you will need to build it. See 2.1 below )
+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%207_2_1_building_the_template">2.1. Building the template</a>
+</h2>
+
+<p>( note, this step may not be required. If the lib\windows-phone directory already contains a file CordovaStarter-x.x.x.zip then you may skip this step )
+- Open the file lib\windows-phone\templates\standalone\CordovaSolution.sln in Visual Studio Express for Windows Phone
+- From the file menu, select 'Export Template...'
+- Choose template type 'Project template'
+- Give the exported template a name, ex. CordovaStarter-2.1.0 will produce CordovaStarter-2.1.0.zip
+- Optionally, you may add a description, icon image, and Preview image. These are what is displayed in Visual Studio in the 'New Project' dialog.-
+- Note: If you select ( 'Automatically import the template ... ') then you will not need to copy the .zip file over as outlined in step 2.
+- Press 'Finish'</p>
+
+<h2>
+<a name="Getting%20Started%20with%20Windows%20Phone%207_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-7/wpnewproj.PNG" alt="" title=""></p>
+</li>
+</ul>
+<h2>
+<a name="Getting%20Started%20with%20Windows%20Phone%207_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-7/wp7projectstructure.PNG" alt="" title=""></p>
+</li>
+</ul>
+<h2>
+<a name="Getting%20Started%20with%20Windows%20Phone%207_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-7/wprun.png" alt="" title=""><img src="img/guide/getting-started/windows-phone-7/wpfirstrun.PNG" alt="" title=""></p>
+</li>
+</ul>
+<h2>
+<a name="Getting%20Started%20with%20Windows%20Phone%207_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-7/wpd.png" alt="" title=""></p>
+</li>
+</ul>
+<h2>
+<a name="Getting%20Started%20with%20Windows%20Phone%207_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>
Added: cordova/site/public/docs/en/2.5.0rc1/guide_getting-started_windows-phone-8_index.md.html
URL: http://svn.apache.org/viewvc/cordova/site/public/docs/en/2.5.0rc1/guide_getting-started_windows-phone-8_index.md.html?rev=1449255&view=auto
==============================================================================
--- cordova/site/public/docs/en/2.5.0rc1/guide_getting-started_windows-phone-8_index.md.html (added)
+++ cordova/site/public/docs/en/2.5.0rc1/guide_getting-started_windows-phone-8_index.md.html Fri Feb 22 23:42:47 2013
@@ -0,0 +1,270 @@
+<!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 selected value="2.5.0rc1">2.5.0rc1</option>
+<option value="2.4.0rc1">2.4.0rc1</option>
+<option value="2.4.0">2.4.0</option>
+<option value="2.3.0rc2">2.3.0rc2</option>
+<option value="2.3.0rc1">2.3.0rc1</option>
+<option value="2.3.0">2.3.0</option>
+<option value="2.2.0rc2">2.2.0rc2</option>
+<option value="2.2.0rc1">2.2.0rc1</option>
+<option value="2.2.0">2.2.0</option>
+<option value="2.1.0rc2">2.1.0rc2</option>
+<option value="2.1.0rc1">2.1.0rc1</option>
+<option value="2.1.0">2.1.0</option>
+<option value="2.0.0rc1">2.0.0rc1</option>
+<option 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>
+</optgroup>
+<optgroup label="Japanese" value="jp">
+<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="kr"><option value="2.0.0">2.0.0</option></optgroup></select></small>
+ </div>
+ <div id="subheader">
+ <h1>Getting Started with Windows Phone 8</h1>
+ <small><select><option value="Getting%2520Started%2520with%2520Windows%2520Phone%25208">Getting Started with Windows Phone 8</option>
+<option value="Getting%20Started%20with%20Windows%20Phone%208_1_system_requirements">Â Â Â Â Â Â - 1. System Requirements</option>
+<option value="Getting%20Started%20with%20Windows%20Phone%208_2_install_sdk_cordova">Â Â Â Â Â Â - 2. Install SDK + Cordova</option>
+<option value="Getting%20Started%20with%20Windows%20Phone%208_2_1_building_the_template">Â Â Â Â Â Â - 2.1. Building the template</option>
+<option value="Getting%20Started%20with%20Windows%20Phone%208_2_2_about_the_different_templates">Â Â Â Â Â Â - 2.2 About the different templates</option>
+<option value="Getting%20Started%20with%20Windows%20Phone%208_3_setup_new_project">Â Â Â Â Â Â - 3. Setup New Project</option>
+<option value="Getting%20Started%20with%20Windows%20Phone%208_4_review_the_project_structure">Â Â Â Â Â Â - 4. Review the project structure</option>
+<option value="Getting%20Started%20with%20Windows%20Phone%208_5_build_and_deploy_to_emulator">Â Â Â Â Â Â - 5. Build and Deploy to Emulator</option>
+<option value="Getting%20Started%20with%20Windows%20Phone%208_6_build_your_project_for_the_device">Â Â Â Â Â Â - 6. Build your project for the device</option>
+<option value="Getting%20Started%20with%20Windows%20Phone%208_done">Â Â Â Â Â Â - Done!</option>
+<option value="Getting%20Started%20with%20Windows%20Phone%208_further_reading">Â Â Â Â Â Â - Further Reading </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_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>
+<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_project-settings_index.md.html#Project%20Settings">Project Settings</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%208">Getting Started with Windows Phone 8</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>
+
+<p>Note: Applications built with Apache Cordova for Windows Phone 8 will only run on Windows Phone 8 devices. If you are looking to target both 7.5 AND 8 devices, then you should be using Apache Cordova for Windows Phone 7, which does not have all the new shiny features included in IE10, but implements the same APIs.</p>
+
+<h2>
+<a name="Getting%20Started%20with%20Windows%20Phone%208_1_system_requirements">1. System Requirements</a>
+</h2>
+
+<ul>
+<li>
+<p>Operating System: </p>
+
+<ul>
+<li>Windows 8, Windows 8 Pro</li>
+</ul>
+</li>
+<li>
+<p>Hardware:</p>
+
+<ul>
+<li>6.5 GB of free hard disk space</li>
+<li>4 GB RAM</li>
+<li>64-bit (x64) CPU</li>
+</ul>
+</li>
+<li>
+<p>Windows Phone 8 Emulator:</p>
+
+<ul>
+<li>Windows 8 Pro edition or greater</li>
+<li>Requires a processor that supports Second Level Address Translation (SLAT)</li>
+</ul>
+</li>
+<li>
+<p>SDK + IDE ( Visual Studio )</p>
+
+<ul>
+<li>VS Express for Windows Phone ( included in the SDK )</li>
+<li>Visual Studio Professional, Premium, or Ultimate</li>
+</ul>
+</li>
+</ul>
+<p>Note: Running in Virtual Machine might present some challenges. You can read this blog post that gives insight on the solutions to develop for Windows Phone on a Mac: http://aka.ms/BuildaWP8apponaMac</p>
+
+<p>Necessary for Installing on <a href="cordova_device_device.md.html#Device">Device</a> and Submitting to Market Place:</p>
+
+<ul>
+<li>⢠Register for the <a class="external" href="http://dev.windowsphone.com/en-us/publish">Windows Phone Developer Center</a>
+</li>
+</ul>
+<h2>
+<a name="Getting%20Started%20with%20Windows%20Phone%208_2_install_sdk_cordova">2. Install SDK + Cordova</a>
+</h2>
+
+<ul>
+<li>Download and install <a class="external" href="http://www.microsoft.com/en-us/download/details.aspx?id=35471">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-8\</li>
+<li>copy the file CordovaWP8AppFull-x.x.x.zip to the folder : \My Documents\Visual Studio 2012\Templates\ProjectTemplates\</li>
+</ul>
+<h2>
+<a name="Getting%20Started%20with%20Windows%20Phone%208_2_1_building_the_template">2.1. Building the template</a>
+</h2>
+
+<p>Note: this step may not be required. If the lib\windows-phone directory already contains a file CordovaStarter-x.x.x.zip then you may skip this step )
+In order to simplify the development process, Cordova comes with a Visual Studio template that allows creating a Cordova application rapidly. This template can be modified if needed and the below steps indicate how to proceed if you want to modify and re-generate the template.</p>
+
+<ul>
+<li>Open the file lib\windows-phone\templates\standalone\CordovaSolution.sln in Visual Studio Express for Windows Phone</li>
+<li>From the file menu, select 'Export Template...' </li>
+<li>Choose template type 'Project template'</li>
+<li>Give the exported template a name, ex. CordovaStarter-2.1.0 will produce CordovaStarter-2.1.0.zip</li>
+<li>Optionally, you may add a description, icon image, and Preview image. These are what is displayed in Visual Studio in the 'New Project' dialog.- </li>
+<li>Note: If you select ( 'Automatically import the template ... ') then you will not need to copy the .zip file over as outlined in step 2.</li>
+<li>Press 'Finish'</li>
+</ul>
+<h2>
+<a name="Getting%20Started%20with%20Windows%20Phone%208_2_2_about_the_different_templates">2.2 About the different templates</a>
+</h2>
+
+<p>Apache Cordova for Windows Phone 8 supports 2 different types of templates. <br>
+The 'Full' template includes a pre-built dll containing all the framework code for Apache Cordova. This template will create a project that is easy to update, as you can simply replace the JavaScript and .dll in your project and rebuild when a new version comes out. The downside of this approach is that because the dll contains ALL of the Cordova API, it requires all available permissions even if the APIs are not called. When you submit an app to the App store, Microsoft will run a static analyzer against your application, and detect that you require all available permissions, and place a disclaimer on you app that is presented to the user when they choose to install your app. Users may be discouraged if they see a required permission that does not make sense ( ie, why does this drawing program need access to my media library and contacts ).</p>
+
+<p>The 'Stand-Alone' template includes ALL the source code for Apache Cordova. This project is easier to fine-tune to use just the features you need, thereby working around the permissions issues of the 'Full' template, however this type of project will be more difficult to update, as you will need to update individual files within your project and manage any dependancies yourself. In order to exclude an API you are not using, you can simply right-click-select the Command class file in Visual Studio and choose 'do not include in project'.</p>
+
+<h2>
+<a name="Getting%20Started%20with%20Windows%20Phone%208_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>CordovaWP8AppFull</strong> or <strong>CordovaWP8AppStandalone</strong>. ( the version number will be displayed in the template description )</li>
+<li>Give your project a name, and select OK.</li>
+</ul>
+<p><img src="img/guide/getting-started/windows-phone-8/FullTemplate.PNG" alt="" title=""><img src="img/guide/getting-started/windows-phone-8/StandAloneTemplate.PNG" alt="" title=""></p>
+
+<h2>
+<a name="Getting%20Started%20with%20Windows%20Phone%208_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>Any content that you add here needs to be a part of the Visual Studio project, and it must be set as content. </li>
+</ul>
+<p><img src="img/guide/getting-started/windows-phone-8/projectStructure.PNG" alt="" title=""></p>
+
+<h2>
+<a name="Getting%20Started%20with%20Windows%20Phone%208_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>Hit the green <strong>play button</strong> beside the Windows Phone Emulator drop-down menu to start debugging or press F5.</li>
+</ul>
+<p><img src="img/guide/getting-started/windows-phone-8/BuildEmulator.PNG" alt="" title=""></p>
+
+<h2>
+<a name="Getting%20Started%20with%20Windows%20Phone%208_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 8.</p>
+
+<ul>
+<li>Make sure your phone is connected, and the screen is unlocked</li>
+<li>In Visual Studio, select '<a href="cordova_device_device.md.html#Device">Device</a>' from the top drop-down menu.</li>
+<li>Hit the green <strong>play button</strong> beside the drop-down menu to start debugging or press F5.</li>
+</ul>
+<p><img src="img/guide/getting-started/windows-phone-8/BuildDevice.PNG" alt="" title=""></p>
+
+<h2>
+<a name="Getting%20Started%20with%20Windows%20Phone%208_done">Done!</a>
+</h2>
+
+<h2>
+<a name="Getting%20Started%20with%20Windows%20Phone%208_further_reading">Further Reading </a>
+</h2>
+
+<p>For more details on the specific differences between IE10 and WebKit browsers, and how to support both MS has a helpful <a class="external" href="http://blogs.windows.com/windows_phone/b/wpdev/archive/2012/11/15/adapting-your-webkit-optimized-site-for-internet-explorer-10.aspx">guide 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>
Added: cordova/site/public/docs/en/2.5.0rc1/guide_plugin-development_android_index.md.html
URL: http://svn.apache.org/viewvc/cordova/site/public/docs/en/2.5.0rc1/guide_plugin-development_android_index.md.html?rev=1449255&view=auto
==============================================================================
--- cordova/site/public/docs/en/2.5.0rc1/guide_plugin-development_android_index.md.html (added)
+++ cordova/site/public/docs/en/2.5.0rc1/guide_plugin-development_android_index.md.html Fri Feb 22 23:42:47 2013
@@ -0,0 +1,312 @@
+<!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 selected value="2.5.0rc1">2.5.0rc1</option>
+<option value="2.4.0rc1">2.4.0rc1</option>
+<option value="2.4.0">2.4.0</option>
+<option value="2.3.0rc2">2.3.0rc2</option>
+<option value="2.3.0rc1">2.3.0rc1</option>
+<option value="2.3.0">2.3.0</option>
+<option value="2.2.0rc2">2.2.0rc2</option>
+<option value="2.2.0rc1">2.2.0rc1</option>
+<option value="2.2.0">2.2.0</option>
+<option value="2.1.0rc2">2.1.0rc2</option>
+<option value="2.1.0rc1">2.1.0rc1</option>
+<option value="2.1.0">2.1.0</option>
+<option value="2.0.0rc1">2.0.0rc1</option>
+<option 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>
+</optgroup>
+<optgroup label="Japanese" value="jp">
+<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="kr"><option value="2.0.0">2.0.0</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>
+<option value="Developing%20a%20Plugin%20on%20Android_use_the_source">Â Â Â Â Â Â - Use the Source</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_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>
+<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_project-settings_index.md.html#Project%20Settings">Project Settings</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>CordovaPlugin</code> class. A plugin must override one
+of the <code>execute</code> methods from <code>CordovaPlugin</code>. 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.
+Plugins with long-running requests, background activity (e.g. playing media), listeners or internal state should implement the <code>onReset()</code> method as well. This method is run when the <code>WebView</code> navigates to a new page or refreshes, which reloads the Javascript.</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(<successFunction>, <failFunction>, <service>, <action>, [<args>]);
+</code></pre>
+
+<p>This will marshal 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><plugin name="<service_name>" value="<full_name_including_namespace>"/>
+</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>@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 that the error we return to JavaScript match the Java exception as much as possible, for clarity.</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>We would add the following to our config.xml:</p>
+
+<pre class="prettyprint"><code><plugin name="Echo" value="org.apache.cordova.plugin.Echo" />
+</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.CordovaPlugin;
+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 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 && message.length() > 0) {
+ callbackContext.success(message);
+ } else {
+ callbackContext.error("Expected one non-empty string argument.");
+ }
+ }
+}
+</code></pre>
+
+<p>Let's take a look at the code. At the top we have all of the necessary
+Cordova <code>imports</code>. 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 will return false, which
+results in an error of type <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 call callbackContext.error() (which,
+by now, you should know will invoke the error callback). If all of those
+checks pass, then we call callbackContext.success(), and pass in the
+<code>message</code> string we received as a parameter. This will finally translate
+into a success callback invocation on the JavaScript side. It will also
+pass the <code>message</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>
+</ul>
+<h2>
+<a name="Developing%20a%20Plugin%20on%20Android_use_the_source">Use the Source</a>
+</h2>
+
+<p>One of the best ways to prepare yourself to write your own plugin is to
+have a <a class="external" href="https://github.com/apache/cordova-android/tree/master/framework/src/org/apache/cordova">look at other plugins that already exist</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/api/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/2.5.0rc1/guide_plugin-development_bada_index.md.html
URL: http://svn.apache.org/viewvc/cordova/site/public/docs/en/2.5.0rc1/guide_plugin-development_bada_index.md.html?rev=1449255&view=auto
==============================================================================
--- cordova/site/public/docs/en/2.5.0rc1/guide_plugin-development_bada_index.md.html (added)
+++ cordova/site/public/docs/en/2.5.0rc1/guide_plugin-development_bada_index.md.html Fri Feb 22 23:42:47 2013
@@ -0,0 +1,190 @@
+<!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 selected value="2.5.0rc1">2.5.0rc1</option>
+<option value="2.4.0rc1">2.4.0rc1</option>
+<option value="2.4.0">2.4.0</option>
+<option value="2.3.0rc2">2.3.0rc2</option>
+<option value="2.3.0rc1">2.3.0rc1</option>
+<option value="2.3.0">2.3.0</option>
+<option value="2.2.0rc2">2.2.0rc2</option>
+<option value="2.2.0rc1">2.2.0rc1</option>
+<option value="2.2.0">2.2.0</option>
+<option value="2.1.0rc2">2.1.0rc2</option>
+<option value="2.1.0rc1">2.1.0rc1</option>
+<option value="2.1.0">2.1.0</option>
+<option value="2.0.0rc1">2.0.0rc1</option>
+<option 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>
+</optgroup>
+<optgroup label="Japanese" value="jp">
+<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="kr"><option value="2.0.0">2.0.0</option></optgroup></select></small>
+ </div>
+ <div id="subheader">
+ <h1>Developing a Plugin on Bada</h1>
+ <small></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_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>
+<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_project-settings_index.md.html#Project%20Settings">Project Settings</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%20Bada">Developing a Plugin on Bada</a></h1>
+
+<p>Plugins are only supported on Bada 2.0 and above. Bada 1.2 does not support plugins.</p>
+
+<p>The Bada implementation is a full javascript implementation. Therefore, adding a custom plugin involves updating CordovaJS with your plugin code. Follow these steps to add a simple <em>Hello World</em> plugin:</p>
+
+<ol>
+<li>
+<p>Clone the CordovaJS repository</p>
+
+<pre class="prettyprint"><code>git clone https://git-wip-us.apache.org/repos/asf/cordova-js.git
+</code></pre>
+</li>
+<li>
+<p>Create a new javascript file under <strong>lib/bada/plugin/bada/</strong> and name it <em>HelloWorld.js</em>. Add the following content:</p>
+
+<pre class="prettyprint"><code>function HelloWorld() {
+}
+
+
+HelloWorld.prototype.printHello = function(success, fail, arg) {
+ alert(Osp.Core.StringHelper('Hello %1', arg[0]));
+}
+
+
+module.exports = new HelloWorld();
+</code></pre>
+</li>
+<li>
+<p>Add a link to your newly created plugin in <strong>lib/bada/platform.js</strong> under the objects property:</p>
+
+<pre class="prettyprint"><code>objects: {
+ ...
+ HelloWorld: {
+ 'cordova/plugin/bada/HelloWorld'
+ },
+ ...
+}
+...
+</code></pre>
+</li>
+<li>
+<p>Update the plugin list under <strong>lib/bada/exec.js</strong> to include your plugin</p>
+
+<pre class="prettyprint"><code>var plugins = {
+ ...
+ "HelloWorld": require('cordova/plugin/bada/HelloWorld')
+};
+</code></pre>
+</li>
+<li>
+<p>Now you can write your user-facing javascript however you like but remember that in order for your plugin to execute you need to call the following method</p>
+
+<pre class="prettyprint"><code>exec(success, fail, 'HelloWorld', 'printHello', ['Jackson!']);
+</code></pre>
+
+<p>success is the success callback that gets executed when the plugin succeeds
+fail is the failure callback that gets executed if the plugin fails
+'HelloWorld' is the name of your plugin
+'printHello' is your plugin action
+Finally, the last argument is your plugin parameters (if any).</p>
+</li>
+<li>
+<p>Run the following command to generate the new common javascript (make sure you have the jake npm module installed)</p>
+
+<pre class="prettyprint"><code>jake
+</code></pre>
+</li>
+<li><p>Copy the newly generated javascript under <strong>pkg/cordova.bada.js</strong> to your Bada project under <strong>Res/js</strong></p></li>
+<li><p>That is it! You can now add new Bada plugins and implement the many features that are not currently supported by Cordova Bada.</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>