You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@cordova.apache.org by ma...@apache.org on 2013/10/01 05:56:01 UTC
svn commit: r1527865 [19/25] - in /cordova/site/public/docs/en/3.1.0: ./
img/ img/guide/ img/guide/cli/ img/guide/platforms/
img/guide/platforms/android/ img/guide/platforms/bada/
img/guide/platforms/blackberry10/ img/guide/platforms/ios/ img/guide/pla...
Added: cordova/site/public/docs/en/3.1.0/guide_platforms_blackberry_upgrading.md.html
URL: http://svn.apache.org/viewvc/cordova/site/public/docs/en/3.1.0/guide_platforms_blackberry_upgrading.md.html?rev=1527865&view=auto
==============================================================================
--- cordova/site/public/docs/en/3.1.0/guide_platforms_blackberry_upgrading.md.html (added)
+++ cordova/site/public/docs/en/3.1.0/guide_platforms_blackberry_upgrading.md.html Tue Oct 1 03:55:57 2013
@@ -0,0 +1,515 @@
+<!DOCTYPE html>
+<!--
+ Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+--><html lang="en">
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
+<meta name="viewport" content="initial-scale=1.0, maximum-scale=1.0, user-scalable=no, width=device-width">
+<meta name="generator" content="joDoc">
+<title>Apache Cordova API Documentation</title>
+<link rel="stylesheet" type="text/css" href="index.css">
+<link rel="stylesheet" type="text/css" href="mobile.css" media="only screen and (max-device-width: 1024px)">
+<link rel="stylesheet" type="text/css" href="prettify/prettify.css">
+</head>
+<body>
+ <div id="header">
+ <h1><a href="index.html">Apache <strong>Cordova</strong> Documentation</a></h1>
+ <small>
+ <select><optgroup label="Chinese" value="zh"><option value="edge">edge</option></optgroup>
+<optgroup label="English" value="en">
+<option value="edge">edge</option>
+<option selected value="3.1.0">3.1.0</option>
+<option value="3.0.0">3.0.0</option>
+<option value="2.9.0">2.9.0</option>
+<option value="2.8.0">2.8.0</option>
+<option value="2.7.0">2.7.0</option>
+<option value="2.6.0">2.6.0</option>
+<option value="2.5.0">2.5.0</option>
+<option value="2.4.0">2.4.0</option>
+<option value="2.3.0">2.3.0</option>
+<option value="2.2.0">2.2.0</option>
+<option value="2.1.0">2.1.0</option>
+<option value="2.0.0">2.0.0</option>
+<option value="1.9.0">1.9.0</option>
+<option value="1.8.1">1.8.1</option>
+<option value="1.8.0">1.8.0</option>
+<option value="1.7.0">1.7.0</option>
+<option value="1.6.1">1.6.1</option>
+<option value="1.6.0">1.6.0</option>
+<option value="1.5.0">1.5.0</option>
+</optgroup>
+<optgroup label="French" value="fr"><option value="edge">edge</option></optgroup>
+<optgroup label="German" value="de"><option value="edge">edge</option></optgroup>
+<optgroup label="Italian" value="it"><option value="edge">edge</option></optgroup>
+<optgroup label="Japanese" value="ja">
+<option value="edge">edge</option>
+<option value="2.2.0">2.2.0</option>
+<option value="2.1.0">2.1.0</option>
+<option value="2.0.0">2.0.0</option>
+<option value="1.9.0">1.9.0</option>
+<option value="1.8.1">1.8.1</option>
+<option value="1.7.0">1.7.0</option>
+</optgroup>
+<optgroup label="Korean" value="ko">
+<option value="edge">edge</option>
+<option value="2.0.0">2.0.0</option>
+</optgroup>
+<optgroup label="Russian" value="ru"><option value="edge">edge</option></optgroup>
+<optgroup label="Spanish" value="es"><option value="edge">edge</option></optgroup></select></small>
+ </div>
+ <div id="subheader">
+ <h1>Upgrading BlackBerry</h1>
+ <small><select><option value="Upgrading%2520BlackBerry">Upgrading BlackBerry</option>
+<option value="Upgrading%20BlackBerry_upgrading_2_8_0_projects_to_2_9_0">Â Â Â Â Â Â - Upgrading 2.8.0 projects to 2.9.0</option>
+<option value="Upgrading%20BlackBerry_upgrading_2_7_0_projects_to_2_8_0">Â Â Â Â Â Â - Upgrading 2.7.0 projects to 2.8.0</option>
+<option value="Upgrading%20BlackBerry_upgrading_2_6_0_projects_to_2_7_0">Â Â Â Â Â Â - Upgrading 2.6.0 projects to 2.7.0</option>
+<option value="Upgrading%20BlackBerry_upgrade_to_2_6_0_from_2_5_0">Â Â Â Â Â Â - Upgrade to 2.6.0 from 2.5.0</option>
+<option value="Upgrading%20BlackBerry_upgrade_to_2_5_0_from_2_4_0">Â Â Â Â Â Â - Upgrade to 2.5.0 from 2.4.0</option>
+<option value="Upgrading%20BlackBerry_upgrade_to_2_4_0_from_2_3_0">Â Â Â Â Â Â - Upgrade to 2.4.0 from 2.3.0</option>
+<option value="Upgrading%20BlackBerry_upgrade_to_2_3_0_from_2_2_0">Â Â Â Â Â Â - Upgrade to 2.3.0 from 2.2.0</option>
+<option value="Upgrading%20BlackBerry_upgrade_to_2_2_0_from_2_1_0">Â Â Â Â Â Â - Upgrade to 2.2.0 from 2.1.0</option>
+<option value="Upgrading%20BlackBerry_upgrade_to_2_1_0_from_2_0_0">Â Â Â Â Â Â - Upgrade to 2.1.0 from 2.0.0</option>
+<option value="Upgrading%20BlackBerry_upgrade_to_2_0_0_from_1_9_0">Â Â Â Â Â Â - Upgrade to 2.0.0 from 1.9.0</option>
+<option value="Upgrading%20BlackBerry_upgrade_to_1_8_0_from_1_7_0">Â Â Â Â Â Â - Upgrade to 1.8.0 from 1.7.0</option></select></small>
+ </div>
+
+ <div id="sidebar">
+ <div class="vertical_divider"></div>
+ <h1>Guides</h1>
+<ul>
+<li><a href="guide_overview_index.md.html#Overview">Overview</a></li>
+<li><a href="guide_cli_index.md.html#The%20Command-line%20Interface">The Command-line Interface</a></li>
+<li><a href="guide_platforms_index.md.html#Platform%20Guides">Platform Guides</a></li>
+<li><a href="config_ref_index.md.html#The%20config.xml%20File">The config.xml File</a></li>
+<li><a href="guide_hybrid_webviews_index.md.html#Embedding%20WebViews">Embedding WebViews</a></li>
+<li><a href="guide_hybrid_plugins_index.md.html#Plugin%20Development%20Guide">Plugin Development Guide</a></li>
+<li><a href="guide_appdev_privacy_index.md.html#Privacy%20Guide">Privacy Guide</a></li>
+<li><a href="guide_appdev_whitelist_index.md.html#Domain%20Whitelist%20Guide">Domain Whitelist Guide</a></li>
+<li><a href="_index.html">Keyword Index</a></li>
+</ul>
+<h1>API Reference</h1>
+<ul>
+<li><a href="cordova_accelerometer_accelerometer.md.html#Accelerometer">Accelerometer</a></li>
+<li><a href="cordova_camera_camera.md.html#Camera">Camera</a></li>
+<li><a href="cordova_media_capture_capture.md.html#Capture">Capture</a></li>
+<li><a href="cordova_compass_compass.md.html#Compass">Compass</a></li>
+<li><a href="cordova_connection_connection.md.html#Connection">Connection</a></li>
+<li><a href="cordova_contacts_contacts.md.html#Contacts">Contacts</a></li>
+<li><a href="cordova_device_device.md.html#Device">Device</a></li>
+<li><a href="cordova_events_events.md.html#Events">Events</a></li>
+<li><a href="cordova_file_file.md.html#File">File</a></li>
+<li><a href="cordova_geolocation_geolocation.md.html#Geolocation">Geolocation</a></li>
+<li><a href="cordova_globalization_globalization.md.html#Globalization">Globalization</a></li>
+<li><a href="cordova_inappbrowser_inappbrowser.md.html#InAppBrowser">InAppBrowser</a></li>
+<li><a href="cordova_media_media.md.html#Media">Media</a></li>
+<li><a href="cordova_notification_notification.md.html#Notification">Notification</a></li>
+<li><a href="cordova_splashscreen_splashscreen.md.html#Splashscreen">Splashscreen</a></li>
+<li><a href="cordova_storage_storage.md.html#Storage">Storage</a></li>
+</ul>
+</div>
+
+ <div id="scrollable">
+ <div id="content">
+ <h1><a name="Upgrading%20BlackBerry">Upgrading BlackBerry</a></h1>
+
+<p>This guide shows how to modify BlackBerry projects to upgrade from
+older versions of Cordova. These instructions apply to projects
+created with an older set of command-line tools that precede the
+<code>cordova</code> CLI utility. See <a href="guide_cli_index.md.html#The%20Command-line%20Interface">The Command-line Interface</a> for information
+how to update the version of the CLI.</p>
+
+<h2>
+<a name="Upgrading%20BlackBerry_upgrading_2_8_0_projects_to_2_9_0">Upgrading 2.8.0 projects to 2.9.0</a>
+</h2>
+
+<p>BlackBerry 10:</p>
+
+<ol>
+<li><p>Download and extract the Cordova 2.9.0 source to a permanent location on your hard drive, for example to <code>~/Cordova-2.9.0</code>.</p></li>
+<li><p>Quit any running SDK tools: Eclipse, Momentics and the like.</p></li>
+<li><p>Navigate to the directory where you put the downloaded source above, using a unix like terminal: Terminal.app, Bash, Cygwin, etc.</p></li>
+<li><p>Create a new project, as described in <a href="guide_platforms_blackberry_tools.md.html#BlackBerry%20Command-line%20Tools">BlackBerry Command-line Tools</a>. This becomes the home of your updated project.</p></li>
+<li><p>Copy your project's source from the old project's <code>/www</code> directory to the new project's <code>/www</code> directory.</p></li>
+<li><p>Update the Cordova script reference in your <code>www/index.html</code> file (and any other files that contain the script reference) to point to the new <code>cordova.js</code> file.</p></li>
+</ol>
+<h3>BlackBerryOS/Playbook</h3>
+
+<ol>
+<li><p>Download and extract the Cordova 2.9.0 source to a permanent location on your hard drive, for example to <code>~/Cordova-2.9.0</code>.</p></li>
+<li><p>Quit any running SDK tools: Eclipse, Momentics and the like.</p></li>
+<li><p>Navigate to the directory where you put the downloaded source above, using a unix like terminal: Terminal.app, Bash, Cygwin, etc.</p></li>
+<li><p>Create a new project, as described in <a href="guide_platforms_ios_tools.md.html#iOS%20Command-line%20Tools">iOS Command-line Tools</a>. You need the assets from this new project.</p></li>
+<li><p>Copy the <code>www/cordova.js</code> file from the new project into your <code>www</code> directory, and delete your <code>www/cordova.js</code> file.</p></li>
+<li><p>Update the Cordova script reference in your <code>www/index.html</code> file (and any other files that contain the script reference) to point to the new <code>cordova.js</code> file.</p></li>
+<li><p>Copy the <code>native</code> directory from the new project into the existing project, overwriting the old <code>native</code> directory.</p></li>
+<li><p>Copy the <code>lib</code> directory from the new project into the existing project, overwriting the old <code>lib</code> directory.</p></li>
+<li><p>Copy the <code>cordova</code> directory from the new project into the existing project, overwriting the old <code>cordova</code> directory.</p></li>
+</ol>
+<h2>
+<a name="Upgrading%20BlackBerry_upgrading_2_7_0_projects_to_2_8_0">Upgrading 2.7.0 projects to 2.8.0</a>
+</h2>
+
+<p>BlackBerry 10:</p>
+
+<p>BlackBerry 10 uses the new CLI tooling and manages core APIs as plugins. The instructions migrate your project to a new project, rather than updating an existing project, due to the complexity of updating an old project.
+Also note that the cordova js script file is now called 'cordova.js' and no longer contains a version string.</p>
+
+<ol>
+<li><p>Download and extract the Cordova 2.8.0 source to a permanent location on your hard drive, for example to <code>~/Cordova-2.8.0</code>.</p></li>
+<li><p>Quit any running SDK tools: Eclipse, Momentics and the like.</p></li>
+<li><p>Navigate to the directory where you put the downloaded source above, using a unix like terminal: Terminal.app, Bash, Cygwin, etc.</p></li>
+<li><p>Create a new project, as described in <a href="guide_platforms_blackberry_tools.md.html#BlackBerry%20Command-line%20Tools">BlackBerry Command-line Tools</a>. This becomes the home of your updated project.</p></li>
+<li><p>Copy your project's source from the old project's <code>/www</code> directory to the new project's <code>/www</code> directory.</p></li>
+<li><p>Update the Cordova script reference in your <code>www/index.html</code> file (and any other files that contain the script reference) to point to the new <code>cordova.js</code> file.</p></li>
+</ol>
+<p>BlackBerryOS/Playbook:</p>
+
+<ol>
+<li><p>Download and extract the Cordova 2.8.0 source to a permanent location on your hard drive, for example to <code>~/Cordova-2.8.0</code>.</p></li>
+<li><p>Quit any running SDK tools: Eclipse, Momentics and the like.</p></li>
+<li><p>Navigate to the directory where you put the downloaded source above, using a unix like terminal: Terminal.app, Bash, Cygwin, etc.</p></li>
+<li><p>Create a new project, as described in <a href="guide_platforms_ios_tools.md.html#iOS%20Command-line%20Tools">iOS Command-line Tools</a>. You need the assets from this new project.</p></li>
+<li><p>Copy the <code>www/cordova.js</code> file from the new project into your <code>www</code> directory, and delete your <code>www/cordova.js</code> file.</p></li>
+<li><p>Update the Cordova script reference in your <code>www/index.html</code> file (and any other files that contain the script reference) to point to the new <code>cordova.js</code> file.</p></li>
+<li><p>Copy the <code>native</code> directory from the new project into the existing project, overwriting the old <code>native</code> directory.</p></li>
+<li><p>Copy the <code>lib</code> directory from the new project into the existing project, overwriting the old <code>lib</code> directory.</p></li>
+<li><p>Copy the <code>cordova</code> directory from the new project into the existing project, overwriting the old <code>cordova</code> directory.</p></li>
+</ol>
+<h2>
+<a name="Upgrading%20BlackBerry_upgrading_2_6_0_projects_to_2_7_0">Upgrading 2.6.0 projects to 2.7.0</a>
+</h2>
+
+<ol>
+<li><p>Download and extract the Cordova 2.7.0 source to a permanent location on your hard drive, for example to <code>~/Cordova-2.7.0</code>.</p></li>
+<li><p>Quit any running SDK tools: Eclipse, Momentics and the like.</p></li>
+<li><p>Navigate to the directory where you put the downloaded source above, using a unix like terminal: Terminal.app, Bash, Cygwin, etc.</p></li>
+<li><p>Create a new project, as described in <a href="guide_platforms_blackberry_tools.md.html#BlackBerry%20Command-line%20Tools">BlackBerry Command-line Tools</a>. You need the assets from this new project.</p></li>
+<li><p>Copy the <code>www/cordova-2.7.0.js</code> file from the new project into your <code>www</code> directory, and delete your <code>www/cordova-2.6.0.js</code> file.</p></li>
+<li><p>Update the Cordova script reference in your <code>www/index.html</code> file (and any other files that contain the script reference) to point to the new <code>cordova-2.7.0.js</code> file.</p></li>
+<li><p>Copy the <code>native</code> directory from the new project into the existing project, overwriting the old <code>native</code> directory.</p></li>
+<li><p>Copy the <code>lib</code> directory from the new project into the existing project, overwriting the old <code>lib</code> directory.</p></li>
+<li><p>Copy the <code>cordova</code> directory from the new project into the existing project, overwriting the old <code>cordova</code> directory.</p></li>
+</ol>
+<h2>
+<a name="Upgrading%20BlackBerry_upgrade_to_2_6_0_from_2_5_0">Upgrade to 2.6.0 from 2.5.0</a>
+</h2>
+
+<p>Updating the PhoneGap download directory:</p>
+
+<p>It is recommended that you download a fresh copy of the entire directory.</p>
+
+<p>However, here are the new parts needed for the piecemeal update:</p>
+
+<ol>
+<li><p>Update the cordova.blackberry.js file in the <code>Phonegap-2.6.0/lib/blackberry/javascript</code> directory.</p></li>
+<li><p>Update the <code>ext</code>, <code>ext-air</code>, and <code>ext-qnx</code> in the <code>Phonegap-2.6.0/lib/blackberry/framework</code> directory.</p></li>
+<li><p>Update the <code>build.xml</code> file in the <code>Phonegap-2.6.0/lib/blackberry</code> directory.</p></li>
+<li><p>Update the <code>Phonegap-2.6.0/lib/blackberry/bin</code> directory.</p></li>
+<li><p>Update the <code>VERSION</code> file in the <code>Phonegap-2.6.0/lib/blackberry</code> directory.</p></li>
+</ol>
+<p>Updating the <code>example/</code> directory or migrating an existing project:</p>
+
+<ol>
+<li><p>Open your <code>www/</code> directory, which contains your app.</p></li>
+<li><p>Remove and update the .jar file in the <code>ext/</code> directory.</p></li>
+<li><p>Update the contents of the <code>ext-air/</code> directory.</p></li>
+<li><p>Update the contents of the <code>ext-qnx/</code> directory.</p></li>
+<li><p>Copy the new <code>cordova-2.6.0.js</code> into your project.</p></li>
+<li><p>Update your HTML to use the new <code>cordova-2.6.0.js</code> file.</p></li>
+</ol>
+<h2>
+<a name="Upgrading%20BlackBerry_upgrade_to_2_5_0_from_2_4_0">Upgrade to 2.5.0 from 2.4.0</a>
+</h2>
+
+<p>Updating the PhoneGap download directory:</p>
+
+<p>It is recommended that you download a fresh copy of the entire directory.</p>
+
+<p>However, here are the new parts needed for the piecemeal update:</p>
+
+<ol>
+<li><p>Update the cordova.blackberry.js file in the <code>Phonegap-2.5.0/lib/blackberry/javascript</code> directory.</p></li>
+<li><p>Update the <code>ext</code>, <code>ext-air</code>, and <code>ext-qnx</code> in the <code>Phonegap-2.5.0/lib/blackberry/framework</code> directory.</p></li>
+<li><p>Update the <code>build.xml</code> file in the <code>Phonegap-2.5.0/lib/blackberry</code> directory.</p></li>
+<li><p>Update the <code>Phonegap-2.5.0/lib/blackberry/bin</code> directory.</p></li>
+<li><p>Update the <code>VERSION</code> file in the <code>Phonegap-2.5.0/lib/blackberry</code> directory.</p></li>
+</ol>
+<p>Updating the example/ directory or migrating an existing project:</p>
+
+<ol>
+<li><p>Open your <code>www/</code> directory, which contains your app.</p></li>
+<li><p>Remove and update the .jar file in the <code>ext/</code> directory.</p></li>
+<li><p>Update the contents of the <code>ext-air/</code> directory.</p></li>
+<li><p>Update the contents of the <code>ext-qnx/</code> directory.</p></li>
+<li><p>Copy the new <code>cordova-2.5.0.js</code> into your project.</p></li>
+<li><p>Update your HTML to use the new <code>cordova-2.5.0.js</code> file.</p></li>
+</ol>
+<h2>
+<a name="Upgrading%20BlackBerry_upgrade_to_2_4_0_from_2_3_0">Upgrade to 2.4.0 from 2.3.0</a>
+</h2>
+
+<p>Updating just the <code>www</code> directory:</p>
+
+<ol>
+<li><p>Open your <code>www/</code> directory, which contains your app.</p></li>
+<li><p>Remove and update the .jar file in the <code>ext/</code> directory.</p></li>
+<li><p>Update the contents of the <code>ext-air/</code> directory.</p></li>
+<li>
+<p>Copy the new <code>cordova-2.4.0.js</code> into your project.</p>
+
+<ul>
+<li>If playbook, then update the .js file in the <code>playbook/</code> directory.</li>
+<li>If BlackBerry 10, then update the .js file in the <code>qnx/</code> directory.</li>
+</ul>
+</li>
+<li><p>Update your HTML to use the new <code>cordova-2.4.0.js</code> file.</p></li>
+</ol>
+<p>Updating the sample directory (ie, updating using the ant tools):</p>
+
+<ol>
+<li><p>Open the <code>sample/lib/</code> directory.</p></li>
+<li><p>Update the .jar file in the <code>cordova.2.3.0/ext/</code> directory.</p></li>
+<li><p>Update the contents of the <code>cordova.2.3.0/ext-air/</code> directory.</p></li>
+<li><p>Update the contents of the <code>cordova.2.3.0/ext-qnx/</code> directory.</p></li>
+<li><p>Update the .js file in the <code>cordova.2.3.0/javascript/</code> directory.</p></li>
+<li><p>Open the <code>sample/lib/</code> directory and rename the <code>cordova.2.3.0/</code> directory to <code>cordova.2.4.0/</code>.</p></li>
+<li><p>Type <code>ant blackberry build</code> or <code>ant playbook build</code> to update the <code>www/</code> directory with updated Cordova.</p></li>
+<li><p>Open the <code>www/</code> directory and update your HTML to use the new <code>cordova-2.4.0.js</code> file.</p></li>
+</ol>
+<h2>
+<a name="Upgrading%20BlackBerry_upgrade_to_2_3_0_from_2_2_0">Upgrade to 2.3.0 from 2.2.0</a>
+</h2>
+
+<p>Updating just the <code>www</code> directory:</p>
+
+<ol>
+<li><p>Open your <code>www/</code> directory, which contains your app.</p></li>
+<li><p>Remove and update the .jar file in the <code>ext/</code> directory.</p></li>
+<li><p>Update the contents of the <code>ext-air/</code> directory.</p></li>
+<li>
+<p>Copy the new <code>cordova-2.3.0.js</code> into your project.</p>
+
+<ul>
+<li>If playbook, then update the .js file in the <code>playbook/</code> directory.</li>
+<li>If BlackBerry 10, then update the .js file in the <code>qnx/</code> directory.</li>
+</ul>
+</li>
+<li><p>Update your HTML to use the new <code>cordova-2.3.0.js</code> file.</p></li>
+</ol>
+<p>Updating the sample directory (ie, updating using the ant tools):</p>
+
+<ol>
+<li><p>Open the <code>sample/lib/</code> directory.</p></li>
+<li><p>Update the .jar file in the <code>cordova.2.2.0/ext/</code> directory.</p></li>
+<li><p>Update the contents of the <code>cordova.2.2.0/ext-air/</code> directory.</p></li>
+<li><p>Update the contents of the <code>cordova.2.2.0/ext-qnx/</code> directory.</p></li>
+<li><p>Update the .js file in the <code>cordova.2.2.0/javascript/</code> directory.</p></li>
+<li><p>Open the <code>sample/lib/</code> directory and rename the <code>cordova.2.2.0/</code> directory to <code>cordova.2.3.0/</code>.</p></li>
+<li><p>Type <code>ant blackberry build</code> or <code>ant playbook build</code> to update the <code>www/</code> directory with updated Cordova.</p></li>
+<li><p>Open the <code>www/</code> directory and update your HTML to use the new <code>cordova-2.3.0.js</code> file.</p></li>
+</ol>
+<h2>
+<a name="Upgrading%20BlackBerry_upgrade_to_2_2_0_from_2_1_0">Upgrade to 2.2.0 from 2.1.0</a>
+</h2>
+
+<p>Updating just the www directory:</p>
+
+<ol>
+<li><p>Open your <code>www/</code> directory, which contains your app.</p></li>
+<li><p>Remove and update the .jar file in the <code>ext/</code> directory.</p></li>
+<li><p>Update the contents of the <code>ext-air/</code> directory.</p></li>
+<li>
+<p>Copy the new <code>cordova-2.2.0.js</code> into your project.</p>
+
+<ul>
+<li>If playbook, then update the .js file in the <code>playbook/</code> directory.</li>
+<li>If BlackBerry 10, then update the .js file in the <code>qnx/</code> directory.</li>
+</ul>
+</li>
+<li><p>Update your HTML to use the new <code>cordova-2.2.0.js</code> file.</p></li>
+</ol>
+<p>Updating the sample directory (ie, updating using the ant tools):</p>
+
+<ol>
+<li><p>Open the <code>sample/lib/</code> directory.</p></li>
+<li><p>Update the .jar file in the <code>cordova.2.1.0/ext/</code> directory.</p></li>
+<li><p>Update the contents of the <code>cordova.2.1.0/ext-air/</code> directory.</p></li>
+<li><p>Update the contents of the <code>cordova.2.1.0/ext-qnx/</code> directory.</p></li>
+<li><p>Update the .js file in the <code>cordova.2.1.0/javascript/</code> directory.</p></li>
+<li><p>Open the <code>sample/lib/</code> directory and rename the <code>cordova.2.1.0/</code> directory to <code>cordova.2.2.0/</code>.</p></li>
+<li><p>Type <code>ant blackberry build</code> or <code>ant playbook build</code> to update the <code>www/</code> directory with updated Cordova.</p></li>
+<li><p>Open the <code>www/</code> directory and update your HTML to use the new <code>cordova-2.2.0.js</code> file.</p></li>
+</ol>
+<h2>
+<a name="Upgrading%20BlackBerry_upgrade_to_2_1_0_from_2_0_0">Upgrade to 2.1.0 from 2.0.0</a>
+</h2>
+
+<p>Updating just the <code>www</code> directory:</p>
+
+<ol>
+<li><p>Open your <code>www/</code> directory, which contains your app.</p></li>
+<li><p>Remove and update the .jar file in the <code>ext/</code> directory.</p></li>
+<li><p>Update the contents of the <code>ext-air/</code> directory.</p></li>
+<li>
+<p>Copy the new <code>cordova-2.1.0.js</code> into your project.</p>
+
+<ul>
+<li>If playbook, then update the .js file in the <code>playbook/</code> directory.</li>
+</ul>
+</li>
+<li><p>Update your HTML to use the new <code>cordova-2.1.0.js</code> file.</p></li>
+</ol>
+<p>Updating the sample directory (ie, updating using the ant tools):</p>
+
+<ol>
+<li><p>Open the <code>sample/lib/</code> directory.</p></li>
+<li><p>Update the .jar file in the <code>cordova.2.0.0/ext/</code> directory.</p></li>
+<li><p>Update the contents of the <code>cordova.2.0.0/ext-air/</code> directory.</p></li>
+<li><p>Update the .js file in the <code>cordova.2.0.0/javascript/</code> directory.</p></li>
+<li><p>Open the <code>sample/lib/</code> directory and rename the <code>cordova.2.0.0/</code> directory to <code>cordova.2.1.0/</code>.</p></li>
+<li><p>Type <code>ant blackberry build</code> or <code>ant playbook build</code> to update the <code>www/</code> directory with updated Cordova.</p></li>
+<li><p>Open the <code>www/</code> directory and update your HTML to use the new <code>cordova-2.1.0.js</code> file.</p></li>
+</ol>
+<h2>
+<a name="Upgrading%20BlackBerry_upgrade_to_2_0_0_from_1_9_0">Upgrade to 2.0.0 from 1.9.0</a>
+</h2>
+
+<p>Updating just the <code>www</code> directory:</p>
+
+<ol>
+<li><p>Open your <code>www/</code> directory, which contains your app.</p></li>
+<li><p>Remove and update the .jar file in the <code>ext/</code> directory.</p></li>
+<li><p>Update the contents of the <code>ext-air/</code> directory.</p></li>
+<li>
+<p>Copy the new <code>cordova-2.0.0.js</code> into your project.</p>
+
+<ul>
+<li>If playbook, then update the .js file in the <code>playbook/</code> directory.</li>
+</ul>
+</li>
+<li><p>Update your HTML to use the new <code>cordova-2.0.0.js</code> file.</p></li>
+<li>
+<p>Update your <code>www/plugins.xml</code> file. Two plugins changed their
+namespace/service label. Change the old entries for the <a href="cordova_media_capture_capture.md.html#Capture">Capture</a> and
+<a href="cordova_contacts_contacts.md.html#Contact">Contact</a> plugins from:</p>
+
+<pre class="prettyprint"><code><plugin name="<a href="cordova_media_capture_capture.md.html#Capture">Capture</a>" value="org.apache.cordova.media.MediaCapture"/>
+<plugin name="<a href="cordova_contacts_contacts.md.html#Contact">Contact</a>" value="org.apache.cordova.pim.<a href="cordova_contacts_contacts.md.html#Contact">Contact</a>"/>
+</code></pre>
+
+<p>To:</p>
+
+<pre class="prettyprint"><code><plugin name="<a href="cordova_media_capture_capture.md.html#Capture">Capture</a>" value="org.apache.cordova.capture.MediaCapture"/>
+<plugin name="<a href="cordova_contacts_contacts.md.html#Contacts">Contacts</a>" value="org.apache.cordova.pim.<a href="cordova_contacts_contacts.md.html#Contact">Contact</a>"/>
+</code></pre>
+</li>
+</ol>
+<p>Updating the sample directory (ie, updating using the ant tools):</p>
+
+<ol>
+<li><p>Open the <code>sample/lib/</code> directory.</p></li>
+<li><p>Update the .jar file in the <code>cordova.1.9.0/ext/</code> directory.</p></li>
+<li><p>Update the contents of the <code>cordova.1.9.0/ext-air/</code> directory.</p></li>
+<li><p>Update the .js file in the <code>cordova.1.9.0/javascript/</code> directory.</p></li>
+<li><p>Open the <code>sample/lib/</code> directory and rename the <code>cordova.1.9.0/</code> directory to <code>cordova.2.0.0/</code>.</p></li>
+<li><p>Type <code>ant blackberry build</code> or <code>ant playbook build</code> to update the <code>www/</code> directory with updated Cordova.</p></li>
+<li><p>Open the <code>www/</code> directory and update your HTML to use the new <code>cordova-2.0.0.js</code> file.</p></li>
+<li>
+<p>Open the <code>www/</code> directory and update the <code>plugins.xml</code> file. Two plugins
+changed their namespace/service label. Change the old entries for the
+<a href="cordova_media_capture_capture.md.html#Capture">Capture</a> and <a href="cordova_contacts_contacts.md.html#Contact">Contact</a> plugins from:</p>
+
+<pre class="prettyprint"><code> <plugin name="<a href="cordova_media_capture_capture.md.html#Capture">Capture</a>" value="org.apache.cordova.media.MediaCapture"/>
+ <plugin name="<a href="cordova_contacts_contacts.md.html#Contact">Contact</a>" value="org.apache.cordova.pim.<a href="cordova_contacts_contacts.md.html#Contact">Contact</a>"/>
+</code></pre>
+
+<p>To:</p>
+
+<pre class="prettyprint"><code> <plugin name="<a href="cordova_media_capture_capture.md.html#Capture">Capture</a>" value="org.apache.cordova.capture.MediaCapture"/>
+ <plugin name="<a href="cordova_contacts_contacts.md.html#Contacts">Contacts</a>" value="org.apache.cordova.pim.<a href="cordova_contacts_contacts.md.html#Contact">Contact</a>"/>
+</code></pre>
+</li>
+<li><p>To upgrade to 1.8.0, please go from 1.7.0</p></li>
+</ol>
+<h2>
+<a name="Upgrading%20BlackBerry_upgrade_to_1_8_0_from_1_7_0">Upgrade to 1.8.0 from 1.7.0</a>
+</h2>
+
+<p>Updating just the <code>www</code> directory:</p>
+
+<ol>
+<li><p>Open your <code>www/</code> directory, which contains your app.</p></li>
+<li><p>Remove and update the .jar file in the <code>ext/</code> directory.</p></li>
+<li><p>Update the contents of the <code>ext-air/</code> directory.</p></li>
+<li>
+<p>Copy the new <code>cordova-1.8.0.js</code> into your project.</p>
+
+<ul>
+<li>If playbook, then update the .js file in the <code>playbook/</code> directory.</li>
+</ul>
+</li>
+<li><p>Update your HTML to use the new <code>cordova-1.8.0.js</code> file.</p></li>
+<li>
+<p>Update your <code>www/plugins.xml</code> file. Two plugins changed their
+namespace/service label. Change the old entries for the <a href="cordova_media_capture_capture.md.html#Capture">Capture</a> and
+<a href="cordova_contacts_contacts.md.html#Contact">Contact</a> plugins from:</p>
+
+<pre class="prettyprint"><code><plugin name="<a href="cordova_media_capture_capture.md.html#Capture">Capture</a>" value="org.apache.cordova.media.MediaCapture"/>
+<plugin name="<a href="cordova_contacts_contacts.md.html#Contact">Contact</a>" value="org.apache.cordova.pim.<a href="cordova_contacts_contacts.md.html#Contact">Contact</a>"/>
+</code></pre>
+
+<p>To:</p>
+
+<pre class="prettyprint"><code><plugin name="<a href="cordova_media_capture_capture.md.html#Capture">Capture</a>" value="org.apache.cordova.capture.MediaCapture"/>
+<plugin name="<a href="cordova_contacts_contacts.md.html#Contacts">Contacts</a>" value="org.apache.cordova.pim.<a href="cordova_contacts_contacts.md.html#Contact">Contact</a>"/>
+</code></pre>
+</li>
+</ol>
+<p>Updating the sample directory (ie, updating using the ant tools):</p>
+
+<ol>
+<li><p>Open the <code>sample/lib/</code> directory.</p></li>
+<li><p>Update the .jar file in the <code>cordova.1.7.0/ext/</code> directory.</p></li>
+<li><p>Update the contents of the <code>cordova.1.7.0/ext-air/</code> directory.</p></li>
+<li><p>Update the .js file in the <code>cordova.1.7.0/javascript/</code> directory.</p></li>
+<li><p>Open the <code>sample/lib/</code> directory and rename the <code>cordova.1.7.0/</code> directory to <code>cordova.1.8.0/</code>.</p></li>
+<li><p>Type <code>ant blackberry build</code> or <code>ant playbook build</code> to update the <code>www/</code> directory with updated Cordova.</p></li>
+<li><p>Open the <code>www/</code> directory and update your HTML to use the new <code>cordova-1.8.0.js</code> file.</p></li>
+<li>
+<p>Open the <code>www/</code> directory and update the <code>plugins.xml</code> file. Two plugins
+changed their namespace/service label. Change the old entries for the
+<a href="cordova_media_capture_capture.md.html#Capture">Capture</a> and <a href="cordova_contacts_contacts.md.html#Contact">Contact</a> plugins from:</p>
+
+<pre class="prettyprint"><code> <plugin name="<a href="cordova_media_capture_capture.md.html#Capture">Capture</a>" value="org.apache.cordova.media.MediaCapture"/>
+ <plugin name="<a href="cordova_contacts_contacts.md.html#Contact">Contact</a>" value="org.apache.cordova.pim.<a href="cordova_contacts_contacts.md.html#Contact">Contact</a>"/>
+</code></pre>
+
+<p>To:</p>
+
+<pre class="prettyprint"><code> <plugin name="<a href="cordova_media_capture_capture.md.html#Capture">Capture</a>" value="org.apache.cordova.capture.MediaCapture"/>
+ <plugin name="<a href="cordova_contacts_contacts.md.html#Contacts">Contacts</a>" value="org.apache.cordova.pim.<a href="cordova_contacts_contacts.md.html#Contact">Contact</a>"/>
+</code></pre>
+</li>
+</ol>
+</div>
+ </div>
+
+ <!-- Functionality and Syntax Highlighting -->
+ <script type="text/javascript" src="index.js"></script><script type="text/javascript" src="prettify/prettify.js"></script>
+</body>
+</html>
Added: cordova/site/public/docs/en/3.1.0/guide_platforms_index.md.html
URL: http://svn.apache.org/viewvc/cordova/site/public/docs/en/3.1.0/guide_platforms_index.md.html?rev=1527865&view=auto
==============================================================================
--- cordova/site/public/docs/en/3.1.0/guide_platforms_index.md.html (added)
+++ cordova/site/public/docs/en/3.1.0/guide_platforms_index.md.html Tue Oct 1 03:55:57 2013
@@ -0,0 +1,221 @@
+<!DOCTYPE html>
+<!--
+ Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+--><html lang="en">
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
+<meta name="viewport" content="initial-scale=1.0, maximum-scale=1.0, user-scalable=no, width=device-width">
+<meta name="generator" content="joDoc">
+<title>Apache Cordova API Documentation</title>
+<link rel="stylesheet" type="text/css" href="index.css">
+<link rel="stylesheet" type="text/css" href="mobile.css" media="only screen and (max-device-width: 1024px)">
+<link rel="stylesheet" type="text/css" href="prettify/prettify.css">
+</head>
+<body>
+ <div id="header">
+ <h1><a href="index.html">Apache <strong>Cordova</strong> Documentation</a></h1>
+ <small>
+ <select><optgroup label="Chinese" value="zh"><option value="edge">edge</option></optgroup>
+<optgroup label="English" value="en">
+<option value="edge">edge</option>
+<option selected value="3.1.0">3.1.0</option>
+<option value="3.0.0">3.0.0</option>
+<option value="2.9.0">2.9.0</option>
+<option value="2.8.0">2.8.0</option>
+<option value="2.7.0">2.7.0</option>
+<option value="2.6.0">2.6.0</option>
+<option value="2.5.0">2.5.0</option>
+<option value="2.4.0">2.4.0</option>
+<option value="2.3.0">2.3.0</option>
+<option value="2.2.0">2.2.0</option>
+<option value="2.1.0">2.1.0</option>
+<option value="2.0.0">2.0.0</option>
+<option value="1.9.0">1.9.0</option>
+<option value="1.8.1">1.8.1</option>
+<option value="1.8.0">1.8.0</option>
+<option value="1.7.0">1.7.0</option>
+<option value="1.6.1">1.6.1</option>
+<option value="1.6.0">1.6.0</option>
+<option value="1.5.0">1.5.0</option>
+</optgroup>
+<optgroup label="French" value="fr"><option value="edge">edge</option></optgroup>
+<optgroup label="German" value="de"><option value="edge">edge</option></optgroup>
+<optgroup label="Italian" value="it"><option value="edge">edge</option></optgroup>
+<optgroup label="Japanese" value="ja">
+<option value="edge">edge</option>
+<option value="2.2.0">2.2.0</option>
+<option value="2.1.0">2.1.0</option>
+<option value="2.0.0">2.0.0</option>
+<option value="1.9.0">1.9.0</option>
+<option value="1.8.1">1.8.1</option>
+<option value="1.7.0">1.7.0</option>
+</optgroup>
+<optgroup label="Korean" value="ko">
+<option value="edge">edge</option>
+<option value="2.0.0">2.0.0</option>
+</optgroup>
+<optgroup label="Russian" value="ru"><option value="edge">edge</option></optgroup>
+<optgroup label="Spanish" value="es"><option value="edge">edge</option></optgroup></select></small>
+ </div>
+ <div id="subheader">
+ <h1>Platform Guides</h1>
+ <small><select><option value="Platform%2520Guides">Platform Guides</option>
+<option value="Platform%20Guides_android">Â Â Â Â Â Â - Android</option>
+<option value="Platform%20Guides_blackberry">Â Â Â Â Â Â - BlackBerry</option>
+<option value="Platform%20Guides_blackberry_10">Â Â Â Â Â Â - BlackBerry 10</option>
+<option value="Platform%20Guides_ios">Â Â Â Â Â Â - iOS</option>
+<option value="Platform%20Guides_windows_phone">Â Â Â Â Â Â - Windows Phone</option>
+<option value="Platform%20Guides_windows_8">Â Â Â Â Â Â - Windows 8</option>
+<option value="Platform%20Guides_tizen">Â Â Â Â Â Â - Tizen</option></select></small>
+ </div>
+
+ <div id="sidebar">
+ <div class="vertical_divider"></div>
+ <h1>Guides</h1>
+<ul>
+<li><a href="guide_overview_index.md.html#Overview">Overview</a></li>
+<li><a href="guide_cli_index.md.html#The%20Command-line%20Interface">The Command-line Interface</a></li>
+<li><a href="guide_platforms_index.md.html#Platform%20Guides">Platform Guides</a></li>
+<li><a href="config_ref_index.md.html#The%20config.xml%20File">The config.xml File</a></li>
+<li><a href="guide_hybrid_webviews_index.md.html#Embedding%20WebViews">Embedding WebViews</a></li>
+<li><a href="guide_hybrid_plugins_index.md.html#Plugin%20Development%20Guide">Plugin Development Guide</a></li>
+<li><a href="guide_appdev_privacy_index.md.html#Privacy%20Guide">Privacy Guide</a></li>
+<li><a href="guide_appdev_whitelist_index.md.html#Domain%20Whitelist%20Guide">Domain Whitelist Guide</a></li>
+<li><a href="_index.html">Keyword Index</a></li>
+</ul>
+<h1>API Reference</h1>
+<ul>
+<li><a href="cordova_accelerometer_accelerometer.md.html#Accelerometer">Accelerometer</a></li>
+<li><a href="cordova_camera_camera.md.html#Camera">Camera</a></li>
+<li><a href="cordova_media_capture_capture.md.html#Capture">Capture</a></li>
+<li><a href="cordova_compass_compass.md.html#Compass">Compass</a></li>
+<li><a href="cordova_connection_connection.md.html#Connection">Connection</a></li>
+<li><a href="cordova_contacts_contacts.md.html#Contacts">Contacts</a></li>
+<li><a href="cordova_device_device.md.html#Device">Device</a></li>
+<li><a href="cordova_events_events.md.html#Events">Events</a></li>
+<li><a href="cordova_file_file.md.html#File">File</a></li>
+<li><a href="cordova_geolocation_geolocation.md.html#Geolocation">Geolocation</a></li>
+<li><a href="cordova_globalization_globalization.md.html#Globalization">Globalization</a></li>
+<li><a href="cordova_inappbrowser_inappbrowser.md.html#InAppBrowser">InAppBrowser</a></li>
+<li><a href="cordova_media_media.md.html#Media">Media</a></li>
+<li><a href="cordova_notification_notification.md.html#Notification">Notification</a></li>
+<li><a href="cordova_splashscreen_splashscreen.md.html#Splashscreen">Splashscreen</a></li>
+<li><a href="cordova_storage_storage.md.html#Storage">Storage</a></li>
+</ul>
+</div>
+
+ <div id="scrollable">
+ <div id="content">
+ <h1><a name="Platform%20Guides">Platform Guides</a></h1>
+
+<p>Before developing for any of the platforms listed below, install
+cordova's command-line interface (CLI).
+(For details, see <a href="guide_cli_index.md.html#The%20Command-line%20Interface">The Command-line Interface</a>.)</p>
+
+<p>To develop Cordova applications, you must install SDKs for each mobile
+platform you are targeting. This installation is necessary regardless
+of whether you do the majority of your work in the SDK or use the CLI
+for your build cycle.</p>
+
+<p>Each <em>Platform Guide</em> listed below tells you what you need to know to
+set up each platform's development environment: where to obtain the
+SDK, how to set up device emulators, how to connect devices for direct
+testing, and how to manage signing key requirements. Additional
+guides provide information on each platform's unique set of
+configuration options, instructions to add plugins, how to upgrade
+each platform, and platform-specific command-line tools that serve as
+a lower-level alternative to the <code>cordova</code> command-line utility.</p>
+
+<h2>
+<a name="Platform%20Guides_android">Android</a>
+</h2>
+
+<ul>
+<li><a href="guide_platforms_android_index.md.html#Android%20Platform%20Guide">Android Platform Guide</a></li>
+<li><a href="guide_platforms_android_config.md.html#Android%20Configuration">Android Configuration</a></li>
+<li><a href="guide_platforms_android_webview.md.html#Android%20WebViews">Android WebViews</a></li>
+<li><a href="guide_platforms_android_plugin.md.html#Android%20Plugins">Android Plugins</a></li>
+<li><a href="guide_platforms_android_tools.md.html#Android%20Command-line%20Tools">Android Command-line Tools</a></li>
+<li><a href="guide_platforms_android_upgrading.md.html#Upgrading%20Android">Upgrading Android</a></li>
+</ul>
+<h2>
+<a name="Platform%20Guides_blackberry">BlackBerry</a>
+</h2>
+
+<ul>
+<li><a href="guide_platforms_blackberry_index.md.html#BlackBerry%20Platform%20Guide">BlackBerry Platform Guide</a></li>
+<li><a href="guide_platforms_blackberry10_config.md.html#BlackBerry%20Configuration">BlackBerry Configuration</a></li>
+<li><a href="guide_platforms_blackberry_tools.md.html#BlackBerry%20Command-line%20Tools">BlackBerry Command-line Tools</a></li>
+<li><a href="guide_platforms_blackberry10_upgrading.md.html#Upgrading%20BlackBerry">Upgrading BlackBerry</a></li>
+</ul>
+<h2>
+<a name="Platform%20Guides_blackberry_10">BlackBerry 10</a>
+</h2>
+
+<ul>
+<li><a href="guide_platforms_blackberry10_index.md.html#BlackBerry%2010%20Platform%20Guide">BlackBerry 10 Platform Guide</a></li>
+<li>BlackBerry 10 Configuration</li>
+<li><a href="guide_platforms_blackberry10_plugin.md.html#BlackBerry%2010%20Plugins">BlackBerry 10 Plugins</a></li>
+<li><a href="guide_platforms_blackberry10_tools.md.html#BlackBerry%2010%20Command-line%20Tools">BlackBerry 10 Command-line Tools</a></li>
+</ul>
+<h2>
+<a name="Platform%20Guides_ios">iOS</a>
+</h2>
+
+<ul>
+<li><a href="guide_platforms_ios_index.md.html#iOS%20Platform%20Guide">iOS Platform Guide</a></li>
+<li><a href="guide_platforms_ios_config.md.html#iOS%20Configuration">iOS Configuration</a></li>
+<li><a href="guide_platforms_ios_webview.md.html#iOS%20WebViews">iOS WebViews</a></li>
+<li><a href="guide_platforms_ios_plugin.md.html#iOS%20Plugins">iOS Plugins</a></li>
+<li><a href="guide_platforms_ios_tools.md.html#iOS%20Command-line%20Tools">iOS Command-line Tools</a></li>
+<li><a href="guide_platforms_ios_upgrading.md.html#Upgrading%20iOS">Upgrading iOS</a></li>
+</ul>
+<h2>
+<a name="Platform%20Guides_windows_phone">Windows Phone</a>
+</h2>
+
+<ul>
+<li><a href="guide_platforms_wp8_index.md.html#Windows%20Phone%208%20Platform%20Guide">Windows Phone 8 Platform Guide</a></li>
+<li><a href="guide_platforms_wp7_index.md.html#Windows%20Phone%207%20Platform%20Guide">Windows Phone 7 Platform Guide</a></li>
+<li>Windows Phone Configuration</li>
+<li><a href="guide_platforms_wp8_tools.md.html#Windows%20Phone%20Command-line%20Tools">Windows Phone Command-line Tools</a></li>
+<li><a href="guide_platforms_wp8_upgrading.md.html#Upgrading%20Windows%20Phone">Upgrading Windows Phone</a></li>
+</ul>
+<h2>
+<a name="Platform%20Guides_windows_8">Windows 8</a>
+</h2>
+
+<ul>
+<li><a href="guide_platforms_win8_index.md.html#Windows%208%20Platform%20Guide">Windows 8 Platform Guide</a></li>
+<li><a href="guide_platforms_win8_tools.md.html#Windows%208%20Command-line%20Tools">Windows 8 Command-line Tools</a></li>
+<li><a href="guide_platforms_win8_upgrading.md.html#Upgrading%20Windows%208">Upgrading Windows 8</a></li>
+</ul>
+<h2>
+<a name="Platform%20Guides_tizen">Tizen</a>
+</h2>
+
+<ul>
+<li><a href="guide_platforms_tizen_index.md.html#Tizen%20Platform%20Guide">Tizen Platform Guide</a></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>
Added: cordova/site/public/docs/en/3.1.0/guide_platforms_ios_config.md.html
URL: http://svn.apache.org/viewvc/cordova/site/public/docs/en/3.1.0/guide_platforms_ios_config.md.html?rev=1527865&view=auto
==============================================================================
--- cordova/site/public/docs/en/3.1.0/guide_platforms_ios_config.md.html (added)
+++ cordova/site/public/docs/en/3.1.0/guide_platforms_ios_config.md.html Tue Oct 1 03:55:57 2013
@@ -0,0 +1,262 @@
+<!DOCTYPE html>
+<!--
+ Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+--><html lang="en">
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
+<meta name="viewport" content="initial-scale=1.0, maximum-scale=1.0, user-scalable=no, width=device-width">
+<meta name="generator" content="joDoc">
+<title>Apache Cordova API Documentation</title>
+<link rel="stylesheet" type="text/css" href="index.css">
+<link rel="stylesheet" type="text/css" href="mobile.css" media="only screen and (max-device-width: 1024px)">
+<link rel="stylesheet" type="text/css" href="prettify/prettify.css">
+</head>
+<body>
+ <div id="header">
+ <h1><a href="index.html">Apache <strong>Cordova</strong> Documentation</a></h1>
+ <small>
+ <select><optgroup label="Chinese" value="zh"><option value="edge">edge</option></optgroup>
+<optgroup label="English" value="en">
+<option value="edge">edge</option>
+<option selected value="3.1.0">3.1.0</option>
+<option value="3.0.0">3.0.0</option>
+<option value="2.9.0">2.9.0</option>
+<option value="2.8.0">2.8.0</option>
+<option value="2.7.0">2.7.0</option>
+<option value="2.6.0">2.6.0</option>
+<option value="2.5.0">2.5.0</option>
+<option value="2.4.0">2.4.0</option>
+<option value="2.3.0">2.3.0</option>
+<option value="2.2.0">2.2.0</option>
+<option value="2.1.0">2.1.0</option>
+<option value="2.0.0">2.0.0</option>
+<option value="1.9.0">1.9.0</option>
+<option value="1.8.1">1.8.1</option>
+<option value="1.8.0">1.8.0</option>
+<option value="1.7.0">1.7.0</option>
+<option value="1.6.1">1.6.1</option>
+<option value="1.6.0">1.6.0</option>
+<option value="1.5.0">1.5.0</option>
+</optgroup>
+<optgroup label="French" value="fr"><option value="edge">edge</option></optgroup>
+<optgroup label="German" value="de"><option value="edge">edge</option></optgroup>
+<optgroup label="Italian" value="it"><option value="edge">edge</option></optgroup>
+<optgroup label="Japanese" value="ja">
+<option value="edge">edge</option>
+<option value="2.2.0">2.2.0</option>
+<option value="2.1.0">2.1.0</option>
+<option value="2.0.0">2.0.0</option>
+<option value="1.9.0">1.9.0</option>
+<option value="1.8.1">1.8.1</option>
+<option value="1.7.0">1.7.0</option>
+</optgroup>
+<optgroup label="Korean" value="ko">
+<option value="edge">edge</option>
+<option value="2.0.0">2.0.0</option>
+</optgroup>
+<optgroup label="Russian" value="ru"><option value="edge">edge</option></optgroup>
+<optgroup label="Spanish" value="es"><option value="edge">edge</option></optgroup></select></small>
+ </div>
+ <div id="subheader">
+ <h1>iOS Configuration</h1>
+ <small></small>
+ </div>
+
+ <div id="sidebar">
+ <div class="vertical_divider"></div>
+ <h1>Guides</h1>
+<ul>
+<li><a href="guide_overview_index.md.html#Overview">Overview</a></li>
+<li><a href="guide_cli_index.md.html#The%20Command-line%20Interface">The Command-line Interface</a></li>
+<li><a href="guide_platforms_index.md.html#Platform%20Guides">Platform Guides</a></li>
+<li><a href="config_ref_index.md.html#The%20config.xml%20File">The config.xml File</a></li>
+<li><a href="guide_hybrid_webviews_index.md.html#Embedding%20WebViews">Embedding WebViews</a></li>
+<li><a href="guide_hybrid_plugins_index.md.html#Plugin%20Development%20Guide">Plugin Development Guide</a></li>
+<li><a href="guide_appdev_privacy_index.md.html#Privacy%20Guide">Privacy Guide</a></li>
+<li><a href="guide_appdev_whitelist_index.md.html#Domain%20Whitelist%20Guide">Domain Whitelist Guide</a></li>
+<li><a href="_index.html">Keyword Index</a></li>
+</ul>
+<h1>API Reference</h1>
+<ul>
+<li><a href="cordova_accelerometer_accelerometer.md.html#Accelerometer">Accelerometer</a></li>
+<li><a href="cordova_camera_camera.md.html#Camera">Camera</a></li>
+<li><a href="cordova_media_capture_capture.md.html#Capture">Capture</a></li>
+<li><a href="cordova_compass_compass.md.html#Compass">Compass</a></li>
+<li><a href="cordova_connection_connection.md.html#Connection">Connection</a></li>
+<li><a href="cordova_contacts_contacts.md.html#Contacts">Contacts</a></li>
+<li><a href="cordova_device_device.md.html#Device">Device</a></li>
+<li><a href="cordova_events_events.md.html#Events">Events</a></li>
+<li><a href="cordova_file_file.md.html#File">File</a></li>
+<li><a href="cordova_geolocation_geolocation.md.html#Geolocation">Geolocation</a></li>
+<li><a href="cordova_globalization_globalization.md.html#Globalization">Globalization</a></li>
+<li><a href="cordova_inappbrowser_inappbrowser.md.html#InAppBrowser">InAppBrowser</a></li>
+<li><a href="cordova_media_media.md.html#Media">Media</a></li>
+<li><a href="cordova_notification_notification.md.html#Notification">Notification</a></li>
+<li><a href="cordova_splashscreen_splashscreen.md.html#Splashscreen">Splashscreen</a></li>
+<li><a href="cordova_storage_storage.md.html#Storage">Storage</a></li>
+</ul>
+</div>
+
+ <div id="scrollable">
+ <div id="content">
+ <h1><a name="iOS%20Configuration">iOS Configuration</a></h1>
+
+<p>The <code>config.xml</code> file controls an app's basic settings that apply
+across each application and CordovaWebView instance. This section
+details preferences that only apply to iOS builds. See <a href="#The%20config.xml%0AFile">The config.xml
+File</a> for information on global configuration options.</p>
+
+<ul>
+<li>
+<p><code>EnableViewportScale</code> (boolean, defaults to <code>false</code>): Set to <code>true</code>
+to use a viewport meta tag to either disable or restrict the range
+of user scaling. </p>
+
+<pre class="prettyprint"><code><preference name="EnableViewportScale" value="true"/>
+</code></pre>
+</li>
+<li>
+<p><code>MediaPlaybackRequiresUserAction</code> (boolean, defaults to <code>false</code>):
+Set to <code>true</code> to prevent HTML5 videos from playing automatically
+with the <code>autoplay</code> attribute. Does not apply when calling <code>play()</code>
+on a video object.</p>
+
+<pre class="prettyprint"><code><preference name="MediaPlaybackRequiresUserAction" value="true"/>
+</code></pre>
+</li>
+<li>
+<p><code>AllowInlineMediaPlayback</code> (boolean, defaults to <code>false</code>): Set to
+<code>true</code> to allow HTML5 media playback to appear <em>inline</em> within the
+screen layout, using browser-supplied controls rather than native
+controls. For this to work, add the <code>webkit-playsinline</code> attribute
+to any <code><video></code> elements.</p>
+
+<pre class="prettyprint"><code><preference name="AllowInlineMediaPlayback" value="true"/>
+</code></pre>
+</li>
+<li>
+<p><code>BackupWebStorage</code> (string, either <code>none</code>, <code>local</code>, or the default
+<code>cloud</code>): Set to <code>cloud</code> to allow web storage data to backup via
+iCloud. Set to <code>local</code> to allow only local backups via iTunes
+sync. Set to <code>none</code> prevent web storage backups.</p>
+
+<pre class="prettyprint"><code><preference name="BackupWebStorage" value="local"/>
+</code></pre>
+</li>
+<li>
+<p><code>TopActivityIndicator</code> (string, defaults to <code>gray</code>): Controls the
+appearance of the small spinning icon in the status bar that
+indicates significant processor activity. Valid values are
+<code>whiteLarge</code>, <code>white</code>, and <code>gray</code>.</p>
+
+<pre class="prettyprint"><code><preference name="TopActivityIndicator" value="white"/>
+</code></pre>
+</li>
+<li>
+<p><code>FadeSplashScreen</code> (boolean, defaults to <code>true</code>): Set to <code>false</code> to
+prevent the splash screen from fading in and out when its display
+state changes.</p>
+
+<pre class="prettyprint"><code><preference name="FadeSplashScreen" value="false"/>
+</code></pre>
+</li>
+<li>
+<p><code>FadeSplashScreenDuration</code> (float, defaults to <code>2</code>): Specifies the
+number of seconds for the splash screen fade effect to execute.</p>
+
+<pre class="prettyprint"><code><preference name="FadeSplashScreenDuration" value="4"/>
+</code></pre>
+</li>
+<li>
+<p><code>ShowSplashScreenSpinner</code> (boolean, defaults to <code>true</code>): Set to <code>false</code>
+to hide the splash-screen spinner.</p>
+
+<pre class="prettyprint"><code><preference name="ShowSplashScreenSpinner" value="false"/>
+</code></pre>
+</li>
+<li>
+<p><code>KeyboardDisplayRequiresUserAction</code> (boolean, defaults to <code>true</code>):
+Set to <code>false</code> to allow the keyboard to appear when calling
+<code>focus()</code> on form inputs.</p>
+
+<pre class="prettyprint"><code><preference name="KeyboardDisplayRequiresUserAction" value="false"/>
+</code></pre>
+</li>
+<li>
+<p><code>SuppressesIncrementalRendering</code> (boolean, defaults to <code>false</code>): Set
+to <code>true</code> to wait until all content has been received before it
+renders to the screen.</p>
+
+<pre class="prettyprint"><code><preference name="SuppressesIncrementalRendering" value="true"/>
+</code></pre>
+</li>
+<li>
+<p><code>KeyboardShrinksView</code> (boolean, defaults to <code>false</code>): Set to <code>true</code>
+to scale down the webview when the keyboard appears, overriding the
+default beavior that shrinks the viewport vertically. This matches
+the default behaviour for Android apps.</p>
+
+<pre class="prettyprint"><code><preference name="KeyboardShrinksView" value="true"/>
+</code></pre>
+</li>
+<li>
+<p><code>GapBetweenPages</code> (float, defaults to <code>0</code>): The size of the gap, in points, between pages.</p>
+
+<pre class="prettyprint"><code><preference name="GapBetweenPages" value="0"/>
+</code></pre>
+</li>
+<li>
+<p><code>PageLength</code> (float, defaults to <code>0</code>): The size of each page, in points, in the
+direction that the pages flow. When PaginationMode is right to left or left to right,
+this property represents the width of each page. When PaginationMode is topToBottom
+or bottomToTop, this property represents the height of each page. The default value
+is 0, which means the layout uses the size of the viewport to determine the dimensions
+of the page.</p>
+
+<pre class="prettyprint"><code><preference name="PageLength" value="0"/>
+</code></pre>
+</li>
+<li>
+<p><code>PaginationBreakingMode</code> (string, defaults to <code>page</code>): Valid values are <code>page</code> and
+<code>column</code>.The manner in which column- or page-breaking occurs. This property
+determines whether certain CSS properties regarding column- and page-breaking are
+honored or ignored. When this property is set to <code>column</code>, the content respects
+the CSS properties related to column-breaking in place of page-breaking.</p>
+
+<pre class="prettyprint"><code><preference name="PaginationBreakingMode" value="page"/>
+</code></pre>
+</li>
+<li>
+<p><code>PaginationMode</code> (string, defaults to <code>unpaginated</code>): Valid values are <code>unpaginated</code>,
+<code>leftToRight</code>, <code>topToBottom</code>, <code>bottomToTop</code>, and <code>rightToLeft</code>. This property determines
+whether content in the web view is broken up into pages that fill the view one screen
+at a time, or shown as one long scrolling view. If set to a paginated form, this
+property toggles a paginated layout on the content, causing the web view to use the
+values of PageLength and GapBetweenPages to relayout its content.</p>
+
+<pre class="prettyprint"><code><preference name="PaginationMode" value="unpaginated"/>
+</code></pre>
+</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>
Added: cordova/site/public/docs/en/3.1.0/guide_platforms_ios_index.md.html
URL: http://svn.apache.org/viewvc/cordova/site/public/docs/en/3.1.0/guide_platforms_ios_index.md.html?rev=1527865&view=auto
==============================================================================
--- cordova/site/public/docs/en/3.1.0/guide_platforms_ios_index.md.html (added)
+++ cordova/site/public/docs/en/3.1.0/guide_platforms_ios_index.md.html Tue Oct 1 03:55:57 2013
@@ -0,0 +1,358 @@
+<!DOCTYPE html>
+<!--
+ Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+--><html lang="en">
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
+<meta name="viewport" content="initial-scale=1.0, maximum-scale=1.0, user-scalable=no, width=device-width">
+<meta name="generator" content="joDoc">
+<title>Apache Cordova API Documentation</title>
+<link rel="stylesheet" type="text/css" href="index.css">
+<link rel="stylesheet" type="text/css" href="mobile.css" media="only screen and (max-device-width: 1024px)">
+<link rel="stylesheet" type="text/css" href="prettify/prettify.css">
+</head>
+<body>
+ <div id="header">
+ <h1><a href="index.html">Apache <strong>Cordova</strong> Documentation</a></h1>
+ <small>
+ <select><optgroup label="Chinese" value="zh"><option value="edge">edge</option></optgroup>
+<optgroup label="English" value="en">
+<option value="edge">edge</option>
+<option selected value="3.1.0">3.1.0</option>
+<option value="3.0.0">3.0.0</option>
+<option value="2.9.0">2.9.0</option>
+<option value="2.8.0">2.8.0</option>
+<option value="2.7.0">2.7.0</option>
+<option value="2.6.0">2.6.0</option>
+<option value="2.5.0">2.5.0</option>
+<option value="2.4.0">2.4.0</option>
+<option value="2.3.0">2.3.0</option>
+<option value="2.2.0">2.2.0</option>
+<option value="2.1.0">2.1.0</option>
+<option value="2.0.0">2.0.0</option>
+<option value="1.9.0">1.9.0</option>
+<option value="1.8.1">1.8.1</option>
+<option value="1.8.0">1.8.0</option>
+<option value="1.7.0">1.7.0</option>
+<option value="1.6.1">1.6.1</option>
+<option value="1.6.0">1.6.0</option>
+<option value="1.5.0">1.5.0</option>
+</optgroup>
+<optgroup label="French" value="fr"><option value="edge">edge</option></optgroup>
+<optgroup label="German" value="de"><option value="edge">edge</option></optgroup>
+<optgroup label="Italian" value="it"><option value="edge">edge</option></optgroup>
+<optgroup label="Japanese" value="ja">
+<option value="edge">edge</option>
+<option value="2.2.0">2.2.0</option>
+<option value="2.1.0">2.1.0</option>
+<option value="2.0.0">2.0.0</option>
+<option value="1.9.0">1.9.0</option>
+<option value="1.8.1">1.8.1</option>
+<option value="1.7.0">1.7.0</option>
+</optgroup>
+<optgroup label="Korean" value="ko">
+<option value="edge">edge</option>
+<option value="2.0.0">2.0.0</option>
+</optgroup>
+<optgroup label="Russian" value="ru"><option value="edge">edge</option></optgroup>
+<optgroup label="Spanish" value="es"><option value="edge">edge</option></optgroup></select></small>
+ </div>
+ <div id="subheader">
+ <h1>iOS Platform Guide</h1>
+ <small><select><option value="iOS%2520Platform%2520Guide">iOS Platform Guide</option>
+<option value="iOS%20Platform%20Guide_requirements_and_support">Â Â Â Â Â Â - Requirements and Support</option>
+<option value="iOS%20Platform%20Guide_install_the_sdk">Â Â Â Â Â Â - Install the SDK</option>
+<option value="iOS%20Platform%20Guide_open_a_project_in_the_sdk">Â Â Â Â Â Â - Open a Project in the SDK</option>
+<option value="iOS%20Platform%20Guide_deploy_to_emulator">Â Â Â Â Â Â - Deploy to Emulator</option>
+<option value="iOS%20Platform%20Guide_deploy_to_device">Â Â Â Â Â Â - Deploy to Device
+</option>
+<option value="iOS%20Platform%20Guide_common_problems">Â Â Â Â Â Â - Common Problems</option></select></small>
+ </div>
+
+ <div id="sidebar">
+ <div class="vertical_divider"></div>
+ <h1>Guides</h1>
+<ul>
+<li><a href="guide_overview_index.md.html#Overview">Overview</a></li>
+<li><a href="guide_cli_index.md.html#The%20Command-line%20Interface">The Command-line Interface</a></li>
+<li><a href="guide_platforms_index.md.html#Platform%20Guides">Platform Guides</a></li>
+<li><a href="config_ref_index.md.html#The%20config.xml%20File">The config.xml File</a></li>
+<li><a href="guide_hybrid_webviews_index.md.html#Embedding%20WebViews">Embedding WebViews</a></li>
+<li><a href="guide_hybrid_plugins_index.md.html#Plugin%20Development%20Guide">Plugin Development Guide</a></li>
+<li><a href="guide_appdev_privacy_index.md.html#Privacy%20Guide">Privacy Guide</a></li>
+<li><a href="guide_appdev_whitelist_index.md.html#Domain%20Whitelist%20Guide">Domain Whitelist Guide</a></li>
+<li><a href="_index.html">Keyword Index</a></li>
+</ul>
+<h1>API Reference</h1>
+<ul>
+<li><a href="cordova_accelerometer_accelerometer.md.html#Accelerometer">Accelerometer</a></li>
+<li><a href="cordova_camera_camera.md.html#Camera">Camera</a></li>
+<li><a href="cordova_media_capture_capture.md.html#Capture">Capture</a></li>
+<li><a href="cordova_compass_compass.md.html#Compass">Compass</a></li>
+<li><a href="cordova_connection_connection.md.html#Connection">Connection</a></li>
+<li><a href="cordova_contacts_contacts.md.html#Contacts">Contacts</a></li>
+<li><a href="cordova_device_device.md.html#Device">Device</a></li>
+<li><a href="cordova_events_events.md.html#Events">Events</a></li>
+<li><a href="cordova_file_file.md.html#File">File</a></li>
+<li><a href="cordova_geolocation_geolocation.md.html#Geolocation">Geolocation</a></li>
+<li><a href="cordova_globalization_globalization.md.html#Globalization">Globalization</a></li>
+<li><a href="cordova_inappbrowser_inappbrowser.md.html#InAppBrowser">InAppBrowser</a></li>
+<li><a href="cordova_media_media.md.html#Media">Media</a></li>
+<li><a href="cordova_notification_notification.md.html#Notification">Notification</a></li>
+<li><a href="cordova_splashscreen_splashscreen.md.html#Splashscreen">Splashscreen</a></li>
+<li><a href="cordova_storage_storage.md.html#Storage">Storage</a></li>
+</ul>
+</div>
+
+ <div id="scrollable">
+ <div id="content">
+ <h1><a name="iOS%20Platform%20Guide">iOS Platform Guide</a></h1>
+
+<p>This guide shows how to set up your SDK development environment to
+deploy Cordova apps for iOS devices such as iPhone and iPad. See the
+following for more detailed platform-specific information:</p>
+
+<ul>
+<li><a href="guide_platforms_ios_config.md.html#iOS%20Configuration">iOS Configuration</a></li>
+<li><a href="guide_platforms_ios_upgrading.md.html#Upgrading%20iOS">Upgrading iOS</a></li>
+<li><a href="guide_platforms_ios_webview.md.html#iOS%20WebViews">iOS WebViews</a></li>
+<li><a href="guide_platforms_ios_plugin.md.html#iOS%20Plugins">iOS Plugins</a></li>
+<li><a href="guide_platforms_ios_tools.md.html#iOS%20Command-line%20Tools">iOS Command-line Tools</a></li>
+</ul>
+<p>The command-line tools above refer to versions prior to Cordova 3.0.
+See <a href="guide_cli_index.md.html#The%20Command-line%20Interface">The Command-line Interface</a> for information about the
+current interface.</p>
+
+<h2>
+<a name="iOS%20Platform%20Guide_requirements_and_support">Requirements and Support</a>
+</h2>
+
+<p>Apple® tools required to build iOS applications run only on the OS X
+operating system on Intel-based Macs. Xcode® 4.5 (the minimum required
+version) runs only on OS X version 10.7 (Lion) or greater, and
+includes the iOS 6 SDK (Software Development Kit). To submit apps to
+the Apple App Storeâ requires the latest versions of the Apple tools.</p>
+
+<p>You can test many of the Cordova features using the iOS emulator
+installed with the iOS SDK and Xcode, but you need an actual device to
+fully test all of the app's device features before submitting to the
+App Store. The device must have at least iOS 5.x installed, the
+minimum iOS version supported as of Cordova 2.3. Supporting devices
+include all iPad® models, iPhone® 3GS and above, and iPod® Touch 3rd
+Generation or later. To install apps onto a device, you must also be a
+member of Apple's
+<a class="external" href="https://developer.apple.com/programs/ios/">iOS Developer Program</a>,
+which costs $99 per year. This guide shows how to deploy apps to the
+iOS emulator, for which you don't need to register with the developer
+program.</p>
+
+<h2>
+<a name="iOS%20Platform%20Guide_install_the_sdk">Install the SDK</a>
+</h2>
+
+<p>There are two ways to download Xcode:</p>
+
+<ul>
+<li><p>from the <a class="external" href="https://itunes.apple.com/us/app/xcode/id497799835?mt=12">App Store</a>,
+available by searching for "Xcode" in the <strong>App Store</strong> application.</p></li>
+<li><p>from <a class="external" href="https://developer.apple.com/downloads/index.action">Apple Developer Downloads</a>,
+which requires registration as an Apple Developer.</p></li>
+</ul>
+<p>Once Xcode is installed, several command-line tools need to be enabled
+for Cordova to run. From the <strong>Xcode</strong> menu, select <strong>Preferences</strong>,
+then the <strong>Downloads</strong> tab. From the <strong>Components</strong> panel, press the
+<strong>Install</strong> button next to the <strong>Command Line Tools</strong> listing.</p>
+
+<h2>
+<a name="iOS%20Platform%20Guide_open_a_project_in_the_sdk">Open a Project in the SDK</a>
+</h2>
+
+<p>Use the <code>cordova</code> utility to set up a new project, as described in The
+Cordova <a href="guide_cli_index.md.html#The%20Command-line%20Interface">The Command-line Interface</a>. For example, in a source-code directory:</p>
+
+<pre class="prettyprint"><code> $ cordova create hello com.example.hello "HelloWorld"
+ $ cd hello
+ $ cordova platform add ios
+ $ cordova prepare # or "cordova build"
+</code></pre>
+
+<p>Once created, you can open it from within Xcode. Double-click to open
+the <code>hello/platforms/ios/hello.xcodeproj</code> file. The screen should
+look like this:</p>
+
+<p><img src="img/guide/platforms/ios/helloworld_project.png" alt="" title=""></p>
+
+<h2>
+<a name="iOS%20Platform%20Guide_deploy_to_emulator">Deploy to Emulator</a>
+</h2>
+
+<p>To preview the app in the iOS emulator:</p>
+
+<ol>
+<li><p>Make sure the <em>.xcodeproj</em> file is selected in the left panel.</p></li>
+<li><p>Select the <strong>hello</strong> app in the panel immediately to the right.</p></li>
+<li>
+<p>Select the intended device from the toolbar's <strong>Scheme</strong> menu, such
+as the iPhone 6.0 Simulator as highlighted here:</p>
+
+<p><img src="img/guide/platforms/ios/select_xcode_scheme.png" alt="" title=""></p>
+</li>
+<li>
+<p>Press the <strong>Run</strong> button that appears in the same toolbar to the
+left of the <strong>Scheme</strong>. That builds, deploys and runs the
+application in the emulator. A separate emulator application opens
+to display the app:</p>
+
+<p><img src="img/guide/platforms/ios/HelloWorldStandard.png" alt="" title=""></p>
+
+<p>Only one emulator may run at a time, so if you want to test the app
+in a different emulator, you need to quit the emulator application
+and run a different target within Xcode.</p>
+</li>
+</ol>
+<p>Xcode comes bundled with emulators for the lastest versions of iPhone
+and iPad. Older versions may be available from the <strong>Xcode â
+Preferences â Downloads â Components</strong> panel.</p>
+
+<h2>
+<a name="iOS%20Platform%20Guide_deploy_to_device">Deploy to Device
+</a>
+</h2>
+
+<p>For details about various requirements to deploy to a device, refer
+to the <em>Configuring Development and Distribution Assets</em> section of
+Apple's
+<a class="external" href="http://developer.apple.com/library/ios/#documentation/Xcode/Conceptual/ios_development_workflow/00-About_the_iOS_Application_Development_Workflow/introduction.html#//apple_ref/doc/uid/TP40007959">Tools Workflow Guide for iOS</a>.
+Briefly, you need to do the following before deploying:</p>
+
+<ol>
+<li><p>Join the Apple iOS Developer Program.</p></li>
+<li><p>Create a <em>Provisioning Profile</em> within the
+<a class="external" href="https://developer.apple.com/ios/manage/overview/index.action">iOS Provisioning Portal</a>.
+You can use its <em>Development Provisioning Assistant</em> to create and
+install the profile and certificate Xcode requires.</p></li>
+<li><p>Verify that the <em>Code Signing</em> section's <em>Code Signing Identity</em>
+within the project settings is set to your provisioning profile
+name.</p></li>
+</ol>
+<p>To deploy to the device:</p>
+
+<ol>
+<li><p>Use the USB cable to plug the device into your Mac.</p></li>
+<li><p>Select the name of the project in the Xcode window's <strong>Scheme</strong>
+drop-down list.</p></li>
+<li><p>Select your device from the <strong><a href="cordova_device_device.md.html#Device">Device</a></strong> drop-down list. If it is
+plugged in via USB but still does not appear, press the
+<strong>Organizer</strong> button to resolve any errors.</p></li>
+<li><p>Press the <strong>Run</strong> button to build, deploy and run the application
+on your device.</p></li>
+</ol>
+<h2>
+<a name="iOS%20Platform%20Guide_common_problems">Common Problems</a>
+</h2>
+
+<p><strong>Deprecation Warnings:</strong> When an application programming interface
+(API) is changed or replaced by another API, it is marked as
+<em>deprecated</em>. The API still works in the near term, but is eventually
+removed. Some of these deprecated interfaces are reflected in Apache
+Cordova, and Xcode issues warnings about them when you build and
+deploy an application.</p>
+
+<p>Xcode's warning about the <code>invokeString</code> method concerns functionality
+that launches an app from a custom URL. While the mechanism to load
+from a custom URL has changed, this code is still present to provide
+backwards functionality for apps created with older versions of
+Cordova. The sample app does not use this functionality, so these
+warnings can be ignored. To prevent these warnings from appearing,
+remove the code that references the deprecated invokeString API:</p>
+
+<ul>
+<li>
+<p>Edit the <em>Classes/MainViewController.m</em> file, surround the following
+block of code with <code>/*</code> and <code>*/</code> comments as shown below, then type
+<strong>Command-s</strong> to save the file:</p>
+
+<pre class="prettyprint"><code>(void)webViewDidFinishLoad:(UIWebView*)theWebView
+{
+// only valid if ___PROJECTNAME__-Info.plist specifies a protocol to handle
+/*
+if (self.invokeString) {
+ // this is passed before the <a href="cordova_events_events.md.html#deviceready">deviceready</a> event is fired, so you can access it in js when you receive <a href="cordova_events_events.md.html#deviceready">deviceready</a>
+ NSLog(@"DEPRECATED: window.invokeString - use the window.handleOpenURL(url) function instead, which is always called when the app is launched through a custom scheme url.");
+ NSString* jsString = [NSString stringWithFormat:@"var invokeString = \"%@\";", self.invokeString];
+ [theWebView stringByEvaluatingJavaScriptFromString:jsString];
+}
+*/
+// Black base color for background matches the native apps
+theWebView.backgroundColor = [UIColor blackColor];
+
+
+return [super webViewDidFinishLoad:theWebView];
+}
+</code></pre>
+</li>
+<li>
+<p>Edit the <em>Classes/AppViewDelegate.m</em> file, comment out the following
+line by inserting a double slash as shown below, then type
+<strong>Command-s</strong> to save the file:</p>
+
+<pre class="prettyprint"><code>//self.viewController.invokeString = invokeString;
+</code></pre>
+</li>
+<li><p>Press <strong>Command-b</strong> to rebuild the project and eliminate the warnings.</p></li>
+</ul>
+<!-- Does this fix only last until the next "cordova prepare"? --><p><strong>Missing Headers</strong>: Compilation errors relating to missing headers
+result from problems with the build location, and can be fixed
+via Xcode preferences:</p>
+
+<ol>
+<li><p>Select <strong>Xcode â Preferences â Locations</strong>.</p></li>
+<li>
+<p>In the <strong>Derived Data</strong> section, press the <strong>Advanced</strong> button and
+select <strong>Unique</strong> as the <strong>Build Location</strong> as shown here:</p>
+
+<p><img src="img/guide/platforms/ios/xcode_build_location.png" alt="" title=""></p>
+</li>
+</ol>
+<p>This is the default setting for a new Xcode install, but it may be set
+differently following an upgrade from an older version of Xcode.</p>
+
+<p>For further information, consult Apple's documentation:</p>
+
+<ul>
+<li><p><a class="external" href="http://developer.apple.com/library/ios/#referencelibrary/GettingStarted/RoadMapiOS/index.html#//apple_ref/doc/uid/TP40011343">Start Developing iOS Apps Today</a> provides a quick overview of steps for developing iOS Apps.</p></li>
+<li><p><a class="external" href="https://developer.apple.com/membercenter/index.action">Member Center home page</a>
+provides links to several iOS technical resources including
+technical resources, the provisioning portal, distribution guides
+and community forums.</p></li>
+<li><p><a class="external" href="http://developer.apple.com/library/ios/#documentation/Xcode/Conceptual/ios_development_workflow/00-About_the_iOS_Application_Development_Workflow/introduction.html#//apple_ref/doc/uid/TP40007959">Tools Workflow Guide for iOS</a></p></li>
+<li><p><a class="external" href="http://developer.apple.com/library/ios/#documentation/ToolsLanguages/Conceptual/Xcode4UserGuide/000-About_Xcode/about.html#//apple_ref/doc/uid/TP40010215">Xcode 4 User Guide</a></p></li>
+<li><p><a class="external" href="https://developer.apple.com/videos/wwdc/2012/">Session Videos</a> from
+the Apple World Wide Developer Conference 2012 (WWDC2012)</p></li>
+<li><p>The <a class="external" href="http://developer.apple.com/library/mac/#documentation/Darwin/Reference/ManPages/man1/xcode-select.1.html">xcode-select command</a>,
+which helps specify the correct version of Xcode if more than one is installed.</p></li>
+</ul>
+<p>(Mac®, OS X®, Apple®, Xcode®, App Storeâ , iPad®, iPhone®, iPod® and Finder® are Trademarks of Apple Inc.)</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>