cordova-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From agri...@apache.org
Subject svn commit: r1673862 [11/15] - in /cordova/site: ./ public/docs/en/edge/
Date Wed, 15 Apr 2015 16:43:44 GMT
Modified: cordova/site/public/docs/en/edge/guide_platforms_ios_index.md.html
URL: http://svn.apache.org/viewvc/cordova/site/public/docs/en/edge/guide_platforms_ios_index.md.html?rev=1673862&r1=1673861&r2=1673862&view=diff
==============================================================================
--- cordova/site/public/docs/en/edge/guide_platforms_ios_index.md.html (original)
+++ cordova/site/public/docs/en/edge/guide_platforms_ios_index.md.html Wed Apr 15 16:43:43 2015
@@ -1,4 +1,3 @@
-<!DOCTYPE html>
 <!--
     Licensed to the Apache Software Foundation (ASF) under one
     or more contributor license agreements.  See the NOTICE file
@@ -16,12 +15,14 @@
     KIND, either express or implied.  See the License for the
     specific language governing permissions and limitations
     under the License.
---><html lang="en">
+-->
+
+<!DOCTYPE html>
+<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">
-<meta name="robots" content="noindex">
+        <meta name="generator" content="joDoc"><meta name="robots" label="noindex">
 
         <title>Apache Cordova API Documentation</title>
 
@@ -40,7 +41,7 @@
 <option value="3.1.0">3.1.0</option>
 </optgroup>
 <optgroup label="English" value="en">
-<option selected value="edge">edge</option>
+<option selected="selected" value="edge">edge</option>
 <option value="4.0.0">4.0.0</option>
 <option value="3.6.0">3.6.0</option>
 <option value="3.5.0">3.5.0</option>
@@ -104,7 +105,9 @@
 <option value="3.1.0">3.1.0</option>
 <option value="2.0.0">2.0.0</option>
 </optgroup>
-<optgroup label="Polish" value="pl"><option value="edge">edge</option></optgroup>
+<optgroup label="Polish" value="pl">
+<option value="edge">edge</option>
+</optgroup>
 <optgroup label="Russian" value="ru">
 <option value="edge">edge</option>
 <option value="3.5.0">3.5.0</option>
@@ -121,18 +124,13 @@
 <option value="3.5.0">3.5.0</option>
 <option value="3.4.0">3.4.0</option>
 <option value="3.1.0">3.1.0</option>
-</optgroup></select>
+</optgroup>
+</select>
             </small>
         </div>
         <div id="subheader">
             <h1>iOS Platform Guide</h1>
-            <small><select><option value="iOS%2520Platform%2520Guide">iOS Platform Guide</option>
-<option value="iOS%20Platform%20Guide_requirements_and_support">      - Requirements and Support</option>
-<option value="iOS%20Platform%20Guide_install_the_sdk">      - Install the SDK</option>
-<option value="iOS%20Platform%20Guide_open_a_project_in_the_sdk">      - Open a Project in the SDK</option>
-<option value="iOS%20Platform%20Guide_deploy_to_emulator">      - Deploy to Emulator</option>
-<option value="iOS%20Platform%20Guide_deploy_to_device">      - Deploy to Device</option>
-<option value="iOS%20Platform%20Guide_common_problems">      - Common Problems</option></select></small>
+            <small><select><option value="iOS%2520Platform%2520Guide">iOS Platform Guide</option><option value="iOS%20Platform%20Guide_requirements_and_support">&#xA0;&#xA0;&#xA0;&#xA0;&#xA0;&#xA0;- Requirements and Support</option><option value="iOS%20Platform%20Guide_install_the_sdk">&#xA0;&#xA0;&#xA0;&#xA0;&#xA0;&#xA0;- Install the SDK</option><option value="iOS%20Platform%20Guide_open_a_project_in_the_sdk">&#xA0;&#xA0;&#xA0;&#xA0;&#xA0;&#xA0;- Open a Project in the SDK</option><option value="iOS%20Platform%20Guide_deploy_to_emulator">&#xA0;&#xA0;&#xA0;&#xA0;&#xA0;&#xA0;- Deploy to Emulator</option><option value="iOS%20Platform%20Guide_deploy_to_device">&#xA0;&#xA0;&#xA0;&#xA0;&#xA0;&#xA0;- Deploy to Device</option><option value="iOS%20Platform%20Guide_common_problems">&#xA0;&#xA0;&#xA0;&#xA0;&#xA0;&#xA0;- Common Problems</option></select></small>
         </div>
 
         <div id="sidebar">
@@ -165,11 +163,9 @@
         <div id="scrollable">
             <div id="content">
                 <h1><a name="iOS%20Platform%20Guide">iOS Platform Guide</a></h1>
-
 <p>This guide shows how to set up your SDK development environment to
 deploy Cordova apps for iOS devices such as iPhone and iPad. See the
 following for more detailed platform-specific information:</p>
-
 <ul>
 <li><a href="guide_platforms_ios_config.md.html#iOS%20Configuration">iOS Configuration</a></li>
 <li><a href="guide_platforms_ios_upgrade.md.html#Upgrading%20iOS">Upgrading iOS</a></li>
@@ -177,217 +173,188 @@ following for more detailed platform-spe
 <li><a href="guide_platforms_ios_plugin.md.html#iOS%20Plugins">iOS Plugins</a></li>
 <li>iOS Command-line Tools</li>
 </ul>
-
 <p>The command-line tools above refer to versions prior to Cordova 3.0.
 See <a href="guide_cli_index.md.html#The%20Command-Line%20Interface">The Command-Line Interface</a> for information about the
 current interface.</p>
-
-<h2><a name="iOS%20Platform%20Guide_requirements_and_support">Requirements and Support</a></h2>
-
-<p>Apple® tools required to build iOS applications run only on the OS X
-operating system on Intel-based Macs. Xcode® 4.5 (the minimum required
-version) runs only on OS X version 10.7 (Lion) or greater, and
-includes the iOS 6 SDK (Software Development Kit).  To submit apps to
-the Apple App Store℠ requires the latest versions of the Apple tools.</p>
-
+<h2 id="requirements-and-support"><a name="iOS%20Platform%20Guide_requirements_and_support">Requirements and Support</a></h2>
+<p>Apple&#xAE; tools required to build iOS applications run only on the OS X
+operating system on Intel-based Macs. Xcode&#xAE; 6.0 (the minimum required
+version) runs only on OS X version 10.9 (Mavericks) or greater, and
+includes the iOS 8 SDK (Software Development Kit).  To submit apps to
+the Apple App Store&#x2120; requires the latest versions of the Apple tools.</p>
 <p>You can test many of the Cordova features using the iOS emulator
 installed with the iOS SDK and Xcode, but you need an actual device to
