cordova-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From marc...@apache.org
Subject svn commit: r1527865 [18/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...
Date Tue, 01 Oct 2013 03:56:01 GMT
Added: cordova/site/public/docs/en/3.1.0/guide_platforms_blackberry10_upgrading.md.html
URL: http://svn.apache.org/viewvc/cordova/site/public/docs/en/3.1.0/guide_platforms_blackberry10_upgrading.md.html?rev=1527865&view=auto
==============================================================================
--- cordova/site/public/docs/en/3.1.0/guide_platforms_blackberry10_upgrading.md.html (added)
+++ cordova/site/public/docs/en/3.1.0/guide_platforms_blackberry10_upgrading.md.html Tue Oct  1 03:55:57 2013
@@ -0,0 +1,556 @@
+<!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_upgrade_to_3_1_0_from_3_0_0">      - Upgrade to 3.1.0 from 3.0.0</option>
+<option value="Upgrading%20BlackBerry_upgrade_to_the_cli_3_0_0_from_2_9_0">      - Upgrade to the CLI (3.0.0) from 2.9.0</option>
+<option value="Upgrading%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.
+Most of these instructions apply to projects created with an older set
+of command-line tools that precede the <code>cordova</code> CLI utility. See <a href="guide_cli_index.md.html#The%20Command-line%20Interface">The Command-line Interface</a> for information how to update the
+version of the CLI.</p>
+
+<h2>
+<a name="Upgrading%20BlackBerry_upgrade_to_3_1_0_from_3_0_0">Upgrade to 3.1.0 from 3.0.0</a>
+</h2>
+
+<ol>
+<li><p>Create a new Apache Cordova 3.1.0 project using the cordova CLI, as
+described in <a href="guide_cli_index.md.html#The%20Command-line%20Interface">The Command-line Interface</a>.</p></li>
+<li><p>Add your platforms to the cordova project, for example: <code>cordova
+platform add blackberry10</code>.</p></li>
+<li><p>Copy the contents of the original project's <code>www</code> directory to the <code>www</code> directory
+at the root of the cordova project you just created.</p></li>
+<li><p>Copy or overwrite any native assets from your original project
+(<code>Resources</code>, etc.)</p></li>
+<li><p>Copy your <code>config.xml</code> into the <code>www</code> directory, and remove any plugin definitions. You will modify settings here instead of the platform directory.</p></li>
+<li><p>Use the cordova CLI tool to install any plugins you need. Note that
+the CLI handles all core APIs as plugins, so they may need to be
+added. Only plugins marked 3.0.0 and above are compatible with the CLI.</p></li>
+<li><p>Build and test.</p></li>
+</ol>
+<p>Please note that the CLI supports the BlackBerry10 platform exclusively. For PlayBook and BBOS, please see Cordova version 2.9.0 and below.</p>
+
+<h2>
+<a name="Upgrading%20BlackBerry_upgrade_to_the_cli_3_0_0_from_2_9_0">Upgrade to the CLI (3.0.0) from 2.9.0</a>
+</h2>
+
+<ol>
+<li><p>Create a new Apache Cordova 3.0.0 project using the cordova CLI, as
+described in <a href="guide_cli_index.md.html#The%20Command-line%20Interface">The Command-line Interface</a>.</p></li>
+<li><p>Add your platforms the the cordova project, for example: <code>cordova
+platform add blackberry10</code>.</p></li>
+<li><p>Copy the contents of the original project's <code>www</code> directory to the <code>www</code> directory
+at the root of the cordova project you just created.</p></li>
+<li><p>Copy or overwrite any native assets from your original project
+(<code>Resources</code>, etc.)</p></li>
+<li><p>Copy your <code>config.xml</code> into the <code>www</code> directory, and remove any plugin definitions. You will modify settings here instead of the platform directory.</p></li>
+<li><p>Use the cordova CLI tool to install any plugins you need. Note that
+the CLI handles all core APIs as plugins, so they may need to be
+added. Only 3.0.0 plugins are compatible with the CLI.</p></li>
+<li><p>Build and test.</p></li>
+</ol>
+<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 directory 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 projects 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 directory 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 directory 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 projects 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 directory 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 directory 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 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.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 (i.e., 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 (i.e., 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 (i.e., 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 (i.e., 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>&lt;plugin name="<a href="cordova_media_capture_capture.md.html#Capture">Capture</a>" value="org.apache.cordova.media.MediaCapture"/&gt;
+&lt;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>"/&gt;
+</code></pre>
+
+<p>To:</p>
+
+<pre class="prettyprint"><code>&lt;plugin name="<a href="cordova_media_capture_capture.md.html#Capture">Capture</a>" value="org.apache.cordova.capture.MediaCapture"/&gt;
+&lt;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>"/&gt;
+</code></pre>
+</li>
+</ol>
+<p>Updating the sample directory (i.e., 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> &lt;plugin name="<a href="cordova_media_capture_capture.md.html#Capture">Capture</a>" value="org.apache.cordova.media.MediaCapture"/&gt;
+ &lt;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>"/&gt;
+</code></pre>
+
+<p>To:</p>
+
+<pre class="prettyprint"><code> &lt;plugin name="<a href="cordova_media_capture_capture.md.html#Capture">Capture</a>" value="org.apache.cordova.capture.MediaCapture"/&gt;
+ &lt;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>"/&gt;
+</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>&lt;plugin name="<a href="cordova_media_capture_capture.md.html#Capture">Capture</a>" value="org.apache.cordova.media.MediaCapture"/&gt;
+&lt;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>"/&gt;
+</code></pre>
+
+<p>To:</p>
+
+<pre class="prettyprint"><code>&lt;plugin name="<a href="cordova_media_capture_capture.md.html#Capture">Capture</a>" value="org.apache.cordova.capture.MediaCapture"/&gt;
+&lt;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>"/&gt;
+</code></pre>
+</li>
+</ol>
+<p>Updating the sample directory (i.e., 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> &lt;plugin name="<a href="cordova_media_capture_capture.md.html#Capture">Capture</a>" value="org.apache.cordova.media.MediaCapture"/&gt;
+ &lt;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>"/&gt;
+</code></pre>
+
+<p>To:</p>
+
+<pre class="prettyprint"><code> &lt;plugin name="<a href="cordova_media_capture_capture.md.html#Capture">Capture</a>" value="org.apache.cordova.capture.MediaCapture"/&gt;
+ &lt;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>"/&gt;
+</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_blackberry_index.md.html
URL: http://svn.apache.org/viewvc/cordova/site/public/docs/en/3.1.0/guide_platforms_blackberry_index.md.html?rev=1527865&view=auto
==============================================================================
--- cordova/site/public/docs/en/3.1.0/guide_platforms_blackberry_index.md.html (added)
+++ cordova/site/public/docs/en/3.1.0/guide_platforms_blackberry_index.md.html Tue Oct  1 03:55:57 2013
@@ -0,0 +1,348 @@
+<!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>BlackBerry Platform Guide</h1>
+            <small><select><option value="BlackBerry%2520Platform%2520Guide">BlackBerry Platform Guide</option>
+<option value="BlackBerry%20Platform%20Guide_requirements_and_support">      - Requirements and Support</option>
+<option value="BlackBerry%20Platform%20Guide_install_the_sdk">      - Install the SDK</option>
+<option value="BlackBerry%20Platform%20Guide_register_for_signing_keys">      - Register for Signing Keys</option>
+<option value="BlackBerry%20Platform%20Guide_install_cordova">      - Install Cordova</option>
+<option value="BlackBerry%20Platform%20Guide_set_up_a_new_project">      - Set up a New Project</option>
+<option value="BlackBerry%20Platform%20Guide_deploy_to_emulator">      - Deploy to Emulator</option>
+<option value="BlackBerry%20Platform%20Guide_deploy_to_device">      - Deploy to Device
+</option>
+<option value="BlackBerry%20Platform%20Guide_additional_information">      - Additional Information</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="BlackBerry%20Platform%20Guide">BlackBerry Platform Guide</a></h1>
+
+<p>This guide shows you how to set up an SDK environment to target
+applications for the BlackBerry platform prior to version 10.  If you
+want to target the most recent version, see the <a href="#BlackBerry%2010%20Platform%0AGuide">BlackBerry 10 Platform
+Guide</a>.  See the following for more detailed platform-specific
+information:</p>
+
+<ul>
+<li><a href="guide_platforms_blackberry10_config.md.html#BlackBerry%20Configuration">BlackBerry Configuration</a></li>
+<li><a href="guide_platforms_blackberry10_upgrading.md.html#Upgrading%20BlackBerry">Upgrading BlackBerry</a></li>
+<li><a href="guide_platforms_blackberry_plugin.md.html#BlackBerry%20Plugins">BlackBerry Plugins</a></li>
+<li><a href="guide_platforms_blackberry_tools.md.html#BlackBerry%20Command-line%20Tools">BlackBerry 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="BlackBerry%20Platform%20Guide_requirements_and_support">Requirements and Support</a>
+</h2>
+
+<p>This version of BlackBerry is not supported by the <code>cordova</code> utility
+described in <a href="guide_cli_index.md.html#The%20Command-line%20Interface">The Command-line Interface</a>, but by a separate set of
+command-line tools. Download the Cordova distribution from
+<a class="external" href="http://cordova.apache.org/#download">cordova.apache.org</a>.</p>
+
+<p>Cordova for BlackBerry relies on the <a class="external" href="https://bdsc.webapps.blackberry.com/html5">BlackBerry WebWorks
+framework</a>, which is
+available for Windows XP (32-bit), Windows 7 (32-bit and 64-bit), and
+Mac (OS X 10.6.4+).  WebWorks applications can <em>only</em> be deployed on
+the following BlackBerry platforms:</p>
+
+<ul>
+<li>BlackBerry OS 5.0 and higher</li>
+<li>BlackBerry PlayBook</li>
+<li>BlackBerry 10 (QNX)</li>
+</ul>
+<p>WebWorks requires the Java Development Kit (JDK). For Windows, use the
+32-bit version of
+<a class="external" href="http://www.oracle.com/technetwork/java/javase/downloads/index.html#jdk">Oracle JDK</a>.
+Java in installed by default on Mac OS X up to version 10.7, which
+requires
+<a class="external" href="http://support.apple.com/kb/DL1421">a separate installation</a>.
+It also requires Apache Ant, which on Mac is part of the Java
+installation. The Windows version is available from
+<a class="external" href="http://ant.apache.org/bindownload.cgi">ant.apache.org</a>.</p>
+
+<h2>
+<a name="BlackBerry%20Platform%20Guide_install_the_sdk">Install the SDK</a>
+</h2>
+
+<p>Download and install the appropriate WebWorks SDK for your
+development. BlackBerry PlayBook and BlackBerry Smartphone WebWorks
+SDKs can be downloaded from the following locations.</p>
+
+<ul>
+<li><p>[BlackBerry PlayBook SDK] (https://developer.blackberry.com/html5/download/#playbook) and <a class="external" href="http://www.adobe.com/devnet/air/air-sdk-download.html">Adobe Air SDK</a></p></li>
+<li><p>[BlackBerry Smartphones SDK] (https://developer.blackberry.com/html5/download/#smartphones)</p></li>
+</ul>
+<h2>
+<a name="BlackBerry%20Platform%20Guide_register_for_signing_keys">Register for Signing Keys</a>
+</h2>
+
+<p>If you wish to publish your application on BlackBerry App World, or on
+an actual device, you’ll need to register for a set of free Code
+Signing Keys.  To do so, complete the <a class="external" href="https://www.blackberry.com/SignedKeys">BlackBerry Keys Order
+Form</a>.
+Once you receive your Signing Keys, they require setup. See the <a class="external" href="https://developer.blackberry.com/html5/documentation/signing_setup_bb10_apps_2008396_11.html">BlackBerry HTML5/WebWorks website</a> for information.</p>
+
+<h2>
+<a name="BlackBerry%20Platform%20Guide_install_cordova">Install Cordova</a>
+</h2>
+
+<p>Download and extract the latest copy of <a class="external" href="http://cordova.apache.org/#download">Cordova</a>.</p>
+
+<h2>
+<a name="BlackBerry%20Platform%20Guide_set_up_a_new_project">Set up a New Project</a>
+</h2>
+
+<ul>
+<li><p>Open up a command-line terminal and navigate to where you extracted Cordova.</p></li>
+<li><p>There is a directory for each platform that Cordova supports.
+Navigate to the <code>blackberry</code> directory.</p></li>
+<li><p>The <code>blackberry</code> directory contains several subdirectories.  The
+<code>example</code> directory contains a complete Cordova project.  Copy the
+<code>example</code> directory to another location on your computer, and
+navigate there.</p></li>
+<li>
+<p>Edit the <code>project.properties</code> file to specify the WebWorks SDK you
+are using. For example, here are the respective settings for
+BlackBerry PlayBook, BlackBerry Smartphone (OS5-7), or BlackBerry 10
+(QNX):</p>
+
+<pre class="prettyprint"><code>playbook.bbwp.dir=C:\\Program Files\\Research In Motion\\BlackBerry WebWorks SDK for TabletOS 2.1.0.6\\bbwp
+blackberry.bbwp.dir=C:\\Program Files\\Research In Motion\\BlackBerry WebWorks Packager
+qnx.bbwp.dir=C:\\Program Files (x86)\\Research In Motion\\BlackBerry 10 WebWorks SDK 1.0.2.9
+</code></pre>
+</li>
+</ul>
+<p>These correspond to parameters you specify when building your
+project.  The first time you run these commands, they generate a
+"HelloWorld" application:</p>
+
+<pre class="prettyprint"><code>    cordova/build playbook
+    cordova/build blackberry
+    cordova/build qnx
+</code></pre>
+
+<p>Along with the SDK, you also need to register for a code signing key
+and debug token. The signing key allows you to distribute apps through
+BlackBerry World. The debug token allows you to test unsigned apps on
+a BlackBerry emulator or device. You do not need to create and
+install the debug token yourself; if you supply the keystore password,
+the build script creates and installs the debug token for you. To set
+up the signing key, go to the BlackBerry website to obtain it, making
+sure to retain the password you specify. Then run the
+<code>blackberry-signer</code> utility that is included with the SDK. 
+BlackBerry provides more information here:</p>
+
+<ul>
+<li><p><a class="external" href="https://www.blackberry.com/SignedKeys/codesigning.html">Register for your code signing key</a></p></li>
+<li><p><a class="external" href="http://developer.blackberry.com/html5/documentation/set_up_for_signing.html">Set up your computer for code signing</a></p></li>
+<li><p><a class="external" href="http://developer.blackberry.com/native/documentation/bb10/com.qnx.doc.native_sdk.quickstart/topic/set_up_your_environment.html">comprehensive guide to setting up your SDK environment</a></p></li>
+</ul>
+<h2>
+<a name="BlackBerry%20Platform%20Guide_deploy_to_emulator">Deploy to Emulator</a>
+</h2>
+
+<p>BlackBerry smartphone emulators are only available on Windows.
+BlackBerry PlayBook emulators require VMWare Player (Windows) or
+VMWare Fusion (Mac OS X). The WebWorks SDK provides a default
+emulator, but additional emulators are <a class="external" href="http://us.blackberry.com/developers/resources/simulators.jsp">available through
+BlackBerry</a>.</p>
+
+<p>From your project directory, type <code>./cordova/run &lt;target&gt;</code>, replacing
+<code>&lt;target&gt;</code> with either <code>qnx</code>, <code>playbook</code>, or <code>blackberry</code>. Note that
+for BlackBerry 10 and PlayBook, the emulator virtual image must
+already be started.</p>
+
+<p>See the following for more information:</p>
+
+<ul>
+<li><p><a class="external" href="https://developer.blackberry.com/html5/documentation/using_the_tablet_simulator_1866980_11.html">BlackBerry PlayBook</a></p></li>
+<li><p><a class="external" href="https://developer.blackberry.com/html5/documentation/run_your_app_on_smartphone_sim_1876976_11.html">BlackBerry Smartphone</a></p></li>
+</ul>
+<p>For BlackBerry Playbook, edit the <code>project.properties</code> file to
+customize the <code>playbook.sim.ip</code> and <code>playbook.sim.password</code>
+properties.  The emulator's IP address is available through the
+<strong>Settings</strong> application on the home screen. Enable the <strong>Security and
+Privacy → Development Mode</strong> option to display the address. The
+password can also be set in the <strong>Security and Privacy</strong> tab.</p>
+
+<p>For BlackBerry Smartphone, edit the <code>project.properties</code> file to
+customize the <code>blackberry.sim.dir</code> and <code>blackberry.sim.bin</code>
+properties.  You need to escape path delimiters when specifying
+directory paths on Windows, for example: <code>C:\\Program
+Files\\BlackBerry\\Simulator</code>.</p>
+
+<p>Once the emulator is installed and running, run either of the
+following to install an application to the home screen:</p>
+
+<pre class="prettyprint"><code>    cordova/run playbook
+    cordova/run blackberry
+</code></pre>
+
+<p>If you are prompted whether a device is connected to your computer,
+answer no.</p>
+
+<p><strong>NOTE:</strong> On BlackBerry OS 5, the application is installed in the
+<code>Downloads</code> directory.</p>
+
+<h2>
+<a name="BlackBerry%20Platform%20Guide_deploy_to_device">Deploy to Device
+</a>
+</h2>
+
+<p>To deploy your app to a device, it must be connected, and you must be
+registered for code signing keys as described above.  Also, to deploy
+apps on BlackBerry PlayBook, the <strong>Settings → Security →
+Development Mode</strong> option must be enabled.</p>
+
+<p>On BlackBerry PlayBook, edit the <code>project.properties</code> file and modify
+the following to reflect the device's IP and password as descibed
+above, along with the signing key password you set up:</p>
+
+<p>From your project directory, type <code>./cordova/run &lt;target&gt;</code>, replacing
+<code>&lt;target&gt;</code> with either <code>qnx</code>, <code>playbook</code>, or <code>blackberry</code>. </p>
+
+<p>On BlackBerry Smartphone (OS5-7), specify the
+<code>blackberry.sigtool.password</code> property as the signing key password.</p>
+
+<p>Then from the project's directory, run either of the commands you
+would to view the app in an emulator:</p>
+
+<pre class="prettyprint"><code>    cordova/run playbook
+    cordova/run blackberry
+</code></pre>
+
+<p>If you are prompted whether a device is connected to your computer,
+answer yes.</p>
+
+<p><strong>NOTE:</strong> On BlackBerry OS 5, the application is installed in the
+<code>Downloads</code> directory.</p>
+
+<h2>
+<a name="BlackBerry%20Platform%20Guide_additional_information">Additional Information</a>
+</h2>
+
+<p>The following articles may help resolve common problems when
+developing applications built for the BlackBerry WebWorks framework:</p>
+
+<ul>
+<li><p><a class="external" href="http://supportforums.blackberry.com/t5/Web-and-WebWorks-Development/Common-BlackBerry-WebWorks-development-pitfalls-that-can-be/ta-p/624712">BlackBerry WebWorks Development Pitfalls</a></p></li>
+<li><p><a class="external" href="https://bdsc.webapps.blackberrycom/html5/documentation/ww_developing/bestpractice_compiling_ww_apps_1873324_11.html">Best practices for packaging WebWorks applications</a></p></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_blackberry_plugin.md.html
URL: http://svn.apache.org/viewvc/cordova/site/public/docs/en/3.1.0/guide_platforms_blackberry_plugin.md.html?rev=1527865&view=auto
==============================================================================
--- cordova/site/public/docs/en/3.1.0/guide_platforms_blackberry_plugin.md.html (added)
+++ cordova/site/public/docs/en/3.1.0/guide_platforms_blackberry_plugin.md.html Tue Oct  1 03:55:57 2013
@@ -0,0 +1,265 @@
+<!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>BlackBerry Plugins</h1>
+            <small><select><option value="BlackBerry%2520Plugins">BlackBerry Plugins</option>
+<option value="BlackBerry%20Plugins_modifying_plugins_xml">      - Modifying plugins.xml</option>
+<option value="BlackBerry%20Plugins_adding_echo_java">      - Adding Echo.java</option>
+<option value="BlackBerry%20Plugins_writing_echo_java">      - Writing Echo.java</option>
+<option value="BlackBerry%20Plugins_updating_the_jar_in_your_project_s_www_directory">      - Updating the .jar in your project's www directory</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="BlackBerry%20Plugins">BlackBerry Plugins</a></h1>
+
+<p>This guide shows how to develop an Echo plugin on BlackBerry.  The
+<a href="guide_hybrid_plugins_index.md.html#Plugin%20Development%20Guide">Plugin Development Guide</a> provides a broad overview with which you
+should already be familiar, and this guide picks up where it leaves
+off.  In addition, download the <a class="external" href="https://git-wip-us.apache.org/repos/asf?p=cordova-blackberry-webworks.git;a=summary">Cordova BlackBerry
+repository</a>.</p>
+
+<p>The <code>Cordova-BlackBerry</code> project allows you to deploy to BlackBerry
+devices such as the Torch, Bold, and Playbook. The Playbook uses a
+different code base than other BlackBerry handheld devices, for which
+you need to duplicate your development efforts.  This guide focuses on
+the handheld devices rather than tablets. (In the future, this guide
+should cover both platforms.)</p>
+
+<p>The Echo plugin essentially returns whatever message a user provides
+to the <code>window.echo</code> function:</p>
+
+<pre class="prettyprint"><code>window.echo = function(str, callback) {
+    cordova.exec(callback, function(err) {
+        callback('Nothing to echo.');
+    }, "Echo", "echo", [str]);
+};
+</code></pre>
+
+<h2>
+<a name="BlackBerry%20Plugins_modifying_plugins_xml">Modifying plugins.xml</a>
+</h2>
+
+<p>Your project's <code>www/plugins.xml</code> directory contains all of the
+necessary references to your Cordova project's plugins. Add an
+additional reference so that when <code>cordova.exec</code> is called, Cordova
+knows how to map the <code>Echo</code> argument of <code>cordova.exec</code> to the <code>Echo</code>
+class that we want to write natively:</p>
+
+<pre class="prettyprint"><code>&lt;feature name="Echo"&gt;
+    &lt;param name="blackberry-package" value="org.apache.cordova.echo.Echo" /&gt;
+&lt;/feature&gt;
+</code></pre>
+
+<h2>
+<a name="BlackBerry%20Plugins_adding_echo_java">Adding Echo.java</a>
+</h2>
+
+<p>If you notice the structure of the value attribute, you'll see a
+defined path that leads to the Echo plugin. In the root directory of the
+Cordova BlackBerry WebWorks repo, look for a directory called <code>framework</code>.
+This directory contains all of the source code that runs natively on the
+BlackBerry. Navigate to <code>framework/ext/src/org/apache/cordova</code>. At
+this point, you'll see all of the plugin directorys, inside of which is
+the source code. So add the directory echo to
+<code>framework/ext/src/org/apache/cordova/echo</code> and create a file called
+<code>Echo.java</code> at <code>framework/ext/src/org/apache/cordova/echo/Echo.java</code>.</p>
+
+<h2>
+<a name="BlackBerry%20Plugins_writing_echo_java">Writing Echo.java</a>
+</h2>
+
+<p>The basic idea behind writing a plugin is to create a class that
+extends the Plugin class and have a method called <code>execute</code> to return
+a <code>PluginResult</code> class. Any call to <code>cordova.exec</code> passes in the
+action to execute within the class, as well as the arguments. In this
+case, "echo" is the action we want to execute within the class "Echo"
+and [str] are the arguments we are passing in.</p>
+
+<pre class="prettyprint"><code>package org.apache.cordova.echo;
+
+import org.apache.cordova.api.Plugin;
+import org.apache.cordova.api.PluginResult;
+import org.apache.cordova.json4j.JSONArray;
+import org.apache.cordova.json4j.JSONException;
+import org.apache.cordova.json4j.JSONObject;
+/**
+ * A simple plugin to demonstrate how to build a plugin for BlackBerry
+ * Basically echos back the msg that a user calls to this plugin
+ */
+public final class Echo extends Plugin {
+
+    public static final String echo = "echo";
+
+    public PluginResult execute(String action, JSONArray args, String callbackId) {
+        PluginResult result = new PluginResult(PluginResult.Status.INVALID_ACTION, "Echo: Invalid action:" + action);
+        if(action.equals(echo)){
+            try {
+                String theMsg = args.getString(0);
+                if(theMsg!= null || theMsg.length()&gt;0){
+                    result = new PluginResult(PluginResult.Status.OK, theMsg);
+                }else{
+                    result = new PluginResult(PluginResult.Status.ERROR, "Nothing to echo.");
+                }
+            } catch (JSONException e) {
+                result = new PluginResult(PluginResult.Status.JSON_EXCEPTION, e.getMessage());
+            }
+        }
+
+        return result;
+    }
+
+}
+</code></pre>
+
+<p>So if we look at the code above, we can see that within the execute
+method, we are first looking for what actions are coming in. The Echo
+plugin has only one action, <code>echo</code>, so we will be only checking for
+that. If our plugin had more actions, it's simply a matter of adding
+more conditional tests to check for those actions.</p>
+
+<p>We are then going to grab the message coming in from the arguments
+which is supplied by the args parameter.  We can grab the first
+argument by simply doing <code>String theMsg = args.getString(0);</code>.</p>
+
+<p>We will do some error checking and if the message looks okay, we will
+instantiate a new PluginResult with an ok status:
+<code>PluginResult.Status.OK</code> and return the message: <code>theMsg</code>. After this,
+we return the result which to be passed back to JavaScript to be fired
+in the success callback. If something fails, we can return various
+status exceptions like <code>PluginResult.Status.ERROR</code>,
+<code>PluginResult.Status.JSON_EXCEPTION</code>, or
+<code>PluginResult.Status.INVALID_ACTION</code>. When passed back, these types of
+results fire the fail callback in JavaScript.</p>
+
+<h2>
+<a name="BlackBerry%20Plugins_updating_the_jar_in_your_project_s_www_directory">Updating the .jar in your project's www directory</a>
+</h2>
+
+<p>The added <code>Echo.java</code> needs to be updated in your project.  To build
+the <code>.jar</code> file, Navigate to the BlackBerry WebWorks repo's root
+directory and run the <code>ant</code> command:</p>
+
+<pre class="prettyprint"><code>ant update -Dproject.path="~/path_to_my_project"
+</code></pre>
+
+<p>This builds a new <code>.jar</code> file in the <code>build/ext</code> directory. Copy the
+<code>build/ext/cordova.jar</code> file into your <code>project/www/ext</code> directory.</p>
+
+<p>If all goes well, that allows you to use the Echo plugin in
+BlackBerry.</p>
+
+            </div>
+        </div>
+
+        <!-- Functionality and Syntax Highlighting -->
+        <script type="text/javascript" src="index.js"></script><script type="text/javascript" src="prettify/prettify.js"></script>
+</body>
+</html>

Added: cordova/site/public/docs/en/3.1.0/guide_platforms_blackberry_tools.md.html
URL: http://svn.apache.org/viewvc/cordova/site/public/docs/en/3.1.0/guide_platforms_blackberry_tools.md.html?rev=1527865&view=auto
==============================================================================
--- cordova/site/public/docs/en/3.1.0/guide_platforms_blackberry_tools.md.html (added)
+++ cordova/site/public/docs/en/3.1.0/guide_platforms_blackberry_tools.md.html Tue Oct  1 03:55:57 2013
@@ -0,0 +1,205 @@
+<!DOCTYPE html>
+<!--
+    Licensed to the Apache Software Foundation (ASF) under one
+    or more contributor license agreements.  See the NOTICE file
+    distributed with this work for additional information
+    regarding copyright ownership.  The ASF licenses this file
+    to you under the Apache License, Version 2.0 (the
+    "License"); you may not use this file except in compliance
+    with the License.  You may obtain a copy of the License at
+
+      http://www.apache.org/licenses/LICENSE-2.0
+
+    Unless required by applicable law or agreed to in writing,
+    software distributed under the License is distributed on an
+    "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+    KIND, either express or implied.  See the License for the
+    specific language governing permissions and limitations
+    under the License.
+--><html lang="en">
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
+<meta name="viewport" content="initial-scale=1.0, maximum-scale=1.0, user-scalable=no, width=device-width">
+<meta name="generator" content="joDoc">
+<title>Apache Cordova API Documentation</title>
+<link rel="stylesheet" type="text/css" href="index.css">
+<link rel="stylesheet" type="text/css" href="mobile.css" media="only screen and (max-device-width: 1024px)">
+<link rel="stylesheet" type="text/css" href="prettify/prettify.css">
+</head>
+<body>
+        <div id="header">
+            <h1><a href="index.html">Apache <strong>Cordova</strong> Documentation</a></h1>
+            <small>
+                <select><optgroup label="Chinese" value="zh"><option value="edge">edge</option></optgroup>
+<optgroup label="English" value="en">
+<option value="edge">edge</option>
+<option selected value="3.1.0">3.1.0</option>
+<option value="3.0.0">3.0.0</option>
+<option value="2.9.0">2.9.0</option>
+<option value="2.8.0">2.8.0</option>
+<option value="2.7.0">2.7.0</option>
+<option value="2.6.0">2.6.0</option>
+<option value="2.5.0">2.5.0</option>
+<option value="2.4.0">2.4.0</option>
+<option value="2.3.0">2.3.0</option>
+<option value="2.2.0">2.2.0</option>
+<option value="2.1.0">2.1.0</option>
+<option value="2.0.0">2.0.0</option>
+<option value="1.9.0">1.9.0</option>
+<option value="1.8.1">1.8.1</option>
+<option value="1.8.0">1.8.0</option>
+<option value="1.7.0">1.7.0</option>
+<option value="1.6.1">1.6.1</option>
+<option value="1.6.0">1.6.0</option>
+<option value="1.5.0">1.5.0</option>
+</optgroup>
+<optgroup label="French" value="fr"><option value="edge">edge</option></optgroup>
+<optgroup label="German" value="de"><option value="edge">edge</option></optgroup>
+<optgroup label="Italian" value="it"><option value="edge">edge</option></optgroup>
+<optgroup label="Japanese" value="ja">
+<option value="edge">edge</option>
+<option value="2.2.0">2.2.0</option>
+<option value="2.1.0">2.1.0</option>
+<option value="2.0.0">2.0.0</option>
+<option value="1.9.0">1.9.0</option>
+<option value="1.8.1">1.8.1</option>
+<option value="1.7.0">1.7.0</option>
+</optgroup>
+<optgroup label="Korean" value="ko">
+<option value="edge">edge</option>
+<option value="2.0.0">2.0.0</option>
+</optgroup>
+<optgroup label="Russian" value="ru"><option value="edge">edge</option></optgroup>
+<optgroup label="Spanish" value="es"><option value="edge">edge</option></optgroup></select></small>
+        </div>
+        <div id="subheader">
+            <h1>BlackBerry Command-line Tools</h1>
+            <small><select><option value="BlackBerry%2520Command-line%2520Tools">BlackBerry Command-line Tools</option>
+<option value="BlackBerry%20Command-line%20Tools_create_a_project">      - Create a project</option>
+<option value="BlackBerry%20Command-line%20Tools_build_a_project">      - Build a project</option>
+<option value="BlackBerry%20Command-line%20Tools_launch_emulator">      - Launch emulator</option>
+<option value="BlackBerry%20Command-line%20Tools_logging">      - Logging</option></select></small>
+        </div>
+
+        <div id="sidebar">
+            <div class="vertical_divider"></div>
+        <h1>Guides</h1>
+<ul>
+<li><a href="guide_overview_index.md.html#Overview">Overview</a></li>
+<li><a href="guide_cli_index.md.html#The%20Command-line%20Interface">The Command-line Interface</a></li>
+<li><a href="guide_platforms_index.md.html#Platform%20Guides">Platform Guides</a></li>
+<li><a href="config_ref_index.md.html#The%20config.xml%20File">The config.xml File</a></li>
+<li><a href="guide_hybrid_webviews_index.md.html#Embedding%20WebViews">Embedding WebViews</a></li>
+<li><a href="guide_hybrid_plugins_index.md.html#Plugin%20Development%20Guide">Plugin Development Guide</a></li>
+<li><a href="guide_appdev_privacy_index.md.html#Privacy%20Guide">Privacy Guide</a></li>
+<li><a href="guide_appdev_whitelist_index.md.html#Domain%20Whitelist%20Guide">Domain Whitelist Guide</a></li>
+<li><a href="_index.html">Keyword Index</a></li>
+</ul>
+<h1>API Reference</h1>
+<ul>
+<li><a href="cordova_accelerometer_accelerometer.md.html#Accelerometer">Accelerometer</a></li>
+<li><a href="cordova_camera_camera.md.html#Camera">Camera</a></li>
+<li><a href="cordova_media_capture_capture.md.html#Capture">Capture</a></li>
+<li><a href="cordova_compass_compass.md.html#Compass">Compass</a></li>
+<li><a href="cordova_connection_connection.md.html#Connection">Connection</a></li>
+<li><a href="cordova_contacts_contacts.md.html#Contacts">Contacts</a></li>
+<li><a href="cordova_device_device.md.html#Device">Device</a></li>
+<li><a href="cordova_events_events.md.html#Events">Events</a></li>
+<li><a href="cordova_file_file.md.html#File">File</a></li>
+<li><a href="cordova_geolocation_geolocation.md.html#Geolocation">Geolocation</a></li>
+<li><a href="cordova_globalization_globalization.md.html#Globalization">Globalization</a></li>
+<li><a href="cordova_inappbrowser_inappbrowser.md.html#InAppBrowser">InAppBrowser</a></li>
+<li><a href="cordova_media_media.md.html#Media">Media</a></li>
+<li><a href="cordova_notification_notification.md.html#Notification">Notification</a></li>
+<li><a href="cordova_splashscreen_splashscreen.md.html#Splashscreen">Splashscreen</a></li>
+<li><a href="cordova_storage_storage.md.html#Storage">Storage</a></li>
+</ul>
+</div>
+
+        <div id="scrollable">
+            <div id="content">
+                <h1><a name="BlackBerry%20Command-line%20Tools">BlackBerry Command-line Tools</a></h1>
+
+<p>The <code>cordova</code> command-line utility is a high-level tool that allows
+you to build applications across several platforms at once. An older
+version of the Cordova framework provides sets of command-line tools
+specific to each platform. To use them as an alternative to the CLI,
+you need to download this version of Cordova from
+<a class="external" href="http://cordova.apache.org">cordova.apache.org</a>. The download contains
+separate archives for each platform. Expand the platform you wish to
+target. The tools described here are typically available in the
+top-level <code>bin</code> directory, otherwise consult the <strong>README</strong> file for
+more detailed directions.</p>
+
+<h2>
+<a name="BlackBerry%20Command-line%20Tools_create_a_project">Create a project</a>
+</h2>
+
+<p>Run the <code>create</code> command, specifying the existing path to the project,
+the reverse-domain-style package identifier, and the app's display
+name.  Here is the syntax for both Mac and Windows:</p>
+
+<pre class="prettyprint"><code>$ /path/to/cordova-blackberry-webworks/bin/create /path/to/my_new_project com.example.project_name ProjectName
+$ /path/to/cordova-blackberry-webworks/bin/create.bat /path/to/my_new_project com.example.project_name ProjectName
+</code></pre>
+
+<p><strong>NOTE:</strong> The BlackBerry platform ignores the package name placeholder
+(<code>com.example.project_name</code>), but it's still required for use by
+cross-platform tools.</p>
+
+<h2>
+<a name="BlackBerry%20Command-line%20Tools_build_a_project">Build a project</a>
+</h2>
+
+<p>For BlackBerry projects, please make sure you customize the
+<code>project.properties</code> file in your Cordova project's root directory.
+You need to do so to supply your BlackBerry signing key password, and
+specify locations for the BlackBerry WebWorks SDK and BlackBerry
+emulator executables.</p>
+
+<pre class="prettyprint"><code>$ /path/to/my_new_project/cordova/build &lt;platform&gt;
+$ /path/to/my_new_project/cordova/build.bat &lt;platform&gt;
+</code></pre>
+
+<h2>
+<a name="BlackBerry%20Command-line%20Tools_launch_emulator">Launch emulator</a>
+</h2>
+
+<p>For BlackBerry projects, please make sure you customize the
+<code>project.properties</code> file in the root of your Cordova project directory.
+You need to do so to supply your BlackBerry signing key password, and
+specify locations for the BlackBerry WebWorks SDK and BlackBerry
+emulator executables.</p>
+
+<pre class="prettyprint"><code>$ /path/to/my_new_project/cordova/run &lt;platform&gt;
+</code></pre>
+
+<p>and then choose 'no' when prompted with:</p>
+
+<pre class="prettyprint"><code>Do you have a BlackBerry device connected to your computer? (y/n)
+$ /path/to/my_new_project/cordova/run &lt;platform&gt;
+</code></pre>
+
+<p>and then choose 'no' when prompted with:</p>
+
+<pre class="prettyprint"><code>Do you have a BlackBerry device connected to your computer? (y/n)
+</code></pre>
+
+<h2>
+<a name="BlackBerry%20Command-line%20Tools_logging">Logging</a>
+</h2>
+
+<p>Unfortunately, streaming logs directly from the device is currently
+unsupported. However, BlackBerry offers built-in Web Inspector support
+for Playbook and BlackBerry smartphone devices running BlackBerry OS
+7.0 and above. You can also access your application's logs (including
+any calls to <code>console.log</code>) on your device by holding down the ''ALT''
+key from the home screen and typing ''lglg'' keys.</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>



Mime
View raw message