You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@cordova.apache.org by mw...@apache.org on 2013/10/22 20:30:38 UTC
svn commit: r1534721 [4/4] - in /cordova/site/public/docs/en: 2.9.0/ 3.0.0/
3.1.0/ edge/
Modified: cordova/site/public/docs/en/edge/guide_platforms_ios_webview.md.html
URL: http://svn.apache.org/viewvc/cordova/site/public/docs/en/edge/guide_platforms_ios_webview.md.html?rev=1534721&r1=1534720&r2=1534721&view=diff
==============================================================================
--- cordova/site/public/docs/en/edge/guide_platforms_ios_webview.md.html (original)
+++ cordova/site/public/docs/en/edge/guide_platforms_ios_webview.md.html Tue Oct 22 18:30:36 2013
@@ -95,10 +95,9 @@
<div id="subheader">
<h1>iOS WebViews</h1>
<small><select><option value="iOS%2520WebViews">iOS WebViews</option>
-<option value="iOS%20WebViews_prerequisites">Â Â Â Â Â Â - Prerequisites</option>
-<option value="iOS%20WebViews_adding_cleaver_to_your_xcode_project_cordovalib_sub_project">Â Â Â Â Â Â - Adding Cleaver to your Xcode project (CordovaLib sub-project)</option>
-<option value="iOS%20WebViews_using_cdvviewcontroller_in_your_code">Â Â Â Â Â Â - Using CDVViewController in your code</option>
-<option value="iOS%20WebViews_adding_your_html_css_and_javascript_assets">Â Â Â Â Â Â - Adding your HTML, CSS and JavaScript assets</option></select></small>
+<option value="iOS%20WebViews_adding_cleaver_to_the_xcode_project_cordovalib_sub_project">Â Â Â Â Â Â - Adding Cleaver to the Xcode project (CordovaLib sub-project)</option>
+<option value="iOS%20WebViews_using_cdvviewcontroller">Â Â Â Â Â Â - Using CDVViewController</option>
+<option value="iOS%20WebViews_adding_html_css_and_javascript_assets">Â Â Â Â Â Â - Adding HTML, CSS and JavaScript assets</option></select></small>
</div>
<div id="sidebar">
@@ -106,6 +105,7 @@
<h1>Guides</h1>
<ul>
<li><a href="guide_overview_index.md.html#Overview">Overview</a></li>
+<li><a href="guide_support_index.md.html#Platform%20Support">Platform Support</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>
@@ -141,46 +141,57 @@
<div id="content">
<h1><a name="iOS%20WebViews">iOS WebViews</a></h1>
-<p>Beginning with Cordova 1.4, you can use Cordova as a component in your
-iOS applications. This component is code-named 'Cleaver'.</p>
+<p>This section shows how to embed a Cordova-enabled WebView component
+within a larger iOS application. For details on how these components
+can communicate with each other, see Application Plugins.</p>
+
+<p>Support for <a href="guide_platforms_ios_webview.md.html#iOS%20WebViews">iOS WebViews</a> started with Cordova version 1.4, using a
+<code>Cleaver</code> component for which the Xcode template serves as a reference
+implementation. Cordova 2.0 and later versions only support the
+subproject-based Cleaver implementation.</p>
+
+<p>These instructions require at least Cordova 2.3 and Xcode 4.5, along
+with a <code>config.xml</code> file from a newly created iOS project. You can use
+the procedure in <a href="guide_cli_index.md.html#The%20Command-line%20Interface">The Command-line Interface</a> to create a new project,
+then obtain the <code>config.xml</code> file from within the named application's
+subdirectory within <code>platforms/ios</code>.</p>
+
+<p>To follow these instructions, make sure you have the latest Cordova
+distribution. Download it from
+<a class="external" href="http://cordova.apache.org">cordova.apache.org</a> and unzip its iOS
+package.</p>
-<p>New Cordova-based applications created using the Xcode template
-provided in Cordova 1.4 or greater use Cleaver. (The template is
-Cleaver's reference implementation.)</p>
-
-<p>Cordova 2.0.0 and subsequent versions only support the sub-project
-based Cleaver implementation.</p>
-
-<h2>
-<a name="iOS%20WebViews_prerequisites">Prerequisites</a>
-</h2>
-
-<ul>
-<li><p>Cordova 2.3.0 or greater</p></li>
-<li><p>Xcode 4.5 or greater</p></li>
-<li><p><code>config.xml</code> file (from a newly created iOS project)</p></li>
-</ul>
<h2>
-<a name="iOS%20WebViews_adding_cleaver_to_your_xcode_project_cordovalib_sub_project">Adding Cleaver to your Xcode project (CordovaLib sub-project)</a>
+<a name="iOS%20WebViews_adding_cleaver_to_the_xcode_project_cordovalib_sub_project">Adding Cleaver to the Xcode project (CordovaLib sub-project)</a>
</h2>
<ol>
-<li><p>Download and extract the Cordova source to a permanent directory location on your hard drive, for example to <code>~/Documents/Cordova</code>.</p></li>
<li><p>Quit Xcode if it is running.</p></li>
-<li><p>Using Terminal.app, navigate to the directory where you put the downloaded source above.</p></li>
-<li><p>Copy the <code>config.xml</code> file into your project directory on disk (see the Prerequisites above).</p></li>
-<li><p>Drag and drop the <code>config.xml</code> file into the Project Navigator of Xcode.</p></li>
-<li><p>Choose the <strong>Create groups for any added folders</strong> radio button and press <strong>Finish</strong>.</p></li>
-<li><p>Drag and drop the <code>CordovaLib.xcodeproj</code> file into the Project Navigator of Xcode (from the permanent directory location above, and it should be in the <code>CordovaLib</code> subdirectory).</p></li>
-<li><p>Select <code>CordovaLib.xcodeproj</code> in the Project Navigator.</p></li>
-<li><p>Type the <strong>Option-Command-1</strong> key combination to <a href="cordova_inappbrowser_inappbrowser.md.html#show">show</a> the <strong><a href="cordova_file_file.md.html#File">File</a> Inspector</strong>.</p></li>
-<li><p>Choose <strong>Relative to Group</strong> in the <strong><a href="cordova_file_file.md.html#File">File</a> Inspector</strong> for the drop-down menu for <strong>Location</strong>.</p></li>
-<li><p>Select the <strong>project icon</strong> in the Project Navigator, select your <strong>Target</strong>, then select the <strong>Build Settings</strong> tab.</p></li>
+<li><p>Open a terminal and navigate to the source directory for Cordova
+iOS.</p></li>
+<li><p>Copy the <code>config.xml</code> file described above into the project
+directory.</p></li>
+<li><p>Open Xcode and use the Finder to copy the <code>config.xml</code> file into
+its <strong>Project Navigator</strong> window.</p></li>
+<li><p>Choose <strong>Create groups for any added folders</strong> and press
+<strong>Finish</strong>.</p></li>
+<li><p>Use the Finder to copy the <code>CordovaLib/CordovaLib.xcodeproj</code> file
+into Xcode's <strong>Project Navigator</strong></p></li>
+<li><p>Select <code>CordovaLib.xcodeproj</code> within the <strong>Project Navigator</strong>.</p></li>
+<li><p>Type the <strong>Option-Command-1</strong> key combination to <a href="cordova_inappbrowser_inappbrowser.md.html#show">show</a> the <strong><a href="cordova_file_file.md.html#File">File</a>
+Inspector</strong>.</p></li>
+<li><p>Choose <strong>Relative to Group</strong> in the <strong><a href="cordova_file_file.md.html#File">File</a> Inspector</strong> for the
+drop-down menu for <strong>Location</strong>.</p></li>
+<li><p>Select the <strong>project icon</strong> in the <strong>Project Navigator</strong>, select
+the <strong>Target</strong>, then select the <strong>Build Settings</strong> tab.</p></li>
<li><p>Add <code>-all_load</code> and <code>-Obj-C</code> for the <strong>Other Linker <a href="cordova_file_file.md.html#Flags">Flags</a></strong> value.</p></li>
-<li><p>Click on the <strong>project icon</strong> in the Project Navigator, select your <strong>Target</strong>, then select the <strong>Build Phases</strong> tab.</p></li>
+<li><p>Click on the <strong>project icon</strong> in the Project Navigator, select the
+<strong>Target</strong>, then select the <strong>Build Phases</strong> tab.</p></li>
<li><p>Expand <strong>Link Binaries with Libraries</strong>.</p></li>
<li>
-<p>Select the <strong>+</strong> button, and add the following <strong>frameworks</strong>. Optionally in the Project Navigator, move them under the <strong>Frameworks</strong> group):</p>
+<p>Select the <strong>+</strong> button, and add the following <strong>frameworks</strong>.
+Optionally within the <strong>Project Navigator</strong>, move them under the
+<strong>Frameworks</strong> group:</p>
<pre class="prettyprint"><code>AddressBook.framework
AddressBookUI.framework
@@ -194,88 +205,105 @@ MobileCoreServices.framework
CoreMedia.framework
</code></pre>
</li>
-<li><p>Expand <strong>Target Dependencies</strong>, the top box labeled like this if you have multiple boxes!</p></li>
+<li><p>Expand <strong>Target Dependencies</strong>, the top box with that label if
+there's more than one box.</p></li>
<li><p>Select the <strong>+</strong> button, and add the <code>CordovaLib</code> build product.</p></li>
-<li><p>Expand <strong>Link Binaries with Libraries</strong>, the top box labeled like
-this if you have multiple boxes!</p></li>
+<li><p>Expand <strong>Link Binaries with Libraries</strong>, the top box with that label
+if there's more than one box.</p></li>
<li><p>Select the <strong>+</strong> button, and add <code>libCordova.a</code>.</p></li>
-<li><p>Set the Xcode preference <strong>Xcode Preferences â Locations â Derived Data â Advanced...</strong> to <strong>Unique</strong>.</p></li>
-<li><p>Select the <strong>project icon</strong> in the Project Navigator, select your <strong>Target</strong>, then select the <strong>Build Settings</strong> tab.</p></li>
+<li><p>Set the <strong>Xcode Preferences â Locations â Derived Data
+â Advanced...</strong> to <strong>Unique</strong>.</p></li>
+<li><p>Select the <strong>project icon</strong> in the Project Navigator, select your
+<strong>Target</strong>, then select the <strong>Build Settings</strong> tab.</p></li>
<li>
-<p>Search for <strong>Header Search Paths</strong>. For that setting, add these three values below (with quotes):</p>
+<p>Search for <strong>Header Search Paths</strong>. For that setting, add these
+three values below, including the quotes:</p>
<pre class="prettyprint"><code>"$(TARGET_BUILD_DIR)/usr/local/lib/include"
"$(OBJROOT)/UninstalledProducts/include"
"$(BUILT_PRODUCTS_DIR)"
</code></pre>
-<p>With Cordova 2.1.0, <code>CordovaLib</code> has been upgraded to use <strong>Automatic Reference Counting (ARC)</strong>. You don't need to upgrade to <strong>ARC</strong> to use CordovaLib, but if you want to upgrade your project to use <strong>ARC</strong>, please use the Xcode migration wizard from the menu: <strong>Edit â Refactor â Convert to Objective-C ARC...</strong>, <strong>de-select libCordova.a</strong>, then run the wizard to completion.</p>
+<p>As of Cordova 2.1.0, <code>CordovaLib</code> has been upgraded to use
+<strong>Automatic Reference Counting (ARC)</strong>. You don't need to upgrade
+to <strong>ARC</strong> to use <code>CordovaLib</code>, but if you want to upgrade your
+project to use <strong>ARC</strong>, you should use the Xcode migration wizard
+from the <strong>Edit â Refactor â Convert to Objective-C
+ARC...</strong> menu, <strong>de-select libCordova.a</strong>, then run the wizard to
+completion.</p>
</li>
</ol>
<h2>
-<a name="iOS%20WebViews_using_cdvviewcontroller_in_your_code">Using CDVViewController in your code</a>
+<a name="iOS%20WebViews_using_cdvviewcontroller">Using CDVViewController</a>
</h2>
<ol>
<li>
-<p>Add this header:</p>
+<p>Add the following header:</p>
<pre class="prettyprint"><code>#import <Cordova/CDVViewController.h>
</code></pre>
</li>
<li>
-<p>Instantiate a new <code>CDVViewController</code>, and retain it somewhere (e.g., to a property in your class):</p>
+<p>Instantiate a new <code>CDVViewController</code> and retain it somewhere,
+e.g., to a class property:</p>
<pre class="prettyprint"><code>CDVViewController* viewController = [CDVViewController new];
</code></pre>
</li>
<li>
-<p>(<em>OPTIONAL</em>) Set the <code>wwwFolderName</code> property (defaults to <code>www</code>):</p>
+<p>Optionally, set the <code>wwwFolderName</code> property, which defaults to <code>www</code>:</p>
<pre class="prettyprint"><code>viewController.wwwFolderName = @"myfolder";
</code></pre>
</li>
<li>
-<p>(<em>OPTIONAL</em>) Set the start page in your config.xml, the <code><content></code> tag.</p>
+<p>Optionally, set the start page in the <code>config.xml</code> file's
+<code><content></code> tag, either a local file:</p>
<pre class="prettyprint"><code><content src="index.html" />
</code></pre>
-<p>OR</p>
+<p>...or a remote site:</p>
<pre class="prettyprint"><code><content src="http://apache.org" />
</code></pre>
</li>
<li>
-<p>(<em>OPTIONAL</em>) Set the <code>useSplashScreen</code> property (defaults to <code>NO</code>):</p>
+<p>Optionally, set the <code>useSplashScreen</code> property, which defaults to
+<code>NO</code>:</p>
<pre class="prettyprint"><code>viewController.useSplashScreen = YES;
</code></pre>
</li>
<li>
-<p>Set the <strong>view frame</strong> (always set this as the last property):</p>
+<p>Set the <strong>view frame</strong>. Always set this as the last property:</p>
<pre class="prettyprint"><code>viewController.view.frame = CGRectMake(0, 0, 320, 480);
</code></pre>
</li>
<li>
-<p>Add Cleaver to your view:</p>
+<p>Add Cleaver to the view:</p>
<pre class="prettyprint"><code>[myView addSubview:viewController.view];
</code></pre>
</li>
</ol>
<h2>
-<a name="iOS%20WebViews_adding_your_html_css_and_javascript_assets">Adding your HTML, CSS and JavaScript assets</a>
+<a name="iOS%20WebViews_adding_html_css_and_javascript_assets">Adding HTML, CSS and JavaScript assets</a>
</h2>
<ol>
-<li><p>Create a new directory in your project on disk, <code>www</code> for example.</p></li>
-<li><p>Put your HTML, CSS and JavaScript assets into this directory.</p></li>
-<li><p>Drag and drop the directory into the Project Navigator of Xcode.</p></li>
-<li><p>Choose the <strong>Create folder references for any added folders</strong> radio button.</p></li>
-<li>
-<p>Set the appropriate <code>wwwFolderName</code> and <code>startPage</code> properties for the folder you initially created, or use the defaults (see previous section) when you instantiate the <code>CDVViewController</code>.</p>
+<li><p>Create a new directory within the project, <code>www</code> for example.</p></li>
+<li><p>Place HTML, CSS and JavaScript assets into this directory.</p></li>
+<li><p>Use the Finder to copy the directory into Xcode's <strong>Project
+Navigator</strong> window.</p></li>
+<li><p>Select <strong>Create folder references for any added folders</strong>.</p></li>
+<li>
+<p>Set the appropriate <code>wwwFolderName</code> and <code>startPage</code> properties for
+the directory you initially created, or use the defaults (specified
+in the previous section) when instantiating the
+<code>CDVViewController</code>.</p>
<pre class="prettyprint"><code>/*
if you created a folder called 'myfolder' and
Modified: cordova/site/public/docs/en/edge/guide_platforms_tizen_index.md.html
URL: http://svn.apache.org/viewvc/cordova/site/public/docs/en/edge/guide_platforms_tizen_index.md.html?rev=1534721&r1=1534720&r2=1534721&view=diff
==============================================================================
--- cordova/site/public/docs/en/edge/guide_platforms_tizen_index.md.html (original)
+++ cordova/site/public/docs/en/edge/guide_platforms_tizen_index.md.html Tue Oct 22 18:30:36 2013
@@ -108,6 +108,7 @@
<h1>Guides</h1>
<ul>
<li><a href="guide_overview_index.md.html#Overview">Overview</a></li>
+<li><a href="guide_support_index.md.html#Platform%20Support">Platform Support</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>
Modified: cordova/site/public/docs/en/edge/guide_platforms_win8_index.md.html
URL: http://svn.apache.org/viewvc/cordova/site/public/docs/en/edge/guide_platforms_win8_index.md.html?rev=1534721&r1=1534720&r2=1534721&view=diff
==============================================================================
--- cordova/site/public/docs/en/edge/guide_platforms_win8_index.md.html (original)
+++ cordova/site/public/docs/en/edge/guide_platforms_win8_index.md.html Tue Oct 22 18:30:36 2013
@@ -107,6 +107,7 @@
<h1>Guides</h1>
<ul>
<li><a href="guide_overview_index.md.html#Overview">Overview</a></li>
+<li><a href="guide_support_index.md.html#Platform%20Support">Platform Support</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>
Modified: cordova/site/public/docs/en/edge/guide_platforms_win8_tools.md.html
URL: http://svn.apache.org/viewvc/cordova/site/public/docs/en/edge/guide_platforms_win8_tools.md.html?rev=1534721&r1=1534720&r2=1534721&view=diff
==============================================================================
--- cordova/site/public/docs/en/edge/guide_platforms_win8_tools.md.html (original)
+++ cordova/site/public/docs/en/edge/guide_platforms_win8_tools.md.html Tue Oct 22 18:30:36 2013
@@ -104,6 +104,7 @@
<h1>Guides</h1>
<ul>
<li><a href="guide_overview_index.md.html#Overview">Overview</a></li>
+<li><a href="guide_support_index.md.html#Platform%20Support">Platform Support</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>
@@ -150,6 +151,10 @@ target. The tools described here are typ
top-level <code>bin</code> directory, otherwise consult the <strong>README</strong> file for
more detailed directions.</p>
+<p>For information on the low-level command-line interface that enables
+plugins, see <a href="plugin_ref_plugman.md.html#Using%20Plugman%20to%20Manage%20Plugins">Using Plugman to Manage Plugins</a>. See Application Plugins
+for an overview.</p>
+
<h2>
<a name="Windows%208%20Command-line%20Tools_windows_8">Windows 8</a>
</h2>
Modified: cordova/site/public/docs/en/edge/guide_platforms_win8_upgrading.md.html
URL: http://svn.apache.org/viewvc/cordova/site/public/docs/en/edge/guide_platforms_win8_upgrading.md.html?rev=1534721&r1=1534720&r2=1534721&view=diff
==============================================================================
--- cordova/site/public/docs/en/edge/guide_platforms_win8_upgrading.md.html (original)
+++ cordova/site/public/docs/en/edge/guide_platforms_win8_upgrading.md.html Tue Oct 22 18:30:36 2013
@@ -105,6 +105,7 @@
<h1>Guides</h1>
<ul>
<li><a href="guide_overview_index.md.html#Overview">Overview</a></li>
+<li><a href="guide_support_index.md.html#Platform%20Support">Platform Support</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>
Modified: cordova/site/public/docs/en/edge/guide_platforms_wp7_index.md.html
URL: http://svn.apache.org/viewvc/cordova/site/public/docs/en/edge/guide_platforms_wp7_index.md.html?rev=1534721&r1=1534720&r2=1534721&view=diff
==============================================================================
--- cordova/site/public/docs/en/edge/guide_platforms_wp7_index.md.html (original)
+++ cordova/site/public/docs/en/edge/guide_platforms_wp7_index.md.html Tue Oct 22 18:30:36 2013
@@ -109,6 +109,7 @@
<h1>Guides</h1>
<ul>
<li><a href="guide_overview_index.md.html#Overview">Overview</a></li>
+<li><a href="guide_support_index.md.html#Platform%20Support">Platform Support</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>
Modified: cordova/site/public/docs/en/edge/guide_platforms_wp8_index.md.html
URL: http://svn.apache.org/viewvc/cordova/site/public/docs/en/edge/guide_platforms_wp8_index.md.html?rev=1534721&r1=1534720&r2=1534721&view=diff
==============================================================================
--- cordova/site/public/docs/en/edge/guide_platforms_wp8_index.md.html (original)
+++ cordova/site/public/docs/en/edge/guide_platforms_wp8_index.md.html Tue Oct 22 18:30:36 2013
@@ -111,6 +111,7 @@
<h1>Guides</h1>
<ul>
<li><a href="guide_overview_index.md.html#Overview">Overview</a></li>
+<li><a href="guide_support_index.md.html#Platform%20Support">Platform Support</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>
Modified: cordova/site/public/docs/en/edge/guide_platforms_wp8_plugin.md.html
URL: http://svn.apache.org/viewvc/cordova/site/public/docs/en/edge/guide_platforms_wp8_plugin.md.html?rev=1534721&r1=1534720&r2=1534721&view=diff
==============================================================================
--- cordova/site/public/docs/en/edge/guide_platforms_wp8_plugin.md.html (original)
+++ cordova/site/public/docs/en/edge/guide_platforms_wp8_plugin.md.html Tue Oct 22 18:30:36 2013
@@ -94,13 +94,14 @@
</div>
<div id="subheader">
<h1>Windows Phone Plugins</h1>
- <small><select><option value="Windows%2520Phone%2520Plugins">Windows Phone Plugins</option>
+ <small><select><option value="_under_the_license">Â Â Â Â Â Â - under the License.</option>
+<option value="Windows%2520Phone%2520Plugins">Windows Phone Plugins</option>
<option value="Windows%20Phone%20Plugins_namespaces">Â Â Â Â Â Â - Namespaces</option>
-<option value="Windows%20Phone%20Plugins_interpreting_your_arguments_in_c">Â Â Â Â Â Â - Interpreting your arguments in C</option>
-<option value="Windows%20Phone%20Plugins_passing_results_from_c_to_javascript">Â Â Â Â Â Â - Passing results from C# to JavaScript</option>
-<option value="Windows%20Phone%20Plugins_handling_serialization_errors_in_your_plugin_s_c_method">Â Â Â Â Â Â - Handling serialization errors in your plugin's C# method</option>
+<option value="Windows%20Phone%20Plugins_interpreting_arguments_in_c">Â Â Â Â Â Â - Interpreting Arguments in C</option>
+<option value="Windows%20Phone%20Plugins_passing_results_from_c_to_javascript">Â Â Â Â Â Â - Passing Results from C# to JavaScript</option>
+<option value="Windows%20Phone%20Plugins_handling_serialization_errors">Â Â Â Â Â Â - Handling Serialization Errors</option>
<option value="Windows%20Phone%20Plugins_plugin_xml">Â Â Â Â Â Â - Plugin XML</option>
-<option value="Windows%20Phone%20Plugins_advanced_plugin_functionality">Â Â Â Â Â Â - Advanced Plugin Functionality</option>
+<option value="Windows%20Phone%20Plugins_debugging_plugins">Â Â Â Â Â Â - Debugging Plugins</option>
<option value="Windows%20Phone%20Plugins_common_pitfalls">Â Â Â Â Â Â - Common Pitfalls</option></select></small>
</div>
@@ -109,6 +110,7 @@
<h1>Guides</h1>
<ul>
<li><a href="guide_overview_index.md.html#Overview">Overview</a></li>
+<li><a href="guide_support_index.md.html#Platform%20Support">Platform Support</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>
@@ -142,32 +144,52 @@
<div id="scrollable">
<div id="content">
- <h1><a name="Windows%20Phone%20Plugins">Windows Phone Plugins</a></h1>
+ <p>--
+license: 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</p>
+
+<pre class="prettyprint"><code> 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
+</code></pre>
-<p>Writing a plugin for Cordova on Windows Phone requires a basic understanding of
-the architecture of Cordova. Cordova-WP7 consists of a WebBrowser which hosts the
-application JavaScript code and manages native API calls. There is a BaseCommand
-(<code>WP7CordovaClassLib.Cordova.Commands.BaseCommand</code>) class in C# which you can extend,
-and it comes with the majority of the 'plumbing' built for you already.</p>
+<h2>
+<a name="_under_the_license"> under the License.</a>
+</h2>
-<ol>
-<li>
-<p>Select your project, and right-click to choose <strong>Add â New Item...</strong></p>
+<h1><a name="Windows%20Phone%20Plugins">Windows Phone Plugins</a></h1>
-<ul>
-<li>Preferably add it to the 'Plugins' directory, but it is up to you</li>
-</ul>
-</li>
-<li>
-<p>Select 'Class' and name it <code>Echo.cs</code></p>
+<p>This section provides details for how to implement native plugin code
+on the Windows Phone platform. Before reading this, see Application
+Plugins for an overview of the plugin's structure and its common
+JavaScript interface. This section continues to demonstrate the sample
+<em>echo</em> plugin that communicates from the Cordova webview to the native
+platform and back.</p>
+
+<p>Writing a plugin for Cordova on Windows Phone requires a basic
+understanding of Cordova's architecture. Cordova-WP7 consists of a
+<code>WebBrowser</code> that hosts the application's JavaScript code and manages
+native API calls. You can extend a C# <code>BaseCommand</code> class
+(<code>WP7CordovaClassLib.Cordova.Commands.BaseCommand</code>), which comes with
+most of the functionality you need:</p>
-<ul>
-<li>The name of this class must <em>exactly</em> match what you call into <code>cordova.exec(win, fail, "Echo", ...)</code>
-</li>
-</ul>
-</li>
+<ol>
+<li><p>Select your project, and right-click to choose <strong>Add â New
+Item...</strong> If you wish, you can add it to the <code>Plugins</code> folder.</p></li>
+<li><p>Select <strong>Class</strong> and name it <code>Echo.cs</code>. This class name must
+<em>exactly</em> match what you call specify as the service in the
+<code>cordova.exec()</code> call on the JavaScript side.</p></li>
<li>
-<p>Include the base classes implementation</p>
+<p>Include the base classes implementation:</p>
<pre class="prettyprint"><code>using WPCordovaClassLib.Cordova;
using WPCordovaClassLib.Cordova.Commands;
@@ -175,7 +197,7 @@ using WPCordovaClassLib.Cordova.JSON;
</code></pre>
</li>
<li>
-<p>Extend your class from BaseCommand</p>
+<p>Extend your class from <code>BaseCommand</code>:</p>
<pre class="prettyprint"><code>public class Echo : BaseCommand
{
@@ -184,7 +206,7 @@ using WPCordovaClassLib.Cordova.JSON;
</code></pre>
</li>
<li>
-<p>Add a method that is callable from JavaScript</p>
+<p>Add an <code>echo</code> method that is callable from JavaScript:</p>
<pre class="prettyprint"><code>public class Echo : BaseCommand
{
@@ -197,129 +219,140 @@ using WPCordovaClassLib.Cordova.JSON;
</code></pre>
</li>
</ol>
+<p>See the
+<a class="external" href="https://github.com/apache/cordova-wp7/blob/master/templates/standalone/cordovalib/Commands/BaseCommand.cs">BaseCommand.cs</a>
+class for methods available for the plugin to override. For example,
+the plugin can capture '<a href="cordova_events_events.md.html#pause">pause</a>' and '<a href="cordova_events_events.md.html#resume">resume</a>' events.</p>
+
<h2>
<a name="Windows%20Phone%20Plugins_namespaces">Namespaces</a>
</h2>
<p>The default namespace for unqualified commands is:</p>
-<pre class="prettyprint"><code>namespace Cordova.Extension.Commands
-{
- // ...
-}
+<pre class="prettyprint"><code> namespace Cordova.Extension.Commands
+ {
+ // ...
+ }
</code></pre>
-<p>If you want to use your own namespace, you need to make a fully
+<p>If you want to specify your own namespace, you need to make a fully
qualified call to <code>cordova.exec</code>. For example, if you want to define
your C# class like this:</p>
-<pre class="prettyprint"><code>namespace com.mydomain.cordovaExtensions
-{
- public class Echo : BaseCommand
+<pre class="prettyprint"><code> namespace com.mydomain.cordovaExtensions
{
- // ...
+ public class Echo : BaseCommand
+ {
+ // ...
+ }
}
-}
</code></pre>
-<p>Then, in JavaScript you need to call <code>exec</code> like this:</p>
+<p>The JavaScript would need to call <code>exec</code> like this:</p>
-<pre class="prettyprint"><code>cordova.exec(win, fail, "com.mydomain.cordovaExtensions.Echo", ...);
+<pre class="prettyprint"><code> cordova.exec(win, fail, "com.mydomain.cordovaExtensions.Echo", ...);
</code></pre>
<h2>
-<a name="Windows%20Phone%20Plugins_interpreting_your_arguments_in_c">Interpreting your arguments in C</a>
+<a name="Windows%20Phone%20Plugins_interpreting_arguments_in_c">Interpreting Arguments in C</a>
</h2>
-<p>The data received by your plugin method is a string value, but in actuality
-looking at our JavaScript code, we see our intention was to pass an array of strings.
-Looking back at our JavaScript call to <code>cordova.exec</code>, we see we passed <code>[str]</code>:</p>
+<p>In the example discussed in Application Plugins, the data your plugin
+receives is a string, but what if you want to pass an array of
+strings? Suppose the JavaScript <code>cordova.exec</code> call is specified like
+this:</p>
-<pre class="prettyprint"><code>cordova.exec(win, fail, "Echo", "echo", ["input string"]);
+<pre class="prettyprint"><code> cordova.exec(win, fail, "Echo", "echo", ["input string"]);
</code></pre>
-<p>If we inspect the options string passed in to our <code>Echo.echo</code> method,
-we see that the value is actually:</p>
+<p>The value of <code>options</code> string passed to the <code>Echo.echo</code> method is
+JSON:</p>
-<pre class="prettyprint"><code>"[\"input string\"]"
+<pre class="prettyprint"><code> "[\"input string\"]"
</code></pre>
-<p>All JavaScript <code>exec</code> arguments are JSON encoded before being passed into C#.</p>
+<p>All JavaScript <code>exec</code> arguments are JSON-encoded before being passed
+into C#, and so need to be decoded:</p>
-<p>If we want to treat this as the string we were expecting, we need to decode it.
-We can use simple JSON deserialization.</p>
-
-<pre class="prettyprint"><code>string optVal = JsonHelper.Deserialize<string[]>(options)[0];
-// optVal now has the value of "input string"
+<pre class="prettyprint"><code> string optVal = JsonHelper.Deserialize<string[]>(options)[0];
+ // optVal now has the value of "input string"
</code></pre>
<h2>
-<a name="Windows%20Phone%20Plugins_passing_results_from_c_to_javascript">Passing results from C# to JavaScript</a>
+<a name="Windows%20Phone%20Plugins_passing_results_from_c_to_javascript">Passing Results from C# to JavaScript</a>
</h2>
-<p>The base class BaseCommand provides methods for passing data to your JavaScript callback handlers.
-To simply signal that the command has succeeded, when no additional result info is needed,
-you can simply call:</p>
+<p>The <code>BaseCommand</code> class provides methods to pass data to JavaScript
+callback handlers. If you simply want to signal success with no
+accompanying result, you can simply call:</p>
-<pre class="prettyprint"><code>DispatchCommandResult(); // calls back with an empty plugin result, considered a success callback
+<pre class="prettyprint"><code> DispatchCommandResult();
+ // calls back with an empty plugin result, considered a success callback
</code></pre>
-<p>To pass data back, you need to call a different version of <code>DispatchCommandResult</code>:</p>
+<p>To pass data back, you need to call <code>DispatchCommandResult</code>
+differently:</p>
-<pre class="prettyprint"><code>DispatchCommandResult(new PluginResult(PluginResult.Status.OK, "Everything went as planned, this is a result that is passed to the success handler."));
+<pre class="prettyprint"><code> DispatchCommandResult(new PluginResult(PluginResult.Status.OK, "Everything went as planned, this is a result that is passed to the success handler."));
</code></pre>
-<p>To pass structured object data back to JavaScript, it should be encoded as a JSON string:</p>
+<p>Use an encoded JSON string to pass structured object data back to
+JavaScript:</p>
-<pre class="prettyprint"><code>DispatchCommandResult(new PluginResult(PluginResult.Status.OK, "{result:\"super awesome!\"}"));
+<pre class="prettyprint"><code> DispatchCommandResult(new PluginResult(PluginResult.Status.OK, "{result:\"super awesome!\"}"));
</code></pre>
-<p>If you need to signal that an error has occurred, you can call <code>DispatchCommandResult</code> with a <code>PluginResult</code> object:</p>
+<p>To signal an error, call <code>DispatchCommandResult</code> with a <code>PluginResult</code>
+object whose status is <code>ERROR</code>:</p>
-<pre class="prettyprint"><code>DispatchCommandResult(new PluginResult(PluginResult.Status.ERROR, "Echo signaled an error"));
+<pre class="prettyprint"><code> DispatchCommandResult(new PluginResult(PluginResult.Status.ERROR, "Echo signaled an error"));
</code></pre>
<h2>
-<a name="Windows%20Phone%20Plugins_handling_serialization_errors_in_your_plugin_s_c_method">Handling serialization errors in your plugin's C# method</a>
+<a name="Windows%20Phone%20Plugins_handling_serialization_errors">Handling Serialization Errors</a>
</h2>
-<p>When interpreting your arguments, it is a good idea to use a try/catch block
-in case we have bad input. This is a pattern used throughout the Cordova C# code:</p>
+<p>When interpreting your arguments, <code>try</code>/<code>catch</code> blocks help screen out
+bad input. This pattern appears throughout the Cordova C# code:</p>
-<pre class="prettyprint"><code>string optVal = null;
+<pre class="prettyprint"><code> string optVal = null;
-try
-{
- optVal = JsonHelper.Deserialize<string[]>(options)[0];
-}
-catch(Exception)
-{
- // simply catch the exception, we handle null values and exceptions together
-}
+ try
+ {
+ optVal = JsonHelper.Deserialize<string[]>(options)[0];
+ }
+ catch(Exception)
+ {
+ // simply catch the exception, we handle null values and exceptions together
+ }
-if (optVal == null)
-{
- DispatchCommandResult(new PluginResult(PluginResult.Status.JSON_EXCEPTION));
-}
-else
-{
- // ... continue on to do our work
-}
+ if (optVal == null)
+ {
+ DispatchCommandResult(new PluginResult(PluginResult.Status.JSON_EXCEPTION));
+ }
+ else
+ {
+ // ... continue on to do our work
+ }
</code></pre>
<h2>
<a name="Windows%20Phone%20Plugins_plugin_xml">Plugin XML</a>
</h2>
-<p>These are windows phone specific examples of using the plugin.xml file, refer to the <a href="plugin_ref_spec.md.html#Plugin%20Specification">Plugin Specification</a> for more details</p>
-
-<h3><code><source-file></code></h3>
-
-<p>On windows phone the <code><source-file></code> element is currently used to define all plugin resources (ie. .cs, .xaml, .xaml.cs, .dll, image assets etc).</p>
+<p>The following shows how to use the <code>plugin.xml</code> file to specify a
+plugin's source files on the Windows Phone platform. See Application
+Plugins for an overview, and <a href="plugin_ref_spec.md.html#Plugin%20Specification">Plugin Specification</a> for details on
+available options.</p>
-<h3><code><config-file></code></h3>
-
-<p>The <code><config-file></code> element defines what elements get put into a config file. For example to add a plugin to the platforms config.xml, you would do something like this :</p>
+<ul>
+<li><p>The <code><source-file></code> element defines all plugin resources, such
+as <em>.cs</em>, <em>.xaml</em>, <em>.xaml.cs</em>, and <em>.dll</em> files, and image assets.</p></li>
+<li>
+<p>The <code><config-file></code> element defines elements to inject into a
+configuration file. This example adds a plugin to the platform's
+<code>config.xml</code> file:</p>
<pre class="prettyprint"><code><config-file target="config.xml" parent="/*">
<feature name="PluginName">
@@ -328,32 +361,25 @@ else
</config-file>
</code></pre>
-<p>If we wanted to add the contacts capability to the WMAppManifest.xml, it would look like this :</p>
+<p>This example adds the contacts capability to the <code>WMAppManifest.xml</code>
+file:</p>
<pre class="prettyprint"><code><config-file target="Properties/WMAppManifest.xml" parent="/Deployment/App/Capabilities">
<Capability Name="ID_CAP_CONTACTS" />
</config-file>
</code></pre>
-
+</li>
+</ul>
<h2>
-<a name="Windows%20Phone%20Plugins_advanced_plugin_functionality">Advanced Plugin Functionality</a>
+<a name="Windows%20Phone%20Plugins_debugging_plugins">Debugging Plugins</a>
</h2>
-<p>See other methods that you can override in:</p>
-
-<ul>
-<li><a class="external" href="https://github.com/apache/cordova-wp7/blob/master/templates/standalone/cordovalib/Commands/BaseCommand.cs">BaseCommand.cs</a></li>
-</ul>
-<p>For example, you can hook into the '<a href="cordova_events_events.md.html#pause">pause</a>' and '<a href="cordova_events_events.md.html#resume">resume</a>' application events.</p>
-
-<h3>Debugging Plugins</h3>
-
-<p>To debug the C# side, you can use Visual Studio's debugger, just set a break point
-at any of the methods exposed by your class.</p>
+<p>Use Visual Studio's debugger to debug a plugin's C# component. You can
+set a break point at any of the methods exposed by your class.</p>
-<p>JavaScript is a little more difficult to debug on Windows Phone. You
-need to use <code>console.log</code> to output the state of your plugin, or
-inform yourself of errors.</p>
+<p>JavaScript is more difficult to debug on Windows Phone. You need to
+use <code>console.log</code> to output the plugin's state, or to inform
+yourself of errors.</p>
<h2>
<a name="Windows%20Phone%20Plugins_common_pitfalls">Common Pitfalls</a>
@@ -361,35 +387,29 @@ inform yourself of errors.</p>
<ul>
<li>
-<p>Be careful when deciding on the arguments you pass to native in your JavaScript
-implementation. Most device platforms expect the args passed to cordova.exec
-to be an array, but if you have different types of objects in this array, it
-becomes difficult or impossible to deserialize.</p>
+<p>Be careful not to pass arguments from JavaScript to the native side
+that are difficult to deserialize as JSON. Most device platforms
+expect the argument passed to <code>cordova.exec()</code> to be an array, such
+as the following:</p>
<pre class="prettyprint"><code>cordova.exec(win, fail, "ServiceName", "MethodName", ["this is a string", 54, {literal:'trouble'}]);
</code></pre>
-<ul>
-<li>
-<p>This means that your C# code receives a difficult to decode string value, such as:</p>
+<p>This may result in an overly complex string value for C# to decode:</p>
<pre class="prettyprint"><code>"[\"this is a string\", 54, { literal:'trouble' }]"
</code></pre>
-</li>
-<li>
-<p>Consider converting ALL parameters to strings before calling exec:</p>
-
-<pre class="prettyprint"><code>cordova.exec(win, fail, "ServiceName", "MethodName", ["this is a string", "54", "{literal:'trouble'}"]) ;
+<p>Instead, consider converting <em>all</em> parameters to strings before
+calling <code>exec()</code>, and decoding each separately:</p>
+<pre class="prettyprint"><code>cordova.exec(win, fail, "ServiceName", "MethodName", ["this is a string", "54", "{literal:'trouble'}"]);
string[] optValues = JsonHelper.Deserialize<string[]>(options);
</code></pre>
</li>
-</ul>
-</li>
-<li><p>It is usually a good idea to do parameter checking in your
-JavaScript code, before you call <code>exec</code>. This allows you to re-use
-more JavaScript code among your plugin's various native
+<li><p>It is usually better to check parameters in JavaScript before
+calling <code>exec()</code>. Doing so allows you to re-use more code and pull
+unnecessary functionality from the plugin's various native
implementations.</p></li>
</ul>
</div>
Modified: cordova/site/public/docs/en/edge/guide_platforms_wp8_tools.md.html
URL: http://svn.apache.org/viewvc/cordova/site/public/docs/en/edge/guide_platforms_wp8_tools.md.html?rev=1534721&r1=1534720&r2=1534721&view=diff
==============================================================================
--- cordova/site/public/docs/en/edge/guide_platforms_wp8_tools.md.html (original)
+++ cordova/site/public/docs/en/edge/guide_platforms_wp8_tools.md.html Tue Oct 22 18:30:36 2013
@@ -107,6 +107,7 @@
<h1>Guides</h1>
<ul>
<li><a href="guide_overview_index.md.html#Overview">Overview</a></li>
+<li><a href="guide_support_index.md.html#Platform%20Support">Platform Support</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>
@@ -153,6 +154,10 @@ target. The tools described here are typ
top-level <code>bin</code> directory, otherwise consult the <strong>README</strong> file for
more detailed directions.</p>
+<p>For information on the low-level command-line interface that enables
+plugins, see <a href="plugin_ref_plugman.md.html#Using%20Plugman%20to%20Manage%20Plugins">Using Plugman to Manage Plugins</a>. See Application Plugins
+for an overview.</p>
+
<h2>
<a name="Windows%20Phone%20Command-line%20Tools_windows_phone">Windows Phone</a>
</h2>
Modified: cordova/site/public/docs/en/edge/guide_platforms_wp8_upgrading.md.html
URL: http://svn.apache.org/viewvc/cordova/site/public/docs/en/edge/guide_platforms_wp8_upgrading.md.html?rev=1534721&r1=1534720&r2=1534721&view=diff
==============================================================================
--- cordova/site/public/docs/en/edge/guide_platforms_wp8_upgrading.md.html (original)
+++ cordova/site/public/docs/en/edge/guide_platforms_wp8_upgrading.md.html Tue Oct 22 18:30:36 2013
@@ -125,6 +125,7 @@
<h1>Guides</h1>
<ul>
<li><a href="guide_overview_index.md.html#Overview">Overview</a></li>
+<li><a href="guide_support_index.md.html#Platform%20Support">Platform Support</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>
Added: cordova/site/public/docs/en/edge/guide_support_index.md.html
URL: http://svn.apache.org/viewvc/cordova/site/public/docs/en/edge/guide_support_index.md.html?rev=1534721&view=auto
==============================================================================
--- cordova/site/public/docs/en/edge/guide_support_index.md.html (added)
+++ cordova/site/public/docs/en/edge/guide_support_index.md.html Tue Oct 22 18:30:36 2013
@@ -0,0 +1,392 @@
+<!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>
+<option value="3.1.0">3.1.0</option>
+</optgroup>
+<optgroup label="English" value="en">
+<option selected value="edge">edge</option>
+<option 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>
+<option value="3.1.0">3.1.0</option>
+</optgroup>
+<optgroup label="German" value="de">
+<option value="edge">edge</option>
+<option value="3.1.0">3.1.0</option>
+</optgroup>
+<optgroup label="Italian" value="it">
+<option value="edge">edge</option>
+<option value="3.1.0">3.1.0</option>
+</optgroup>
+<optgroup label="Japanese" value="ja">
+<option value="edge">edge</option>
+<option value="3.1.0">3.1.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.7.0">1.7.0</option>
+</optgroup>
+<optgroup label="Korean" value="ko">
+<option value="edge">edge</option>
+<option value="3.1.0">3.1.0</option>
+<option value="2.0.0">2.0.0</option>
+</optgroup>
+<optgroup label="Russian" value="ru">
+<option value="edge">edge</option>
+<option value="3.1.0">3.1.0</option>
+</optgroup>
+<optgroup label="Spanish" value="es">
+<option value="edge">edge</option>
+<option value="3.1.0">3.1.0</option>
+</optgroup></select></small>
+ </div>
+ <div id="subheader">
+ <h1>Platform Support</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_support_index.md.html#Platform%20Support">Platform Support</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="config_ref_images.md.html#Icons%20and%20Splash%20Screens">Icons and Splash Screens</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#Whitelist%20Guide">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%20Support">Platform Support</a></h1>
+
+<p>The following shows the set of development tools and device APIs
+available for each mobile platform. (Column headers display the
+CLI's shorthand stubs.)</p>
+
+<!-- START HTML -->
+
+<table class="compat" width="100%">
+<thead><tr>
+<th>
+ </th>
+<th><tt>android</tt></th>
+ <th>
+<tt>blackberry</tt> (6)</th>
+ <th><tt>blackberry10</tt></th>
+ <th><tt>ios</tt></th>
+ <th>
+<tt>wp7</tt> (Windows<br>Phone 7)</th>
+ <th>
+<tt>wp8</tt> (Windows<br>Phone 8)</th>
+ <th>
+<tt>win8</tt><br>(Windows 8)</th>
+ <th><tt>firefoxos</tt></th>
+ <th><tt>tizen</tt></th>
+ </tr></thead>
+<tbody>
+<tr>
+<th><a href="guide_cli_index.md.html">cordova<br>CLI</a></th>
+ <td data-col="android" class="y">Mac, Windows, Linux</td>
+ <td data-col="blackberry" class="n">Mac, Windows</td>
+ <td data-col="blackberry10" class="y">Mac, Windows</td>
+ <td data-col="ios" class="y">Mac</td>
+ <td data-col="winphone7" class="y">Windows</td>
+ <td data-col="winphone8" class="y">Windows</td>
+ <td data-col="win8" class="n"></td>
+ <td data-col="tizen" class="n"></td>
+ </tr>
+<tr>
+<th><a href="guide_hybrid_webviews_index.md.html">Embedded<br>WebView</a></th>
+ <td data-col="android" class="y"><a href="guide_platforms_android_webview.md.html">(see details)</a></td>
+ <td data-col="blackberry" class="n"></td>
+ <td data-col="blackberry10" class="n"></td>
+ <td data-col="ios" class="y"><a href="guide_platforms_ios_webview.md.html">(see details)</a></td>
+ <td data-col="winphone7" class="n"></td>
+ <td data-col="winphone8" class="n"></td>
+ <td data-col="win8" class="n"></td>
+ <td data-col="tizen" class="n"></td>
+ </tr>
+<tr>
+<th><a href="guide_hybrid_plugins_index.md.html">Plug-in<br>Interface</a></th>
+ <td data-col="android" class="y"><a href="guide_guide_platforms_android_plugin.md.html">(see details)</a></td>
+ <td data-col="blackberry" class="y"><a href="guide_guide_platforms_blackberry_plugin.md.html">(see details)</a></td>
+ <td data-col="blackberry10" class="y"><a href="guide_guide_platforms_blackberry10_plugin.md.html">(see details)</a></td>
+ <td data-col="ios" class="y"><a href="guide_guide_platforms_ios_plugin.md.html">(see details)</a></td>
+ <td data-col="winphone7" class="y"><a href="guide_guide_platforms_wp8_plugin.md.html">(see details)</a></td>
+ <td data-col="winphone8" class="y"></td>
+ <td data-col="win8" class="n"></td>
+ <td data-col="tizen" class="n"></td>
+ </tr>
+<tr>
+<th></th>
+ <th colspan="20">Platform APIs</th>
+ </tr>
+<tr>
+<th><a href="cordova_accelerometer_accelerometer.md.html">Accelerometer</a></th>
+ <td data-col="android" class="y"></td>
+ <td data-col="blackberry" class="y"></td>
+ <td data-col="blackberry10" class="y"></td>
+ <td data-col="ios" class="y"></td>
+ <td data-col="winphone7" class="y"></td>
+ <td data-col="winphone8" class="y"></td>
+ <td data-col="win8" class="y"></td>
+ <td data-col="tizen" class="y"></td>
+ </tr>
+<tr>
+<th><a href="cordova_camera_camera.md.html">Camera</a></th>
+ <td data-col="android" class="y"></td>
+ <td data-col="blackberry" class="y"></td>
+ <td data-col="blackberry10" class="y"></td>
+ <td data-col="ios" class="y"></td>
+ <td data-col="winphone7" class="y"></td>
+ <td data-col="winphone8" class="y"></td>
+ <td data-col="win8" class="y"></td>
+ <td data-col="tizen" class="y"></td>
+ </tr>
+<tr>
+<th><a href="cordova_media_capture_capture.md.html">Capture</a></th>
+ <td data-col="android" class="y"></td>
+ <td data-col="blackberry" class="y"></td>
+ <td data-col="blackberry10" class="y"></td>
+ <td data-col="ios" class="y"></td>
+ <td data-col="winphone7" class="y"></td>
+ <td data-col="winphone8" class="y"></td>
+ <td data-col="win8" class="n"></td>
+ <td data-col="tizen" class="n"></td>
+ </tr>
+<tr>
+<th><a href="cordova_compass_compass.md.html">Compass</a></th>
+ <td data-col="android" class="y"></td>
+ <td data-col="blackberry" class="n"></td>
+ <td data-col="blackberry10" class="y"></td>
+ <td data-col="ios" class="y">(3GS+)</td>
+ <td data-col="winphone7" class="y"></td>
+ <td data-col="winphone8" class="y"></td>
+ <td data-col="win8" class="y"></td>
+ <td data-col="tizen" class="y"></td>
+ </tr>
+<tr>
+<th><a href="cordova_connection_connection.md.html">Connection</a></th>
+ <td data-col="android" class="y"></td>
+ <td data-col="blackberry" class="y"></td>
+ <td data-col="blackberry10" class="y"></td>
+ <td data-col="ios" class="y"></td>
+ <td data-col="winphone7" class="y"></td>
+ <td data-col="winphone8" class="y"></td>
+ <td data-col="win8" class="y"></td>
+ <td data-col="tizen" class="y"></td>
+ </tr>
+<tr>
+<th><a href="cordova_contacts_contacts.md.html">Contacts</a></th>
+ <td data-col="android" class="y"></td>
+ <td data-col="blackberry" class="y"></td>
+ <td data-col="blackberry10" class="y"></td>
+ <td data-col="ios" class="y"></td>
+ <td data-col="winphone7" class="y"></td>
+ <td data-col="winphone8" class="y"></td>
+ <td data-col="win8" class="y"></td>
+ <td data-col="tizen" class="n"></td>
+ </tr>
+<tr>
+<th><a href="cordova_device_device.md.html">Device</a></th>
+ <td data-col="android" class="y"></td>
+ <td data-col="blackberry" class="y"></td>
+ <td data-col="blackberry10" class="y"></td>
+ <td data-col="ios" class="y"></td>
+ <td data-col="winphone7" class="y"></td>
+ <td data-col="winphone8" class="y"></td>
+ <td data-col="win8" class="y"></td>
+ <td data-col="tizen" class="y"></td>
+ </tr>
+<tr>
+<th><a href="cordova_events_events.md.html">Events</a></th>
+ <td data-col="android" class="y"></td>
+ <td data-col="blackberry" class="y"></td>
+ <td data-col="blackberry10" class="y"></td>
+ <td data-col="ios" class="y"></td>
+ <td data-col="winphone7" class="y"></td>
+ <td data-col="winphone8" class="y"></td>
+ <td data-col="win8" class="y"></td>
+ <td data-col="tizen" class="y"></td>
+ </tr>
+<tr>
+<th><a href="cordova_file_file.md.html">File</a></th>
+ <td data-col="android" class="y"></td>
+ <td data-col="blackberry" class="y"></td>
+ <td data-col="blackberry10" class="y"></td>
+ <td data-col="ios" class="y"></td>
+ <td data-col="winphone7" class="p">no <a href="cordova_file_file.md.html#FileTransfer">FileTransfer</a>
+</td>
+ <td data-col="winphone8" class="p">no <a href="cordova_file_file.md.html#FileTransfer">FileTransfer</a>
+</td>
+ <td data-col="win8" class="y"></td>
+ <td data-col="tizen" class="n"></td>
+ </tr>
+<tr>
+<th><a href="cordova_geolocation_geolocation.md.html">Geolocation</a></th>
+ <td data-col="android" class="y"></td>
+ <td data-col="blackberry" class="y"></td>
+ <td data-col="blackberry10" class="y"></td>
+ <td data-col="ios" class="y"></td>
+ <td data-col="winphone7" class="y"></td>
+ <td data-col="winphone8" class="y"></td>
+ <td data-col="win8" class="y"></td>
+ <td data-col="tizen" class="y"></td>
+ </tr>
+<tr>
+<th><a href="cordova_globalization_globalization.md.html">Globalization</a></th>
+ <td data-col="android" class="y"></td>
+ <td data-col="blackberry" class="y"></td>
+ <td data-col="blackberry10" class="n"></td>
+ <td data-col="ios" class="y"></td>
+ <td data-col="winphone7" class="n"></td>
+ <td data-col="winphone8" class="y"></td>
+ <td data-col="win8" class="n"></td>
+ <td data-col="tizen" class="n"></td>
+ </tr>
+<tr>
+<th><a href="cordova_inappbrowser_inappbrowser.md.html">InAppBrowser</a></th>
+ <td data-col="android" class="y"></td>
+ <td data-col="blackberry" class="y"></td>
+ <td data-col="blackberry10" class="y"></td>
+ <td data-col="ios" class="y"></td>
+ <td data-col="winphone7" class="y"></td>
+ <td data-col="winphone8" class="y"></td>
+ <td data-col="win8" class="n"></td>
+ <td data-col="tizen" class="n"></td>
+ </tr>
+<tr>
+<th><a href="cordova_media_media.md.html">Media</a></th>
+ <td data-col="android" class="y"></td>
+ <td data-col="blackberry" class="n"></td>
+ <td data-col="blackberry10" class="y"></td>
+ <td data-col="ios" class="y"></td>
+ <td data-col="winphone7" class="y"></td>
+ <td data-col="winphone8" class="y"></td>
+ <td data-col="win8" class="y"></td>
+ <td data-col="tizen" class="y"></td>
+ </tr>
+<tr>
+<th><a href="cordova_notification_notification.md.html">Notification</a></th>
+ <td data-col="android" class="y"></td>
+ <td data-col="blackberry" class="y"></td>
+ <td data-col="blackberry10" class="y"></td>
+ <td data-col="ios" class="y"></td>
+ <td data-col="winphone7" class="y"></td>
+ <td data-col="winphone8" class="y"></td>
+ <td data-col="win8" class="y"></td>
+ <td data-col="tizen" class="y"></td>
+ </tr>
+<tr>
+<th><a href="cordova_splashscreen_splashscreen.md.html">Splashscreen</a></th>
+ <td data-col="android" class="y"></td>
+ <td data-col="blackberry" class="n"></td>
+ <td data-col="blackberry10" class="y"></td>
+ <td data-col="ios" class="y"></td>
+ <td data-col="winphone7" class="y"></td>
+ <td data-col="winphone8" class="y"></td>
+ <td data-col="win8" class="y"></td>
+ <td data-col="tizen" class="n"></td>
+ </tr>
+<tr>
+<th><a href="cordova_storage_storage.md.html">Storage</a></th>
+ <td data-col="android" class="y"></td>
+ <td data-col="blackberry" class="y"></td>
+ <td data-col="blackberry10" class="y"></td>
+ <td data-col="ios" class="y"></td>
+ <td data-col="winphone7" class="p">
+<a href="cordova_storage_storage.md.html#localStorage">localStorage</a> only</td>
+ <td data-col="winphone8" class="p">
+<a href="cordova_storage_storage.md.html#localStorage">localStorage</a> only</td>
+ <td data-col="win8" class="y"></td>
+ <td data-col="tizen" class="y"></td>
+ </tr>
+</tbody>
+</table>
+<!-- END HTML -->
+</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>
Modified: cordova/site/public/docs/en/edge/index.html
URL: http://svn.apache.org/viewvc/cordova/site/public/docs/en/edge/index.html?rev=1534721&r1=1534720&r2=1534721&view=diff
==============================================================================
--- cordova/site/public/docs/en/edge/index.html (original)
+++ cordova/site/public/docs/en/edge/index.html Tue Oct 22 18:30:36 2013
@@ -102,6 +102,7 @@
<h1>Guides</h1>
<ul>
<li><a href="guide_overview_index.md.html#Overview">Overview</a></li>
+<li><a href="guide_support_index.md.html#Platform%20Support">Platform Support</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>
@@ -144,6 +145,10 @@
<span>Start here if you are new to Cordova.</span>
</li>
<li>
+ <h2><a href="guide_support_index.md.html#Platform%20Support">Platform Support</a></h2>
+ <span>Compatibility table for all major features.</span>
+ </li>
+ <li>
<h2><a href="guide_cli_index.md.html#The%20Command-line%20Interface">The Command-line Interface</a></h2>
<span>Create, build, and deploy from the command-line.</span>
</li>
Modified: cordova/site/public/docs/en/edge/plugin_ref_plugman.md.html
URL: http://svn.apache.org/viewvc/cordova/site/public/docs/en/edge/plugin_ref_plugman.md.html?rev=1534721&r1=1534720&r2=1534721&view=diff
==============================================================================
--- cordova/site/public/docs/en/edge/plugin_ref_plugman.md.html (original)
+++ cordova/site/public/docs/en/edge/plugin_ref_plugman.md.html Tue Oct 22 18:30:36 2013
@@ -104,6 +104,7 @@
<h1>Guides</h1>
<ul>
<li><a href="guide_overview_index.md.html#Overview">Overview</a></li>
+<li><a href="guide_support_index.md.html#Platform%20Support">Platform Support</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>
@@ -160,17 +161,17 @@ their workflow.</p>
<p>To install plugman, you must have <a class="external" href="http://nodejs.org/">node</a> installed
on your machine:</p>
-<pre class="prettyprint"><code>npm install -g plugman
+<pre class="prettyprint"><code>$ npm install -g plugman
</code></pre>
<p>Here is the syntax to add a plugin for each platform:</p>
-<pre class="prettyprint"><code>plugman --platform <ios|android|blackberry10|wp7|wp8> --project <directory> --plugin <name|url|path> [--plugins_dir <directory>] [--www <directory>] [--variable <name>=<value> [--variable <name>=<value> ...]]
+<pre class="prettyprint"><code>$ plugman --platform <ios|android|blackberry10|wp7|wp8> --project <directory> --plugin <name|url|path> [--plugins_dir <directory>] [--www <directory>] [--variable <name>=<value> [--variable <name>=<value> ...]]
</code></pre>
<p>To uninstall a plugin:</p>
-<pre class="prettyprint"><code>plugman --uninstall --platform <ios|android|blackberry10|wp7|wp8> --project <directory> --plugin <id> [--www <directory>] [--plugins_dir <directory>]
+<pre class="prettyprint"><code>$ plugman --uninstall --platform <ios|android|blackberry10|wp7|wp8> --project <directory> --plugin <id> [--www <directory>] [--plugins_dir <directory>]
</code></pre>
<h2>
Modified: cordova/site/public/docs/en/edge/plugin_ref_spec.md.html
URL: http://svn.apache.org/viewvc/cordova/site/public/docs/en/edge/plugin_ref_spec.md.html?rev=1534721&r1=1534720&r2=1534721&view=diff
==============================================================================
--- cordova/site/public/docs/en/edge/plugin_ref_spec.md.html (original)
+++ cordova/site/public/docs/en/edge/plugin_ref_spec.md.html Tue Oct 22 18:30:36 2013
@@ -133,6 +133,7 @@
<h1>Guides</h1>
<ul>
<li><a href="guide_overview_index.md.html#Overview">Overview</a></li>
+<li><a href="guide_support_index.md.html#Platform%20Support">Platform Support</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>