-fully test all of the app's device features before submitting to the
-App Store.  The device must have at least iOS 5.x installed, the
-minimum iOS version supported as of Cordova 2.3.  Supporting devices
-include all iPad® models, iPhone® 3GS and above, and iPod® Touch 3rd
+fully test all of the app&apos;s device features before submitting to the
+App Store.  The device must have at least iOS 6.x installed, the
+minimum iOS version supported as of Cordova 3.0.  Supporting devices
+include all iPad&#xAE; models, iPhone&#xAE; 3GS and above, and iPod&#xAE; Touch 3rd
 Generation or later. To install apps onto a device, you must also be a
-member of Apple's
+member of Apple&apos;s
 <a class="external" href="https://developer.apple.com/programs/ios/">iOS Developer Program</a>,
 which costs $99 per year. This guide shows how to deploy apps to the
-iOS emulator, for which you don't need to register with the developer
+iOS emulator, for which you don&apos;t need to register with the developer
 program.</p>
-
-<h2><a name="iOS%20Platform%20Guide_install_the_sdk">Install the SDK</a></h2>
-
+<h2 id="install-the-sdk"><a name="iOS%20Platform%20Guide_install_the_sdk">Install the SDK</a></h2>
 <p>There are two ways to download Xcode:</p>
-
 <ul>
 <li><p>from the <a class="external" href="https://itunes.apple.com/us/app/xcode/id497799835?mt=12">App Store</a>,
-available by searching for "Xcode" in the <strong>App Store</strong> application.</p></li>
+available by searching for &quot;Xcode&quot; in the <strong>App Store</strong> application.</p>
+</li>
 <li><p>from <a class="external" href="https://developer.apple.com/downloads/index.action">Apple Developer Downloads</a>,
-which requires registration as an Apple Developer.</p></li>
+which requires registration as an Apple Developer.</p>
+</li>
 </ul>
-
 <p>Once Xcode is installed, several command-line tools need to be enabled
 for Cordova to run. From the <strong>Xcode</strong> menu, select <strong>Preferences</strong>,
 then the <strong>Downloads</strong> tab. From the <strong>Components</strong> panel, press the
 <strong>Install</strong> button next to the <strong>Command Line Tools</strong> listing.</p>
-
-<h2><a name="iOS%20Platform%20Guide_open_a_project_in_the_sdk">Open a Project in the SDK</a></h2>
-
+<h2 id="open-a-project-in-the-sdk"><a name="iOS%20Platform%20Guide_open_a_project_in_the_sdk">Open a Project in the SDK</a></h2>
 <p>Use the <code>cordova</code> utility to set up a new project, as described in The
 Cordova <a href="guide_cli_index.md.html#The%20Command-Line%20Interface">The Command-Line Interface</a>. For example, in a source-code directory:</p>
-
-<pre class="prettyprint"><code>    $ cordova create hello com.example.hello "HelloWorld"
+<pre class="prettyprint"><code>    $ cordova create hello com.example.hello &quot;HelloWorld&quot;
     $ cd hello
     $ cordova platform add ios
-    $ cordova prepare              # or "cordova build"
-</code></pre>
-
-<p>Once created, you can open it from within Xcode. Double-click to open
+    $ cordova prepare              # or &quot;cordova build&quot;
+</code></pre><p>Once created, you can open it from within Xcode. Double-click to open
 the <code>hello/platforms/ios/hello.xcodeproj</code> file.  The screen should
 look like this:</p>
-
-<p><img src="img/guide/platforms/ios/helloworld_project.png" alt="" title=""></p>
-
-<h2><a name="iOS%20Platform%20Guide_deploy_to_emulator">Deploy to Emulator</a></h2>
-
+<p><img src="img/guide/platforms/ios/helloworld_project.png" alt=""></p>
+<h2 id="deploy-to-emulator"><a name="iOS%20Platform%20Guide_deploy_to_emulator">Deploy to Emulator</a></h2>
 <p>To preview the app in the iOS emulator:</p>
-
 <ol>
-<li><p>Make sure the <em>.xcodeproj</em> file is selected in the left panel.</p></li>
-<li><p>Select the <strong>hello</strong> app in the panel immediately to the right.</p></li>
-<li>
-<p>Select the intended device from the toolbar's <strong>Scheme</strong> menu, such
+<li><p>Make sure the <em>.xcodeproj</em> file is selected in the left panel.</p>
+</li>
+<li><p>Select the <strong>hello</strong> app in the panel immediately to the right.</p>
+</li>
+<li><p>Select the intended device from the toolbar&apos;s <strong>Scheme</strong> menu, such
 as the iPhone 6.0 Simulator as highlighted here:</p>
-
-<p><img src="img/guide/platforms/ios/select_xcode_scheme.png" alt="" title=""></p>
+<p><img src="img/guide/platforms/ios/select_xcode_scheme.png" alt=""></p>
 </li>
-<li>
-<p>Press the <strong>Run</strong> button that appears in the same toolbar to the
+<li><p>Press the <strong>Run</strong> button that appears in the same toolbar to the
 left of the <strong>Scheme</strong>. That builds, deploys and runs the
 application in the emulator. A separate emulator application opens
 to display the app:</p>
-
-<p><img src="img/guide/platforms/ios/HelloWorldStandard.png" alt="" title=""></p>
-
+<p><img src="img/guide/platforms/ios/HelloWorldStandard.png" alt=""></p>
 <p>Only one emulator may run at a time, so if you want to test the app
 in a different emulator, you need to quit the emulator application
 and run a different target within Xcode.</p>
 </li>
 </ol>
-
 <p>Xcode comes bundled with emulators for the latest versions of iPhone
-and iPad. Older versions may be available from the <strong>Xcode →
-Preferences → Downloads → Components</strong> panel.</p>
-
-<h2><a name="iOS%20Platform%20Guide_deploy_to_device">Deploy to Device</a></h2>
-
+and iPad. Older versions may be available from the <strong>Xcode &#x2192;
+Preferences &#x2192; Downloads &#x2192; Components</strong> panel.</p>
+<h2 id="deploy-to-device"><a name="iOS%20Platform%20Guide_deploy_to_device">Deploy to Device</a></h2>
 <p>For details about various requirements to deploy to a device, refer
 to the <em>Configuring Development and Distribution Assets</em> section of
-Apple's
+Apple&apos;s
 <a class="external" href="http://developer.apple.com/library/ios/#documentation/Xcode/Conceptual/ios_development_workflow/00-About_the_iOS_Application_Development_Workflow/introduction.html#//apple_ref/doc/uid/TP40007959">Tools Workflow Guide for iOS</a>.
 Briefly, you need to do the following before deploying:</p>
-
 <ol>
-<li><p>Join the Apple iOS Developer Program.</p></li>
+<li><p>Join the Apple iOS Developer Program.</p>
+</li>
 <li><p>Create a <em>Provisioning Profile</em> within the
 <a class="external" href="https://developer.apple.com/ios/manage/overview/index.action">iOS Provisioning Portal</a>.
 You can use its <em>Development Provisioning Assistant</em> to create and
