svn commit: r1618893 - /cordova/site/public/docs/en/edge/guide_next_index.md.html

[ma...@apache.org]

Author: marcelk
Date: Tue Aug 19 16:35:08 2014
New Revision: 1618893

URL: http://svn.apache.org/r1618893
Log:
CB-7263 publish update

Modified:
    cordova/site/public/docs/en/edge/guide_next_index.md.html

Modified: cordova/site/public/docs/en/edge/guide_next_index.md.html
URL: http://svn.apache.org/viewvc/cordova/site/public/docs/en/edge/guide_next_index.md.html?rev=1618893&r1=1618892&r2=1618893&view=diff
==============================================================================
--- cordova/site/public/docs/en/edge/guide_next_index.md.html (original)
+++ cordova/site/public/docs/en/edge/guide_next_index.md.html Tue Aug 19 16:35:08 2014
@@ -144,6 +144,9 @@ Testing on a simulator vs. on a real dev
 <option value="Debugging_other_options">      - Other Options</option>
 <option value="User%2520Interface">User Interface</option>
 <option value="User%20Interface_additional_ui_articles_and_resources">      - Additional UI Articles and Resources</option>
+<option value="Special%2520Considerations">Special Considerations</option>
+<option value="Special%20Considerations_platform_quirks">      - Platform Quirks</option>
+<option value="Special%20Considerations_loading_remote_content">      - Loading Remote Content</option>
 <option value="Keeping%2520Up">Keeping Up</option>
 <option value="Getting%2520Help">Getting Help</option></select></small>
         </div>
@@ -189,6 +192,7 @@ Testing on a simulator vs. on a real dev
 <li><a href="guide_next_index.md.html#Testing">Testing</a></li>
 <li><a href="guide_next_index.md.html#Debugging">Debugging</a></li>
 <li><a href="guide_next_index.md.html#User%20Interface">User Interface</a></li>
+<li><a href="guide_next_index.md.html#Special%20Considerations">Special Considerations</a></li>
 <li><a href="guide_next_index.md.html#Keeping%20Up">Keeping Up</a></li>
 <li>
 <a href="guide_next_index.md.html#Getting%20Help">Getting Help</a> </li>
@@ -344,7 +348,7 @@ Testing on a simulator vs. on a real dev
 
 <ul>
 <li>
-<a href="jquerymobile.com">jQuery Mobile</a> - jQuery Mobile automatically enhances your layout for mobile optimization. It also handles creating a SPA for you automatically.</li>
+<a class="external" href="http://jquerymobile.com">jQuery Mobile</a> - jQuery Mobile automatically enhances your layout for mobile optimization. It also handles creating a SPA for you automatically.</li>
 <li>
 <a class="external" href="http://ionicframework.com/">ionic</a> - This powerful UI framework actually has its own CLI to handle project creation. </li>
 <li>
@@ -364,6 +368,20 @@ Testing on a simulator vs. on a real dev
 
 <p>Although browser engines become more and more standards complaint, we still live in a prefixed world (-webkit and -ms.) The following article is valuable when developing UI’s in for cross browser apps: <a class="external" href="http://blogs.windows.com/windows_phone/b/wpdev/archive/2012/11/15/adapting-your-webkit-optimized-site-for-internet-explorer-10.aspx">http://blogs.windows.com/windows_phone/b/wpdev/archive/2012/11/15/adapting-your-webkit-optimized-site-for-internet-explorer-10.aspx</a></p>
 
+<h1><a name="Special%20Considerations">Special Considerations</a></h1>
+
+<p>Although Cordova makes cross-platform development easier, it's just not possible to provide 100% isolation from the underlying native platform. So do be aware of restrictions.</p>
+
+<h2><a name="Special%20Considerations_platform_quirks">Platform Quirks</a></h2>
+
+<p>While reading the documentation, look for sections which outline different behaviors or requirements on multiple platforms. If present, these would be in a section titled "Android Quirks", "iOS Quirks", etc. Read through these quirks and be aware of them as you work with Cordova.</p>
+
+<h2><a name="Special%20Considerations_loading_remote_content">Loading Remote Content</a></h2>
+
+<p>Invoking Cordova JavaScript functions from a remotely-loaded HTML page (an HTML page not stored locally on the device) is an unsupported configuration. This is because Cordova was not designed for this, and the Apache Cordova community does no testing of this configuration. While it can work in some circumstances, it is not recommended nor supported. There are challenges with the same origin policy, keeping the JavaScript and native portions of Cordova synchronized at the same version (since they are coupled via private APIs which may change), the trustworthiness of remote content calling native local functions, and potential app store rejection.</p>
+
+<p>The display of remotely-loaded HTML content in a webview should be done using Cordova's InAppBrowser. The InAppBrowser is designed so that JavaScript running there does not have access to the Cordova JavaScript APIs for the reasons listed above. Please refer to the <a href="guide_appdev_security_index.md.html#Security%20Guide">Security Guide</a>.</p>
+
 <h1><a name="Keeping%20Up">Keeping Up</a></h1>
 
 <p>Here are a few ways to keep up to date with Cordova.</p>