-install the profile and certificate Xcode requires.</p></li>
-<li><p>Verify that the <em>Code Signing</em> section's <em>Code Signing Identity</em>
+install the profile and certificate Xcode requires.</p>
+</li>
+<li><p>Verify that the <em>Code Signing</em> section&apos;s <em>Code Signing Identity</em>
 within the project settings is set to your provisioning profile
-name.</p></li>
+name.</p>
+</li>
 </ol>
-
 <p>To deploy to the device:</p>
-
 <ol>
-<li><p>Use the USB cable to plug the device into your Mac.</p></li>
-<li><p>Select the name of the project in the Xcode window's <strong>Scheme</strong>
-drop-down list.</p></li>
+<li><p>Use the USB cable to plug the device into your Mac.</p>
+</li>
+<li><p>Select the name of the project in the Xcode window&apos;s <strong>Scheme</strong>
+drop-down list.</p>
+</li>
 <li><p>Select your device from the <strong>Device</strong> drop-down list. If it is
 plugged in via USB but still does not appear, press the
-<strong>Organizer</strong> button to resolve any errors.</p></li>
+<strong>Organizer</strong> button to resolve any errors.</p>
+</li>
 <li><p>Press the <strong>Run</strong> button to build, deploy and run the application
-on your device.</p></li>
+on your device.</p>
+</li>
 </ol>
-
-<h2><a name="iOS%20Platform%20Guide_common_problems">Common Problems</a></h2>
-
+<h2 id="common-problems"><a name="iOS%20Platform%20Guide_common_problems">Common Problems</a></h2>
 <p><strong>Deprecation Warnings</strong>: When an application programming interface
 (API) is changed or replaced by another API, it is marked as
 <em>deprecated</em>.  The API still works in the near term, but is eventually
 removed.  Some of these deprecated interfaces are reflected in Apache
 Cordova, and Xcode issues warnings about them when you build and
 deploy an application.</p>
-
-<p>Xcode's warning about the <code>invokeString</code> method concerns functionality
+<p>Xcode&apos;s warning about the <code>invokeString</code> method concerns functionality
 that launches an app from a custom URL. While the mechanism to load
 from a custom URL has changed, this code is still present to provide
 backwards functionality for apps created with older versions of
 Cordova.  The sample app does not use this functionality, so these
 warnings can be ignored.  To prevent these warnings from appearing,
 remove the code that references the deprecated invokeString API:</p>
-
 <ul>
-<li>
-<p>Edit the <em>Classes/MainViewController.m</em> file, surround the following
+<li><p>Edit the <em>Classes/MainViewController.m</em> file, surround the following
 block of code with <code>/*</code> and <code>*/</code> comments as shown below, then type
 <strong>Command-s</strong> to save the file:</p>
-
-<pre class="prettyprint"><code>(void)webViewDidFinishLoad:(UIWebView*)theWebView
-{
-// only valid if ___PROJECTNAME__-Info.plist specifies a protocol to handle
-/*
-if (self.invokeString) {
-  // this is passed before the <a href="cordova_events_events.md.html#deviceready">deviceready</a> event is fired, so you can access it in js when you receive <a href="cordova_events_events.md.html#deviceready">deviceready</a>
-  NSLog(@"DEPRECATED: window.invokeString - use the window.handleOpenURL(url) function instead, which is always called when the app is launched through a custom scheme url.");
-  NSString* jsString = [NSString stringWithFormat:@"var invokeString = \"%@\";", self.invokeString];
-  [theWebView stringByEvaluatingJavaScriptFromString:jsString];
-}
-*/
-// Black base color for background matches the native apps
-theWebView.backgroundColor = [UIColor blackColor];
-
-
-return [super webViewDidFinishLoad:theWebView];
-}
-</code></pre>
-</li>
-<li>
-<p>Edit the <em>Classes/AppViewDelegate.m</em> file, comment out the following
+<pre class="prettyprint"><code>  (void)webViewDidFinishLoad:(UIWebView*)theWebView
+  {
+  // only valid if ___PROJECTNAME__-Info.plist specifies a protocol to handle
+  /*
+  if (self.invokeString) {
+    // this is passed before the <a href="cordova_events_events.md.html#deviceready">deviceready</a> event is fired, so you can access it in js when you receive <a href="cordova_events_events.md.html#deviceready">deviceready</a>
+    NSLog(@&quot;DEPRECATED: window.invokeString - use the window.handleOpenURL(url) function instead, which is always called when the app is launched through a custom scheme url.&quot;);
+    NSString* jsString = [NSString stringWithFormat:@&quot;var invokeString = \&quot;%@\&quot;;&quot;, self.invokeString];
+    [theWebView stringByEvaluatingJavaScriptFromString:jsString];
+  }
+  */
+  // Black base color for background matches the native apps
+  theWebView.backgroundColor = [UIColor blackColor];
+
+  return [super webViewDidFinishLoad:theWebView];
+  }
+</code></pre></li>
+<li><p>Edit the <em>Classes/AppViewDelegate.m</em> file, comment out the following
 line by inserting a double slash as shown below, then type
 <strong>Command-s</strong> to save the file:</p>
-
-<pre class="prettyprint"><code>//self.viewController.invokeString = invokeString;
-</code></pre>
+<pre class="prettyprint"><code>  //self.viewController.invokeString = invokeString;
+</code></pre></li>
+<li><p>Press <strong>Command-b</strong> to rebuild the project and eliminate the warnings.</p>
 </li>
-<li><p>Press <strong>Command-b</strong> to rebuild the project and eliminate the warnings.</p></li>
 </ul>
-
 <!-- Does this fix only last until the next "cordova prepare"? -->
-
 <p><strong>Missing Headers</strong>: Compilation errors relating to missing headers
 result from problems with the build location, and can be fixed 
 via Xcode preferences:</p>
-
 <ol>
-<li><p>Select <strong>Xcode → Preferences → Locations</strong>.</p></li>
-<li>
-<p>In the <strong>Derived Data</strong> section, press the <strong>Advanced</strong> button and
+<li><p>Select <strong>Xcode &#x2192; Preferences &#x2192; Locations</strong>.</p>
+</li>
+<li><p>In the <strong>Derived Data</strong> section, press the <strong>Advanced</strong> button and
 select <strong>Unique</strong> as the <strong>Build Location</strong> as shown here:</p>
-
-<p><img src="img/guide/platforms/ios/xcode_build_location.png" alt="" title=""></p>
+<p><img src="img/guide/platforms/ios/xcode_build_location.png" alt=""></p>
 </li>
 </ol>
-
 <p>This is the default setting for a new Xcode install, but it may be set
 differently following an upgrade from an older version of Xcode.</p>
-
-<p>For further information, consult Apple's documentation:</p>
-
+<p>For further information, consult Apple&apos;s documentation:</p>
 <ul>
-<li><p><a class="external" href="http://developer.apple.com/library/ios/#referencelibrary/GettingStarted/RoadMapiOS/index.html#//apple_ref/doc/uid/TP40011343">Start Developing iOS Apps Today</a> provides a quick overview of steps for developing iOS Apps.</p></li>
+<li><p><a class="external" href="http://developer.apple.com/library/ios/#referencelibrary/GettingStarted/RoadMapiOS/index.html#//apple_ref/doc/uid/TP40011343">Start Developing iOS Apps Today</a> provides a quick overview of steps for developing iOS Apps.</p>
+</li>
 <li><p><a class="external" href="https://developer.apple.com/membercenter/index.action">Member Center home page</a>
-provides links to several iOS technical resources including
-technical resources, the provisioning portal, distribution guides
-and community forums.</p></li>
-<li><p><a class="external" href="http://developer.apple.com/library/ios/#documentation/Xcode/Conceptual/ios_development_workflow/00-About_the_iOS_Application_Development_Workflow/introduction.html#//apple_ref/doc/uid/TP40007959">Tools Workflow Guide for iOS</a></p></li>
-<li><p><a class="external" href="http://developer.apple.com/library/ios/#documentation/ToolsLanguages/Conceptual/Xcode4UserGuide/000-About_Xcode/about.html#//apple_ref/doc/uid/TP40010215">Xcode 4 User Guide</a></p></li>
+ provides links to several iOS technical resources including
+ technical resources, the provisioning portal, distribution guides
+ and community forums.</p>
+</li>
+<li><p><a class="external" href="http://developer.apple.com/library/ios/#documentation/Xcode/Conceptual/ios_development_workflow/00-About_the_iOS_Application_Development_Workflow/introduction.html#//apple_ref/doc/uid/TP40007959">Tools Workflow Guide for iOS</a></p>
+</li>
+<li><p><a class="external" href="http://developer.apple.com/library/ios/#documentation/ToolsLanguages/Conceptual/Xcode4UserGuide/000-About_Xcode/about.html#//apple_ref/doc/uid/TP40010215">Xcode 4 User Guide</a></p>
+</li>
 <li><p><a class="external" href="https://developer.apple.com/videos/wwdc/2012/">Session Videos</a> from
-the Apple World Wide Developer Conference 2012 (WWDC2012)</p></li>
+the Apple World Wide Developer Conference 2012 (WWDC2012)</p>
+</li>
 <li><p>The <a class="external" href="http://developer.apple.com/library/mac/#documentation/Darwin/Reference/ManPages/man1/xcode-select.1.html">xcode-select command</a>,
-which helps specify the correct version of Xcode if more than one is installed.</p></li>
+which helps specify the correct version of Xcode if more than one is installed.</p>
+</li>
 </ul>
-
-<p>(Mac®, OS X®, Apple®, Xcode®, App Store℠, iPad®, iPhone®, iPod® and  Finder® are Trademarks of Apple Inc.)</p>
+<p>(Mac&#xAE;, OS X&#xAE;, Apple&#xAE;, Xcode&#xAE;, App Store&#x2120;, iPad&#xAE;, iPhone&#xAE;, iPod&#xAE; and  Finder&#xAE; are Trademarks of Apple Inc.)</p>
 
             </div>
         </div>

Modified: cordova/site/public/docs/en/edge/guide_platforms_ios_plugin.md.html
URL: http://svn.apache.org/viewvc/cordova/site/public/docs/en/edge/guide_platforms_ios_plugin.md.html?rev=1673862&r1=1673861&r2=1673862&view=diff
==============================================================================
--- cordova/site/public/docs/en/edge/guide_platforms_ios_plugin.md.html (original)
+++ cordova/site/public/docs/en/edge/guide_platforms_ios_plugin.md.html Wed Apr 15 16:43:43 2015
@@ -1,4 +1,3 @@
-<!DOCTYPE html>
 <!--
     Licensed to the Apache Software Foundation (ASF) under one
     or more contributor license agreements.  See the NOTICE file
@@ -16,12 +15,14 @@
     KIND, either express or implied.  See the License for the
     specific language governing permissions and limitations
     under the License.
---><html lang="en">
+-->
+
+<!DOCTYPE html>
+<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">
-<meta name="robots" content="noindex">
+        <meta name="generator" content="joDoc"><meta name="robots" label="noindex">
 
         <title>Apache Cordova API Documentation</title>
 
@@ -40,7 +41,7 @@
 <option value="3.1.0">3.1.0</option>
 </optgroup>
 <optgroup label="English" value="en">
-<option selected value="edge">edge</option>
+<option selected="selected" value="edge">edge</option>
 <option value="4.0.0">4.0.0</option>
 <option value="3.6.0">3.6.0</option>
 <option value="3.5.0">3.5.0</option>
@@ -104,7 +105,9 @@
 <option value="3.1.0">3.1.0</option>
 <option value="2.0.0">2.0.0</option>
 </optgroup>
-<optgroup label="Polish" value="pl"><option value="edge">edge</option></optgroup>
+<optgroup label="Polish" value="pl">
+<option value="edge">edge</option>
+</optgroup>
 <optgroup label="Russian" value="ru">
 <option value="edge">edge</option>
 <option value="3.5.0">3.5.0</option>
@@ -121,23 +124,13 @@
 <option value="3.5.0">3.5.0</option>
 <option value="3.4.0">3.4.0</option>
 <option value="3.1.0">3.1.0</option>
-</optgroup></select>
+</optgroup>
+</select>
             </small>
         </div>
         <div id="subheader">
             <h1>iOS Plugins</h1>
-            <small><select><option value="iOS%2520Plugins">iOS Plugins</option>
-<option value="iOS%20Plugins_plugin_class_mapping">      - Plugin Class Mapping</option>
-<option value="iOS%20Plugins_plugin_initialization_and_lifetime">      - Plugin Initialization and Lifetime</option>
-<option value="iOS%20Plugins_writing_an_ios_cordova_plugin">      - Writing an iOS Cordova Plugin</option>
-<option value="iOS%20Plugins_ios_cdvpluginresult_message_types">      - iOS CDVPluginResult Message Types</option>
-<option value="iOS%20Plugins_echo_ios_plugin_example">      - Echo iOS Plugin Example</option>
-<option value="iOS%20Plugins_ios_integration">      - iOS Integration</option>
-<option value="iOS%20Plugins_threading">      - Threading</option>
-<option value="iOS%20Plugins_debugging_ios_plugins">      - 
-Debugging iOS Plugins
-</option>
-<option value="iOS%20Plugins_common_pitfalls">      - Common Pitfalls</option></select></small>
+            <small><select><option value="iOS%2520Plugins">iOS Plugins</option><option value="iOS%20Plugins_plugin_class_mapping">&#xA0;&#xA0;&#xA0;&#xA0;&#xA0;&#xA0;- Plugin Class Mapping</option><option value="iOS%20Plugins_plugin_initialization_and_lifetime">&#xA0;&#xA0;&#xA0;&#xA0;&#xA0;&#xA0;- Plugin Initialization and Lifetime</option><option value="iOS%20Plugins_writing_an_ios_cordova_plugin">&#xA0;&#xA0;&#xA0;&#xA0;&#xA0;&#xA0;- Writing an iOS Cordova Plugin</option><option value="iOS%20Plugins_ios_cdvpluginresult_message_types">&#xA0;&#xA0;&#xA0;&#xA0;&#xA0;&#xA0;- iOS CDVPluginResult Message Types</option><option value="iOS%20Plugins_echo_ios_plugin_example">&#xA0;&#xA0;&#xA0;&#xA0;&#xA0;&#xA0;- Echo iOS Plugin Example</option><option value="iOS%20Plugins_ios_integration">&#xA0;&#xA0;&#xA0;&#xA0;&#xA0;&#xA0;- iOS Integration</option><option value="iOS%20Plugins_threading">&#xA0;&#xA0;&#xA0;&#xA0;&#xA0;&#xA0;- Threading</option><option value="iOS%20Plugins_debugging_ios_plu
 gins">&#xA0;&#xA0;&#xA0;&#xA0;&#xA0;&#xA0;- Debugging iOS Plugins</option><option value="iOS%20Plugins_common_pitfalls">&#xA0;&#xA0;&#xA0;&#xA0;&#xA0;&#xA0;- Common Pitfalls</option></select></small>
         </div>
 
         <div id="sidebar">
@@ -170,80 +163,60 @@ Debugging iOS Plugins
         <div id="scrollable">
             <div id="content">
                 <h1><a name="iOS%20Plugins">iOS Plugins</a></h1>
-
 <p>This section provides details for how to implement native plugin code
 on the iOS platform. Before reading this, see Application Plugins for
-an overview of the plugin's structure and its common JavaScript
+an overview of the plugin&apos;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>An iOS plugin is implemented as an Objective-C class that extends the
-<code>CDVPlugin</code> class.  For JavaScript's <code>exec</code> method's <code>service</code>
+<code>CDVPlugin</code> class.  For JavaScript&apos;s <code>exec</code> method&apos;s <code>service</code>
 parameter to map to an Objective-C class, each plugin class must be
-registered as a <code>&lt;feature&gt;</code> tag in the named application directory's
+registered as a <code>&lt;feature&gt;</code> tag in the named application directory&apos;s
 <code>config.xml</code> file.</p>
-
-<h2><a name="iOS%20Plugins_plugin_class_mapping">Plugin Class Mapping</a></h2>
-
+<h2 id="plugin-class-mapping"><a name="iOS%20Plugins_plugin_class_mapping">Plugin Class Mapping</a></h2>
 <p>The JavaScript portion of a plugin uses the <code>cordova.exec</code> method as
 follows:</p>
-
 <pre class="prettyprint"><code>    exec(&lt;successFunction&gt;, &lt;failFunction&gt;, &lt;service&gt;, &lt;action&gt;, [&lt;args&gt;]);
-</code></pre>
-
-<p>This marshals a request from the <code>UIWebView</code> to the iOS native side,
+</code></pre><p>This marshals a request from the <code>UIWebView</code> to the iOS native side,
 effectively calling the <code>action</code> method on the <code>service</code> class, with
 the arguments passed in the <code>args</code> array.</p>
-
 <p>Specify the plugin as a <code>&lt;feature&gt;</code> tag in your Cordova-iOS
-application's project's <code>config.xml</code> file, using the <code>plugin.xml</code> file
+application&apos;s project&apos;s <code>config.xml</code> file, using the <code>plugin.xml</code> file
 to inject this markup automatically, as described in Application
 Plugins:</p>
-
-<pre class="prettyprint"><code>    &lt;feature name="LocalStorage"&gt;
-        &lt;param name="ios-package" value="CDVLocalStorage" /&gt;
+<pre class="prettyprint"><code>    &lt;feature name=&quot;LocalStorage&quot;&gt;
+        &lt;param name=&quot;ios-package&quot; value=&quot;CDVLocalStorage&quot; /&gt;
     &lt;/feature&gt;
-</code></pre>
-
-<p>The feature's <code>name</code> attribute should match what you specify as the
-JavaScript <code>exec</code> call's <code>service</code> parameter. The <code>value</code> attribute
-should match the name of the plugin's Objective-C class. The <code>&lt;param&gt;</code>
-element's <code>name</code> should always be <code>ios-package</code>.  If you do not follow
+</code></pre><p>The feature&apos;s <code>name</code> attribute should match what you specify as the
+JavaScript <code>exec</code> call&apos;s <code>service</code> parameter. The <code>value</code> attribute
+should match the name of the plugin&apos;s Objective-C class. The <code>&lt;param&gt;</code>
+element&apos;s <code>name</code> should always be <code>ios-package</code>.  If you do not follow
 these guidelines, the plugin may compile, but Cordova may still not be
 able to access it.</p>
-
-<h2><a name="iOS%20Plugins_plugin_initialization_and_lifetime">Plugin Initialization and Lifetime</a></h2>
-
+<h2 id="plugin-initialization-and-lifetime"><a name="iOS%20Plugins_plugin_initialization_and_lifetime">Plugin Initialization and Lifetime</a></h2>
 <p>One instance of a plugin object is created for the life of each
 <code>UIWebView</code>. Plugins are ordinarily instantiated when first referenced
 by a call from JavaScript. Otherwise they can be instantiated by
 setting a <code>param</code> named <code>onload</code> to <code>true</code> in the <code>config.xml</code> file:</p>
-
-<pre class="prettyprint"><code>    &lt;feature name="Echo"&gt;
-        &lt;param name="ios-package" value="Echo" /&gt;
-        &lt;param name="onload" value="true" /&gt;
+<pre class="prettyprint"><code>    &lt;feature name=&quot;Echo&quot;&gt;
+        &lt;param name=&quot;ios-package&quot; value=&quot;Echo&quot; /&gt;
+        &lt;param name=&quot;onload&quot; value=&quot;true&quot; /&gt;
     &lt;/feature&gt;
-</code></pre>
-
-<p>There is <em>no</em> designated initializer for plugins. Instead, plugins
+</code></pre><p>There is <em>no</em> designated initializer for plugins. Instead, plugins
 should use the <code>pluginInitialize</code> method for their startup logic.</p>
-
 <p>Plugins with long-running requests, background activity such as media
 playback, listeners, or that maintain internal state should implement
 the <code>onReset</code> method to clean up those activities. The method runs
 when the <code>UIWebView</code> navigates to a new page or refreshes, which
 reloads the JavaScript.</p>
-
-<h2><a name="iOS%20Plugins_writing_an_ios_cordova_plugin">Writing an iOS Cordova Plugin</a></h2>
-
+<h2 id="writing-an-ios-cordova-plugin"><a name="iOS%20Plugins_writing_an_ios_cordova_plugin">Writing an iOS Cordova Plugin</a></h2>
 <p>A JavaScript call fires off a plugin request to the native side, and
 the corresponding iOS Objective-C plugin is mapped properly in the
 <code>config.xml</code> file, but what does the final iOS Objective-C plugin
 class look like?  Whatever is dispatched to the plugin with
-JavaScript's <code>exec</code> function is passed into the corresponding plugin
-class's <code>action</code> method. A plugin method has this signature:</p>
-
+JavaScript&apos;s <code>exec</code> function is passed into the corresponding plugin
+class&apos;s <code>action</code> method. A plugin method has this signature:</p>
 <pre class="prettyprint"><code>    - (void)myMethod:(CDVInvokedUrlCommand*)command
     {
         CDVPluginResult* pluginResult = nil;
@@ -252,63 +225,50 @@ class's <code>action</code> method. A pl
         if (myarg != nil) {
             pluginResult = [CDVPluginResult resultWithStatus:CDVCommandStatus_OK];
         } else {
-            pluginResult = [CDVPluginResult resultWithStatus:CDVCommandStatus_ERROR messageAsString:@"Arg was null"];
+            pluginResult = [CDVPluginResult resultWithStatus:CDVCommandStatus_ERROR messageAsString:@&quot;Arg was null&quot;];
         }
         [self.commandDelegate sendPluginResult:pluginResult callbackId:command.callbackId];
     }
-</code></pre>
-
-<p>For more details, see
+</code></pre><p>For more details, see
  <code>[CDVInvokedUrlCommand.h](https://github.com/apache/cordova-ios/blob/master/CordovaLib/Classes/CDVInvokedUrlCommand.h)</code>,
  <code>[CDVPluginResult.h](https://github.com/apache/cordova-ios/blob/master/CordovaLib/Classes/CDVPluginResult.h)</code>,
 and
  <code>[CDVCommandDelegate.h](https://github.com/apache/cordova-ios/blob/master/CordovaLib/Classes/CDVCommandDelegate.h)</code>.</p>
-
-<h2><a name="iOS%20Plugins_ios_cdvpluginresult_message_types">iOS CDVPluginResult Message Types</a></h2>
-
+<h2 id="ios-cdvpluginresult-message-types"><a name="iOS%20Plugins_ios_cdvpluginresult_message_types">iOS CDVPluginResult Message Types</a></h2>
 <p>You can use <code>CDVPluginResult</code> to return a variety of result types back to
 the JavaScript callbacks, using class methods that follow this pattern:</p>
-
 <pre class="prettyprint"><code>    + (CDVPluginResult*)resultWithStatus:(CDVCommandStatus)statusOrdinal messageAs...
-</code></pre>
-
-<p>You can create <code>String</code>, <code>Int</code>, <code>Double</code>, <code>Bool</code>, <code>Array</code>,
+</code></pre><p>You can create <code>String</code>, <code>Int</code>, <code>Double</code>, <code>Bool</code>, <code>Array</code>,
 <code>Dictionary</code>, <code>ArrayBuffer</code>, and <code>Multipart</code> types. You can also leave
 out any arguments to send a status, or return an error, or even choose
 not to send any plugin result, in which case neither callback fires.</p>
-
 <p>Note the following for complex return values:</p>
-
 <ul>
 <li><p><code>messageAsArrayBuffer</code> expects <code>NSData*</code> and converts to an
 <code>ArrayBuffer</code> in the JavaScript callback. Likewise, any
 <code>ArrayBuffer</code> the JavaScript sends to a plugin are converted to
-<code>NSData*</code>.</p></li>
+<code>NSData*</code>.</p>
+</li>
 <li><p><code>messageAsMultipart</code> expects an <code>NSArray*</code> containing any of the
 other supported types, and sends the entire array as the <code>arguments</code>
 to your JavaScript callback.  This way, all of the arguments are
 serialized or deserialized as necessary, so it is safe to return
-<code>NSData*</code> as multipart, but not as <code>Array</code>/<code>Dictionary</code>.</p></li>
+<code>NSData*</code> as multipart, but not as <code>Array</code>/<code>Dictionary</code>.</p>
+</li>
 </ul>
-
-<h2><a name="iOS%20Plugins_echo_ios_plugin_example">Echo iOS Plugin Example</a></h2>
-
-<p>To match the JavaScript interface's <em>echo</em> feature described in
+<h2 id="echo-ios-plugin-example"><a name="iOS%20Plugins_echo_ios_plugin_example">Echo iOS Plugin Example</a></h2>
+<p>To match the JavaScript interface&apos;s <em>echo</em> feature described in
 Application Plugins, use the <code>plugin.xml</code> to inject a <code>feature</code>
-specification to the local platform's <code>config.xml</code> file:</p>
-
-<pre class="prettyprint"><code>    &lt;platform name="ios"&gt;
-        &lt;config-file target="config.xml" parent="/*"&gt;
-            &lt;feature name="Echo"&gt;
-                &lt;param name="ios-package" value="Echo" /&gt;
+specification to the local platform&apos;s <code>config.xml</code> file:</p>
+<pre class="prettyprint"><code>    &lt;platform name=&quot;ios&quot;&gt;
+        &lt;config-file target=&quot;config.xml&quot; parent=&quot;/*&quot;&gt;
+            &lt;feature name=&quot;Echo&quot;&gt;
+                &lt;param name=&quot;ios-package&quot; value=&quot;Echo&quot; /&gt;
             &lt;/feature&gt;
         &lt;/config-file&gt;
     &lt;/platform&gt;
-</code></pre>
-
-<p>Then we would add the following <code>Echo.h</code> and <code>Echo.m</code> files to the
+</code></pre><p>Then we would add the following <code>Echo.h</code> and <code>Echo.m</code> files to the
 <code>Plugins</code> folder within the Cordova-iOS application directory:</p>
-
 <pre class="prettyprint"><code>    /********* Echo.h Cordova Plugin Header *******/
 
     #import &lt;Cordova/CDV.h&gt;
@@ -321,7 +281,7 @@ specification to the local platform's <c
 
     /********* Echo.m Cordova Plugin Implementation *******/
 
-    #import "Echo.h"
+    #import &quot;Echo.h&quot;
     #import &lt;Cordova/CDV.h&gt;
 
     @implementation Echo
@@ -341,25 +301,20 @@ specification to the local platform's <c
     }
 
     @end
-</code></pre>
-
-<p>The necessary imports at the top of the file extends the class from
+</code></pre><p>The necessary imports at the top of the file extends the class from
 <code>CDVPlugin</code>.  In this case, the plugin only supports a single <code>echo</code>
 action. It obtains the echo string by calling the <code>objectAtIndex</code>
 method get the first parameter of the <code>arguments</code> array, which
 corresponds to the arguments passed in by the JavaScript <code>exec()</code>
 function.</p>
-
 <p>It checks the parameter to make sure it is not <code>nil</code> or an empty
 string, returning a <code>PluginResult</code> with an <code>ERROR</code> status if so.  If
 the parameter passes the check, it returns a <code>PluginResult</code> with an
 <code>OK</code> status, passing in the original <code>echo</code> string.  Finally, it sends
 the result to <code>self.commandDelegate</code>, which executes the <code>exec</code>
-method's success or failure callbacks on the JavaScript side. If the
+method&apos;s success or failure callbacks on the JavaScript side. If the
 success callback is called, it passes in the <code>echo</code> parameter.</p>
-
-<h2><a name="iOS%20Plugins_ios_integration">iOS Integration</a></h2>
-
+<h2 id="ios-integration"><a name="iOS%20Plugins_ios_integration">iOS Integration</a></h2>
 <p>The <code>CDVPlugin</code> class features other methods that your plugin can
 override.  For example, you can capture the <code><a href="cordova_events_events.md.html#pause">pause</a></code>, <code><a href="cordova_events_events.md.html#resume">resume</a></code>, app
 terminate and <code>handleOpenURL</code> events. See the
@@ -367,14 +322,11 @@ terminate and <code>handleOpenURL</code>
 and
 <a class="external" href="https://github.com/apache/cordova-ios/blob/master/CordovaLib/Classes/CDVPlugin.m">CDVPlugin.m</a>
 class for guidance.</p>
-
-<h2><a name="iOS%20Plugins_threading">Threading</a></h2>
-
+<h2 id="threading"><a name="iOS%20Plugins_threading">Threading</a></h2>
 <p>Plugin methods ordinarily execute in the same thread as the main
 interface. If your plugin requires a great deal of processing or
 requires a blocking call, you should use a background thread. For
 example:</p>
-
 <pre class="prettyprint"><code>    - (void)myPluginMethod:(CDVInvokedUrlCommand*)command
     {
         // Check command.arguments here.
@@ -386,26 +338,21 @@ example:</p>
             [self.commandDelegate sendPluginResult:pluginResult callbackId:command.callbackId];
         }];
     }
-</code></pre>
-
-<h2><a name="iOS%20Plugins_debugging_ios_plugins">
-Debugging iOS Plugins
-</a></h2>
-
-<p>To debug on the Objective-C side, you need Xcode's built-in debugger.
-For JavaScript, on iOS 5.0 you can use <a class="external" href="https://github.com/apache/cordova-weinre">Weinre, an Apache Cordova
+</code></pre><h2 id="debugging-ios-plugins"><a name="iOS%20Plugins_debugging_ios_plugins">Debugging iOS Plugins</a></h2>
+<p>To debug on the Objective-C side, you need Xcode&apos;s built-in debugger.
+For JavaScript, on iOS 5.0 or greater you can use <a class="external" href="https://github.com/apache/cordova-weinre">Weinre, an Apache Cordova
 Project</a> or <a class="external" href="http://www.iwebinspector.com/">iWebInspector,
-a third-party utility</a>.  For iOS 6, you
-can attach Safari 6.0 to the app running within the iOS 6 Simulator.</p>
-
-<h2><a name="iOS%20Plugins_common_pitfalls">Common Pitfalls</a></h2>
-
+a third-party utility</a>.  For iOS 8, you
+can attach Safari 8.0 to the app running within the iOS 8 Simulator.</p>
+<h2 id="common-pitfalls"><a name="iOS%20Plugins_common_pitfalls">Common Pitfalls</a></h2>
 <ul>
-<li><p>Don't forget to add your plugin's mapping to <code>config.xml</code>. If you
-forget, an error is logged in the Xcode console.</p></li>
-<li><p>Don't forget to add any hosts you connect to in the whitelist, as
+<li><p>Don&apos;t forget to add your plugin&apos;s mapping to <code>config.xml</code>. If you
+forget, an error is logged in the Xcode console.</p>
+</li>
+<li><p>Don&apos;t forget to add any hosts you connect to in the whitelist, as
 described in Domain <a href="guide_appdev_whitelist_index.md.html#Whitelist%20Guide">Whitelist Guide</a>. If you forget, an error is
-logged in the Xcode console.</p></li>
+logged in the Xcode console.</p>
+</li>
 </ul>
 
             </div>

Modified: cordova/site/public/docs/en/edge/guide_platforms_ios_tools.md.html
URL: http://svn.apache.org/viewvc/cordova/site/public/docs/en/edge/guide_platforms_ios_tools.md.html?rev=1673862&r1=1673861&r2=1673862&view=diff
==============================================================================
--- cordova/site/public/docs/en/edge/guide_platforms_ios_tools.md.html (original)
+++ cordova/site/public/docs/en/edge/guide_platforms_ios_tools.md.html Wed Apr 15 16:43:43 2015
@@ -1,4 +1,3 @@
-<!DOCTYPE html>
 <!--
     Licensed to the Apache Software Foundation (ASF) under one
     or more contributor license agreements.  See the NOTICE file
@@ -16,12 +15,14 @@
     KIND, either express or implied.  See the License for the
     specific language governing permissions and limitations
     under the License.
---><html lang="en">
+-->
+
+<!DOCTYPE html>
+<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">
-<meta name="robots" content="noindex">
+        <meta name="generator" content="joDoc"><meta name="robots" label="noindex">
 
         <title>Apache Cordova API Documentation</title>
 
@@ -40,7 +41,7 @@
 <option value="3.1.0">3.1.0</option>
 </optgroup>
 <optgroup label="English" value="en">
-<option selected value="edge">edge</option>
+<option selected="selected" value="edge">edge</option>
 <option value="4.0.0">4.0.0</option>
 <option value="3.6.0">3.6.0</option>
 <option value="3.5.0">3.5.0</option>
@@ -104,7 +105,9 @@
 <option value="3.1.0">3.1.0</option>
 <option value="2.0.0">2.0.0</option>
 </optgroup>
-<optgroup label="Polish" value="pl"><option value="edge">edge</option></optgroup>
+<optgroup label="Polish" value="pl">
+<option value="edge">edge</option>
+</optgroup>
 <optgroup label="Russian" value="ru">
 <option value="edge">edge</option>
 <option value="3.5.0">3.5.0</option>
@@ -121,17 +124,13 @@
 <option value="3.5.0">3.5.0</option>
 <option value="3.4.0">3.4.0</option>
 <option value="3.1.0">3.1.0</option>
-</optgroup></select>
+</optgroup>
+</select>
             </small>
         </div>
         <div id="subheader">
             <h1>iOS Shell Tool Guide</h1>
-            <small><select><option value="iOS%2520Shell%2520Tool%2520Guide">iOS Shell Tool Guide</option>
-<option value="iOS%20Shell%20Tool%20Guide_create_a_project">      - Create a Project</option>
-<option value="iOS%20Shell%20Tool%20Guide_build_a_project">      - Build a Project</option>
-<option value="iOS%20Shell%20Tool%20Guide_run_app_on_an_emulator">      - Run App on an Emulator</option>
-<option value="iOS%20Shell%20Tool%20Guide_releasing">      - Releasing</option>
-<option value="iOS%20Shell%20Tool%20Guide_logging">      - Logging</option></select></small>
+            <small><select><option value="iOS%2520Shell%2520Tool%2520Guide">iOS Shell Tool Guide</option><option value="iOS%20Shell%20Tool%20Guide_create_a_project">&#xA0;&#xA0;&#xA0;&#xA0;&#xA0;&#xA0;- Create a Project</option><option value="iOS%20Shell%20Tool%20Guide_build_a_project">&#xA0;&#xA0;&#xA0;&#xA0;&#xA0;&#xA0;- Build a Project</option><option value="iOS%20Shell%20Tool%20Guide_run_app_on_an_emulator">&#xA0;&#xA0;&#xA0;&#xA0;&#xA0;&#xA0;- Run App on an Emulator</option><option value="iOS%20Shell%20Tool%20Guide_run_app_on_a_device">&#xA0;&#xA0;&#xA0;&#xA0;&#xA0;&#xA0;- Run App on a Device</option><option value="iOS%20Shell%20Tool%20Guide_releasing">&#xA0;&#xA0;&#xA0;&#xA0;&#xA0;&#xA0;- Releasing</option><option value="iOS%20Shell%20Tool%20Guide_logging">&#xA0;&#xA0;&#xA0;&#xA0;&#xA0;&#xA0;- Logging</option></select></small>
         </div>
 
         <div id="sidebar">
@@ -164,59 +163,43 @@
         <div id="scrollable">
             <div id="content">
                 <h1><a name="iOS%20Shell%20Tool%20Guide">iOS Shell Tool Guide</a></h1>
-
-<p>This guide shows how to use Cordova's set of platform-centered shell
+<p>This guide shows how to use Cordova&apos;s set of platform-centered shell
 tools to develop iOS apps. This development path, discussed in the
 <a href="guide_overview_index.md.html#Overview">Overview</a>, may offer you a greater range of development options for iOS
-than the cross-platform CLI tool described in <a href="#The%20Command-Line%0AInterface">The Command-Line
+than the cross-platform CLI tool described in <a href="guide_cli_index.md.html#The%20Command-Line%0AInterface">The Command-Line
 Interface</a>.  For example, you need to use shell tools when deploying a
 custom Cordova WebView alongside native components. Before using
 either development path, you must first configure the SDK environment
 as described in the <a href="guide_platforms_ios_index.md.html#iOS%20Platform%20Guide">iOS Platform Guide</a>.  These tools rely upon
-Xcode's command-line tools such as <code>xcode-select</code> and <code>xcodebuild</code>.</p>
-
+Xcode&apos;s command-line tools such as <code>xcode-select</code> and <code>xcodebuild</code>.</p>
 <p>To enable shell tools for iOS, download Cordova from
 <a class="external" href="http://cordova.apache.org">cordova.apache.org</a>. The download contains
 separate archives for each platform. Expand each you wish to target,
 <code>ios</code> in this case. The relevant tools are typically available in the
 top-level <code>bin</code> directory, otherwise consult the <strong>README</strong> file for
 more detailed directions.</p>
-
 <p>These tools allow you to create, build, and run iOS apps.  For
 information on the additional command-line interface that enables
-plugin features across all platforms, see <a href="#Using%20Plugman%20to%20Manage%0APlugins">Using Plugman to Manage
+plugin features across all platforms, see <a href="plugin_ref_plugman.md.html#Using%20Plugman%20to%20Manage%0APlugins">Using Plugman to Manage
 Plugins</a>. See Application Plugins for details on how to develop
 plugins.</p>
-
-<h2><a name="iOS%20Shell%20Tool%20Guide_create_a_project">Create a Project</a></h2>
-
+<h2 id="create-a-project"><a name="iOS%20Shell%20Tool%20Guide_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
+the reverse-domain-style package identifier, and the app&apos;s display
 name.</p>
-
 <pre class="prettyprint"><code>    $ ./path/to/cordova-ios/bin/create /path/to/my_new_project com.example.project_name ProjectName
-</code></pre>
-
-<h2><a name="iOS%20Shell%20Tool%20Guide_build_a_project">Build a Project</a></h2>
-
+</code></pre><h2 id="build-a-project"><a name="iOS%20Shell%20Tool%20Guide_build_a_project">Build a Project</a></h2>
 <pre class="prettyprint"><code>    $ /path/to/my_new_project/cordova/build
-</code></pre>
-
-<h2><a name="iOS%20Shell%20Tool%20Guide_run_app_on_an_emulator">Run App on an Emulator</a></h2>
-
-<pre class="prettyprint"><code>    $ /path/to/my_new_project/cordova/run
-</code></pre>
-
-<h2><a name="iOS%20Shell%20Tool%20Guide_releasing">Releasing</a></h2>
-
-<pre class="prettyprint"><code>    $ /path/to/my_new_project/cordova/release
-</code></pre>
-
-<h2><a name="iOS%20Shell%20Tool%20Guide_logging">Logging</a></h2>
-
+</code></pre><h2 id="run-app-on-an-emulator"><a name="iOS%20Shell%20Tool%20Guide_run_app_on_an_emulator">Run App on an Emulator</a></h2>
+<pre class="prettyprint"><code>    $ /path/to/my_new_project/cordova/run --emulator
+</code></pre><h2 id="run-app-on-a-device"><a name="iOS%20Shell%20Tool%20Guide_run_app_on_a_device">Run App on a Device</a></h2>
+<pre class="prettyprint"><code>    $ /path/to/my_new_project/cordova/run --device
+</code></pre><h2 id="releasing"><a name="iOS%20Shell%20Tool%20Guide_releasing">Releasing</a></h2>
+<pre class="prettyprint"><code>    $ /path/to/my_new_project/cordova/build --release
+</code></pre><p>(modify the <code>cordova/build-release.xcconfig</code> file for your Code Signing identity)</p>
+<h2 id="logging"><a name="iOS%20Shell%20Tool%20Guide_logging">Logging</a></h2>
 <pre class="prettyprint"><code>    $ /path/to/my_new_project/cordova/log
 </code></pre>
-
             </div>
         </div>
 



---------------------------------------------------------------------
To unsubscribe, e-mail: commits-unsubscribe@cordova.apache.org
For additional commands, e-mail: commits-help@cordova.apache.org


Mime
View raw message