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 2014/06/27 01:55:49 UTC
svn commit: r1605933 [7/11] - in /cordova/site/public/docs/en: 3.5.0/ edge/
Modified: cordova/site/public/docs/en/edge/guide_appdev_security_index.md.html
URL: http://svn.apache.org/viewvc/cordova/site/public/docs/en/edge/guide_appdev_security_index.md.html?rev=1605933&r1=1605932&r2=1605933&view=diff
==============================================================================
--- cordova/site/public/docs/en/edge/guide_appdev_security_index.md.html (original)
+++ cordova/site/public/docs/en/edge/guide_appdev_security_index.md.html Thu Jun 26 23:55:47 2014
@@ -17,16 +17,18 @@
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>
+ <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>
@@ -99,6 +101,7 @@
<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="Russian" value="ru">
<option value="edge">edge</option>
<option value="3.5.0">3.5.0</option>
@@ -115,7 +118,8 @@
<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></small>
+</optgroup></select>
+ </small>
</div>
<div id="subheader">
<h1>Security Guide</h1>
@@ -163,9 +167,7 @@
<p>The following guide includes some security best practices that you should consider when developing a Cordova application. Please be aware that security is a very complicated topic and therefore this guide is not exhaustive. If you believe you can contribute to this guide, please feel free to file an issue in Cordova's bug tracker under <a class="external" href="https://issues.apache.org/jira/browse/CB/component/12316407">"Documentation"</a>. This guide is designed to be applicable to general Cordova development (all platforms) but special platform-specific considerations will be noted. </p>
-<h2>
-<a name="Security%20Guide_this_guide_discusses_the_following_topics">This guide discusses the following topics:</a>
-</h2>
+<h2><a name="Security%20Guide_this_guide_discusses_the_following_topics">This guide discusses the following topics:</a></h2>
<ul>
<li>Whitelist</li>
@@ -176,9 +178,8 @@
<li>General Tips</li>
<li>Recommended Articles and Other Resources</li>
</ul>
-<h2>
-<a name="Security%20Guide_whitelist">Whitelist</a>
-</h2>
+
+<h2><a name="Security%20Guide_whitelist">Whitelist</a></h2>
<ul>
<li><p>Read and understand the <a href="guide_appdev_whitelist_index.md.html#Whitelist%20Guide">Whitelist Guide</a></p></li>
@@ -187,25 +188,20 @@
If you want network requests to be evaluated against the whitelist, then it is important to change this and only allow the domains to which you need access. This can be done by editing the application-level config file located at:
<code>{project}/config.xml</code> (recent projects) or <code>{project}/www/config.xml</code> (older projects)</p></li>
<li><p>Android's Whitelist on Cordova 2.9.x is considered secure, however, it was discovered that if foo.com is included in the whitelist, foo.com.evil.com would be able to pass the whitelist test. This was fixed in Cordova 3.x. </p></li>
-<li><p>Domain whitelisting does not work on Android API 10 and below, and WP7/8 for iframes and XMLHttpRequest. This means an attacker can load any domain in an iframe and any script on that page within the iframe can directly access Cordova JavaScript objects and the corresponding native Java objects. You should take this into consideration when building applications for these platforms. In practice this means making sure you target an Android API higher than 10, and that if possible you do not use an iframe to load external content - use the inAppBrowser plugin or other third-party plugins. </p></li>
+<li><p>Domain whitelisting does not work on Android API 10 and below, and WP8 for iframes and XMLHttpRequest. This means an attacker can load any domain in an iframe and any script on that page within the iframe can directly access Cordova JavaScript objects and the corresponding native Java objects. You should take this into consideration when building applications for these platforms. In practice this means making sure you target an Android API higher than 10, and that if possible you do not use an iframe to load external content - use the inAppBrowser plugin or other third-party plugins. </p></li>
</ul>
-<h2>
-<a name="Security%20Guide_iframes_and_the_callback_id_mechanism">Iframes and the Callback Id Mechanism</a>
-</h2>
+
+<h2><a name="Security%20Guide_iframes_and_the_callback_id_mechanism">Iframes and the Callback Id Mechanism</a></h2>
<p>If content is served in an iframe from a whitelisted domain, that domain will have access to the native Cordova bridge. This means that if you whitelist a third-party advertising network and serve those ads through an iframe, it is possible that a malicious ad will be able to break out of the iframe and perform malicious actions. Because of this, you should generally not use iframes unless you control the server that hosts the iframe content. Also note that there are third party plugins available to support advertising networks. Note that this statement is not true for iOS, which intercepts everything including iframe connections. </p>
-<h2>
-<a name="Security%20Guide_certificate_pinning">Certificate Pinning</a>
-</h2>
+<h2><a name="Security%20Guide_certificate_pinning">Certificate Pinning</a></h2>
<p>Cordova does not support true certificate pinning. The main barrier to this is a lack of native APIs in Android for intercepting SSL connections to perform the check of the server's certificate. (Although it is possible to do certificate pinning on Android in Java using JSSE, the webview on Android is written in C++, and server connections are handled for you by the webview, so it is not possible to use Java and JSSE there.) Since Apache Cordova is meant to offer consistent APIs across multiple platforms, not having a capability in a major platform breaks that consistency.</p>
<p>There are ways to approximate certificate pinning, such as checking the server's public key (fingerprint) is the expected value when your application starts or at other various times during your application's lifetime. There are third-party plugins available for Cordova that can do that. However, this is not the same as true certificate pinning which automatically verifies the expected value on every connection to the server.</p>
-<h2>
-<a name="Security%20Guide_self_signed_certificates">Self-signed Certificates</a>
-</h2>
+<h2><a name="Security%20Guide_self_signed_certificates">Self-signed Certificates</a></h2>
<p>Using self-signed certificates on your server is not recommended. If you desire SSL, then it is highly recommended that your server have a certificate that has been properly signed by a well-known CA (certificate authority). The inability to do true certificate pinning makes this important.</p>
@@ -215,13 +211,11 @@ If you want network requests to be evalu
<p>When running Cordova on Android, using <code>android:debuggable="true"</code> in the application manifest will permit SSL errors such as certificate chain validation errors on self-signed certs. So you can use self-signed certs in this configuration, but this is not a configuration that should be used when your application is in production. It is meant to be used only during application development.</p>
-<h2>
-<a name="Security%20Guide_encrypted_storage">Encrypted storage</a>
-</h2>
-
-<h2>
-<a name="Security%20Guide_general_tips">General Tips</a>
-</h2>
+<h2><a name="Security%20Guide_encrypted_storage">Encrypted storage</a></h2>
+
+<p>(TBD)</p>
+
+<h2><a name="Security%20Guide_general_tips">General Tips</a></h2>
<h3>Do not use Android Gingerbread!</h3>
@@ -230,45 +224,51 @@ If you want network requests to be evalu
<li>Gingerbread has been shown to be insecure and one of the most targeted mobile OSs <a class="external" href="http://bgr.com/2012/11/06/android-security-gingerbread-malware/">http://www.mobilemag.com/2012/11/06/andriod-2-3-gingerbread-security/</a>. </li>
<li>The Whitelist on Android does not work with Gingerbread or lower. This means an attacker can load malicious code in an iframe that would then have access to all of the Cordova APIs and could use that access to steal personal data, send SMS messages to premium-rate numbers, and perform other malicious acts. </li>
</ul>
+
<h3>Use InAppBrowser for outside links</h3>
<ul>
<li>Use the InAppBrowser when opening links to any outside website. This is much safer than whitelisting a domain name and including the content directly in your application because the InAppBrowser will use the native browser's security features and will not give the website access to your Cordova environment. Even if you trust the third party website and include it directly in your application, that third party website could link to malicious web content. </li>
</ul>
+
<h3>Validate all user input</h3>
<ul>
<li>Always validate any and all input that your application accepts. This includes usernames, passwords, dates, uploaded media, etc. Because an attacker could manipulate your HTML and JS assets (either by decompiling your application or using debugging tools like chrome://inspect), this validation should also be performed on your server, especially before handing the data off to any backend service. </li>
<li>Other sources where data should be validated: user documents, contacts, push notifications</li>
</ul>
+
<h3>Do not cache sensitive data</h3>
<ul>
<li>If usernames, password, geolocation information, and other sensitive data is cached, then it could potentially be retrieved later by an unauthorized user or application.</li>
</ul>
+
<h3>Don't use eval() unless you know what you're doing</h3>
<ul>
<li>The JavaScript function eval() has a long history of being abused. Using it incorrectly can open your code up for injection attacks, debugging difficulties, and slower code execution. </li>
</ul>
+
<h3>Do not assume that your source code is secure</h3>
<ul>
<li>Since a Cordova application is built from HTML and JavaScript assets that get packaged in a native container, you should not consider your code to be secure. It is possible to reverse engineer a Cordova application. </li>
</ul>
-<h2>
-<a name="Security%20Guide_recommended_articles_and_other_resources">Recommended Articles and Other Resources</a>
-</h2>
+
+<h2><a name="Security%20Guide_recommended_articles_and_other_resources">Recommended Articles and Other Resources</a></h2>
<ul>
<li><a class="external" href="https://www.owasp.org/index.php/HTML5_Security_Cheat_Sheet">HTML5 Security cheat sheet, detailing how to secure your HTML5 application</a></li>
<li><a class="external" href="https://github.com/phonegap/phonegap/wiki/Platform-Security">Phonegap's article on device security, such as using encrypted data</a></li>
<li><a class="external" href="http://www.cis.syr.edu/~wedu/Research/paper/webview_acsac2011.pdf">Whitepaper about well known security flaws in Webview based hybrid applications</a></li>
</ul>
-</div>
+
+ </div>
</div>
<!-- Functionality and Syntax Highlighting -->
- <script type="text/javascript" src="index.js"></script><script type="text/javascript" src="prettify/prettify.js"></script>
-</body>
+ <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/guide_appdev_whitelist_index.md.html
URL: http://svn.apache.org/viewvc/cordova/site/public/docs/en/edge/guide_appdev_whitelist_index.md.html?rev=1605933&r1=1605932&r2=1605933&view=diff
==============================================================================
--- cordova/site/public/docs/en/edge/guide_appdev_whitelist_index.md.html (original)
+++ cordova/site/public/docs/en/edge/guide_appdev_whitelist_index.md.html Thu Jun 26 23:55:47 2014
@@ -17,16 +17,18 @@
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>
+ <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>
@@ -99,6 +101,7 @@
<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="Russian" value="ru">
<option value="edge">edge</option>
<option value="3.5.0">3.5.0</option>
@@ -115,7 +118,8 @@
<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></small>
+</optgroup></select>
+ </small>
</div>
<div id="subheader">
<h1>Whitelist Guide</h1>
@@ -213,16 +217,13 @@ on each platform.)</p>
<p>This is the default value for newly created CLI projects.</p>
</li>
</ul>
-<h2>
-<a name="Whitelist%20Guide_amazon_fire_os_whitelisting">Amazon Fire OS Whitelisting</a>
-</h2>
+
+<h2><a name="Whitelist%20Guide_amazon_fire_os_whitelisting">Amazon Fire OS Whitelisting</a></h2>
<p>Platform-specific whitelisting rules are found in
<code>res/xml/config.xml</code>.</p>
-<h2>
-<a name="Whitelist%20Guide_android_whitelisting">Android Whitelisting</a>
-</h2>
+<h2><a name="Whitelist%20Guide_android_whitelisting">Android Whitelisting</a></h2>
<p>Platform-specific whitelisting rules are found in
<code>res/xml/config.xml</code>.</p>
@@ -236,9 +237,7 @@ application.</p>
page to open in the default browser rather than within the
application. (Compare this to iOS's behavior noted below.)</p>
-<h2>
-<a name="Whitelist%20Guide_ios_whitelisting">iOS Whitelisting</a>
-</h2>
+<h2><a name="Whitelist%20Guide_ios_whitelisting">iOS Whitelisting</a></h2>
<p>The platform's whitelisting rules are found in the named application
directory's <code>config.xml</code> file.</p>
@@ -258,9 +257,7 @@ all subdomains and top-level domains suc
domains via <code>href</code> hyperlink on iOS prevents the page from opening at
all.</p>
-<h2>
-<a name="Whitelist%20Guide_blackberry_10_whitelisting">BlackBerry 10 Whitelisting</a>
-</h2>
+<h2><a name="Whitelist%20Guide_blackberry_10_whitelisting">BlackBerry 10 Whitelisting</a></h2>
<p>The whitelisting rules are found in <code>www/config.xml</code>.</p>
@@ -297,12 +294,11 @@ protocol:</p>
<p><access origin="*" subdomains="true"></access></p>
</li>
</ul>
+
<p>(For more information on support, see BlackBerry's documentation on the
<a class="external" href="https://developer.blackberry.com/html5/documentation/ww_developing/Access_element_834677_11.html">access element</a>.)</p>
-<h2>
-<a name="Whitelist%20Guide_ios_changes_in_3_1_0">iOS Changes in 3.1.0</a>
-</h2>
+<h2><a name="Whitelist%20Guide_ios_changes_in_3_1_0">iOS Changes in 3.1.0</a></h2>
<p>Prior to version 3.1.0, Cordova-iOS included some non-standard
extensions to the domain whilelisting scheme supported by other
@@ -327,16 +323,13 @@ for each TLD which you actually control,
are no longer supported; change to include a line for each domain
and protocol that you actually need to whitelist.</p></li>
</ul>
-<h2>
-<a name="Whitelist%20Guide_windows_phone_whitelisting">Windows Phone Whitelisting</a>
-</h2>
-<p>The whitelisting rules for Windows Phone 7 and 8 are found in the
+<h2><a name="Whitelist%20Guide_windows_phone_whitelisting">Windows Phone Whitelisting</a></h2>
+
+<p>The whitelisting rules for Windows Phone 8 are found in the
app's <code>config.xml</code> file.</p>
-<h2>
-<a name="Whitelist%20Guide_tizen_whitelisting">Tizen Whitelisting</a>
-</h2>
+<h2><a name="Whitelist%20Guide_tizen_whitelisting">Tizen Whitelisting</a></h2>
<p>Whitelisting rules are found in the app's <code>config.xml</code> file. The
platform relies on the same <code>subdomains</code> attribute as the BlackBerry
@@ -348,6 +341,7 @@ platform.
</div>
<!-- Functionality and Syntax Highlighting -->
- <script type="text/javascript" src="index.js"></script><script type="text/javascript" src="prettify/prettify.js"></script>
-</body>
+ <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/guide_cli_index.md.html
URL: http://svn.apache.org/viewvc/cordova/site/public/docs/en/edge/guide_cli_index.md.html?rev=1605933&r1=1605932&r2=1605933&view=diff
==============================================================================
--- cordova/site/public/docs/en/edge/guide_cli_index.md.html (original)
+++ cordova/site/public/docs/en/edge/guide_cli_index.md.html Thu Jun 26 23:55:47 2014
@@ -17,16 +17,18 @@
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>
+ <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>
@@ -99,6 +101,7 @@
<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="Russian" value="ru">
<option value="edge">edge</option>
<option value="3.5.0">3.5.0</option>
@@ -115,7 +118,8 @@
<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></small>
+</optgroup></select>
+ </small>
</div>
<div id="subheader">
<h1>The Command-Line Interface</h1>
@@ -173,9 +177,7 @@ workflow described in the <a href="guide
CLI to initialize project code, then switch to various platforms' SDKs
and shell tools for continued development.</p>
-<h2>
-<a name="The%20Command-Line%20Interface_prerequisites">Prerequisites</a>
-</h2>
+<h2><a name="The%20Command-Line%20Interface_prerequisites">Prerequisites</a></h2>
<p>Before running any command-line tools, you need to install SDKs for
each platform you wish to target.
@@ -190,11 +192,11 @@ platform's SDK. The CLI supports the fol
<li>Amazon Fire OS (Mac, Linux, Windows)</li>
<li>Android (Mac, Linux, Windows)</li>
<li>BlackBerry 10 (Mac, Linux, Windows)</li>
-<li>Windows Phone 7 (Windows)</li>
<li>Windows Phone 8 (Windows)</li>
<li>Windows 8 (Windows)</li>
<li>Firefox OS (Mac, Linux, Windows)</li>
</ul>
+
<p>On the Mac, the command-line is available via the <em>Terminal</em>
application. On the PC, it's available as <em>Command Prompt</em> under
<em>Accessories</em>.</p>
@@ -208,9 +210,7 @@ environment or in dual-boot mode. For av
the more it makes sense to maintain a remote source code repository,
whose assets you pull down to local working directories.</p>
-<h2>
-<a name="The%20Command-Line%20Interface_installing_the_cordova_cli">Installing the Cordova CLI</a>
-</h2>
+<h2><a name="The%20Command-Line%20Interface_installing_the_cordova_cli">Installing the Cordova CLI</a></h2>
<p>The Cordova command-line tool is distributed as an npm package in a
ready-to-use format. It is not necessary to compile it from source.</p>
@@ -254,6 +254,7 @@ available on using <code>npm</code> with
</code></pre>
</li>
</ul>
+
<p>The <code>-g</code> flag above tells <code>npm</code> to install <code>cordova</code> globally. Otherwise
it will be installed in the <code>node_modules</code> subdirectory of the current
working directory.</p>
@@ -271,9 +272,8 @@ platform SDKs.</p>
print help text.</p>
</li>
</ol>
-<h2>
-<a name="The%20Command-Line%20Interface_create_the_app">Create the App</a>
-</h2>
+
+<h2><a name="The%20Command-Line%20Interface_create_the_app">Create the App</a></h2>
<p>Go to the directory where you maintain your source code, and run a
command such as the following:</p>
@@ -288,7 +288,8 @@ the command with the <code>-d</code> opt
for your project. This directory should not already exist, Cordova will
create it for you. Its <code>www</code> subdirectory houses your application's
home page, along with various resources under <code>css</code>, <code>js</code>, and <code>img</code>,
-which follow common web development file-naming conventions. The
+which follow common web development file-naming conventions. These assets
+will be stored on the device's local filesystem, not served remotely. The
<code>config.xml</code> file contains important metadata needed to generate and
distribute the application.</p>
@@ -307,9 +308,7 @@ file, but do be aware that there may be
using this value, such as Java class names. The default value is <code>HelloCordova</code>,
but it is recommended that you select an appropriate value.</p>
-<h2>
-<a name="The%20Command-Line%20Interface_add_platforms">Add Platforms</a>
-</h2>
+<h2><a name="The%20Command-Line%20Interface_add_platforms">Add Platforms</a></h2>
<p>All subsequent commands need to be run within the project's directory,
or any subdirectories within its scope:</p>
@@ -332,8 +331,7 @@ SDK. Run any of these from a Mac:</p>
<p>Run any of these from a Windows machine, where <em>wp</em> refers to
different versions of the Windows Phone operating system:</p>
-<pre class="prettyprint"><code> $ cordova platform add wp7
- $ cordova platform add wp8
+<pre class="prettyprint"><code> $ cordova platform add wp8
$ cordova platform add windows8
$ cordova platform add amazon-fireos
$ cordova platform add android
@@ -383,9 +381,7 @@ then switch to an SDK for native work.</
<p>Read on if you wish to use the cross-platform workflow approach (the CLI) for the entire
development cycle.</p>
-<h2>
-<a name="The%20Command-Line%20Interface_build_the_app">Build the App</a>
-</h2>
+<h2><a name="The%20Command-Line%20Interface_build_the_app">Build the App</a></h2>
<p>By default, the <code>cordova create</code> script generates a skeletal web-based
application whose home page is the project's <code>www/index.html</code> file.
@@ -417,9 +413,7 @@ an alternative to modify and compile the
Cordova generates within <code>platforms/ios</code>. You can use the same
approach with other platforms' SDKs.</p>
-<h2>
-<a name="The%20Command-Line%20Interface_test_the_app_on_an_emulator_or_device">Test the App on an Emulator or Device</a>
-</h2>
+<h2><a name="The%20Command-Line%20Interface_test_the_app_on_an_emulator_or_device">Test the App on an Emulator or Device</a></h2>
<p>SDKs for mobile platforms often come bundled with emulators that
execute a device image, so that you can launch the app from the home
@@ -462,9 +456,7 @@ the device, and perhaps add a USB driver
environmnent.
See <a href="guide_platforms_index.md.html#Platform%20Guides">Platform Guides</a> for details on each platform's requirements.</p>
-<h2>
-<a name="The%20Command-Line%20Interface_add_plugin_features">Add Plugin Features</a>
-</h2>
+<h2><a name="The%20Command-Line%20Interface_add_plugin_features">Add Plugin Features</a></h2>
<p>When you build and view a new project, the default application that
appears doesn't do very much. You can modify the app in many ways to
@@ -478,7 +470,13 @@ example when designing a hybrid app that
native components. (See <a href="guide_hybrid_webviews_index.md.html#Embedding%20WebViews">Embedding WebViews</a> and <a href="guide_hybrid_plugins_index.md.html#Plugin%20Development%20Guide">Plugin Development
Guide</a> for details.) More commonly, you would add a plugin to enable
one of Cordova's basic device-level features
-detailed in the <a href="index.md.html#API%20Reference">API Reference</a>. A list of these plugins, including
+detailed in the <a href="index.md.html#API%20Reference">API Reference</a>. </p>
+
+<p>As of version 3.0, when you create a Cordova project it does not have any
+plugins present. This is the new default behavior. Any plugins you desire,
+even the core plugins, must be explicitly added.</p>
+
+<p>A list of these plugins, including
additional third-party plugins provided by the community, can be found
in the registry at
<a class="external" href="http://plugins.cordova.io/">plugins.cordova.io</a>. You can use
@@ -575,6 +573,7 @@ $ cordova plugin add org.apache.cordova.
</code></pre>
</li>
</ul>
+
<p><strong>NOTE</strong>: The CLI adds plugin code as appropriate for each platform.
If you want to develop with lower-level shell tools or platform SDKs
as discussed in the <a href="guide_overview_index.md.html#Overview">Overview</a>, you need to run the Plugman utility to
@@ -602,9 +601,7 @@ argument for each command:</p>
<pre class="prettyprint"><code> $ cordova plugin add org.apache.cordova.console org.apache.cordova.device
</code></pre>
-<h2>
-<a name="The%20Command-Line%20Interface_advanced_plugin_options">Advanced Plugin Options</a>
-</h2>
+<h2><a name="The%20Command-Line%20Interface_advanced_plugin_options">Advanced Plugin Options</a></h2>
<p>When adding a plugin, several options allow you to specify from where
to fetch the plugin. The examples above use a well-known
@@ -653,9 +650,7 @@ contains the <code>plugin.xml</code> fil
<pre class="prettyprint"><code> $ cordova plugin add ../my_plugin_dir
</code></pre>
-<h2>
-<a name="The%20Command-Line%20Interface_using_merges_to_customize_each_platform">Using merges to Customize Each Platform</a>
-</h2>
+<h2><a name="The%20Command-Line%20Interface_using_merges_to_customize_each_platform">Using merges to Customize Each Platform</a></h2>
<p>While Cordova allows you to easily deploy an app for many different
platforms, sometimes you need to add customizations. In that case,
@@ -690,6 +685,7 @@ example:</p>
</code></pre>
</li>
</ul>
+
<p>When you rebuild the project, the Android version features the custom
font size, while others remain unchanged.</p>
@@ -700,9 +696,7 @@ graphic into the iOS interface, stored i
instead capture <code><a href="cordova_events_events.md.html#backbutton">backbutton</a></code> events from the corresponding hardware
button.</p>
-<h2>
-<a name="The%20Command-Line%20Interface_help_commands">Help Commands</a>
-</h2>
+<h2><a name="The%20Command-Line%20Interface_help_commands">Help Commands</a></h2>
<p>Cordova features a couple of global commands, which may help you if
you get stuck or experience a problem. The <code>help</code> command displays
@@ -725,9 +719,7 @@ a local <code>info.txt</code> file.</p>
<p><strong>NOTE</strong>: Currently, only details on iOS and Android platforms are
available.</p>
-<h2>
-<a name="The%20Command-Line%20Interface_updating_cordova_and_your_project">Updating Cordova and Your Project</a>
-</h2>
+<h2><a name="The%20Command-Line%20Interface_updating_cordova_and_your_project">Updating Cordova and Your Project</a></h2>
<p>After installing the <code>cordova</code> utility, you can always update it to
the latest version by running the following command:</p>
@@ -772,6 +764,7 @@ you're building:</p>
</div>
<!-- Functionality and Syntax Highlighting -->
- <script type="text/javascript" src="index.js"></script><script type="text/javascript" src="prettify/prettify.js"></script>
-</body>
+ <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/guide_hybrid_plugins_index.md.html
URL: http://svn.apache.org/viewvc/cordova/site/public/docs/en/edge/guide_hybrid_plugins_index.md.html?rev=1605933&r1=1605932&r2=1605933&view=diff
==============================================================================
--- cordova/site/public/docs/en/edge/guide_hybrid_plugins_index.md.html (original)
+++ cordova/site/public/docs/en/edge/guide_hybrid_plugins_index.md.html Thu Jun 26 23:55:47 2014
@@ -17,16 +17,18 @@
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>
+ <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>
@@ -99,6 +101,7 @@
<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="Russian" value="ru">
<option value="edge">edge</option>
<option value="3.5.0">3.5.0</option>
@@ -115,7 +118,8 @@
<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></small>
+</optgroup></select>
+ </small>
</div>
<div id="subheader">
<h1>Plugin Development Guide</h1>
@@ -169,8 +173,11 @@ NFC communication, or to tailor calendar
<a class="external" href="http://plugins.cordova.io">registry</a> of available plugins.</p>
<p>Plugins comprise a single JavaScript interface along with
-corresponding native code libraries for each supported platform. This
-section steps through a simple <em>echo</em> plugin that passes a string from
+corresponding native code libraries for each supported platform. In essence
+this hides the various native code implementations behind a common
+JavaScript interface.</p>
+
+<p>This section steps through a simple <em>echo</em> plugin that passes a string from
JavaScript to the native platform and back, one that you can use as a
model to build far more complex features. This section discusses the
basic plugin structure and the outward-facing JavaScript interface.
@@ -182,9 +189,7 @@ is best to look over
<a class="external" href="http://cordova.apache.org/#contribute">existing plugins</a>
for guidance.</p>
-<h2>
-<a name="Plugin%20Development%20Guide_building_a_plugin">Building a Plugin</a>
-</h2>
+<h2><a name="Plugin%20Development%20Guide_building_a_plugin">Building a Plugin</a></h2>
<p>Application developers use the CLI's <code>plugin add</code> command (discussed
in <a href="guide_cli_index.md.html#The%20Command-Line%20Interface">The Command-Line Interface</a>) to apply a plugin to a project. The
@@ -231,9 +236,7 @@ the platform-specific <code>config.xml</
the additional code library. The <code>header-file</code> and <code>source-file</code> tags
specify the path to the library's component files.</p>
-<h2>
-<a name="Plugin%20Development%20Guide_validating_a_plugin">Validating a Plugin</a>
-</h2>
+<h2><a name="Plugin%20Development%20Guide_validating_a_plugin">Validating a Plugin</a></h2>
<p>You can use the <code>plugman</code> utility to check whether the plugin installs
correctly for each platform. Install <code>plugman</code> with the following
@@ -261,9 +264,7 @@ dependencies load properly:</p>
For information on how to actually <em>debug</em> plugins, see each
platform's native interface listed at the bottom of this page.</p>
-<h2>
-<a name="Plugin%20Development%20Guide_the_javascript_interface">The JavaScript Interface</a>
-</h2>
+<h2><a name="Plugin%20Development%20Guide_the_javascript_interface">The JavaScript Interface</a></h2>
<p>The JavaScript provides the front-facing interface, making it perhaps
the most important part of the plugin. You can structure your
@@ -296,9 +297,8 @@ guides listed below.</p></li>
<li><p><code>[/* arguments */]</code>: An array of arguments to pass into the native
environment.</p></li>
</ul>
-<h2>
-<a name="Plugin%20Development%20Guide_sample_javascript">Sample JavaScript</a>
-</h2>
+
+<h2><a name="Plugin%20Development%20Guide_sample_javascript">Sample JavaScript</a></h2>
<p>This example shows one way to implement the plugin's JavaScript
interface:</p>
@@ -329,9 +329,7 @@ callback function <code>window.echo</cod
the error callback, it simply calls the success callback and passes it
a default string.</p>
-<h2>
-<a name="Plugin%20Development%20Guide_native_interfaces">Native Interfaces</a>
-</h2>
+<h2><a name="Plugin%20Development%20Guide_native_interfaces">Native Interfaces</a></h2>
<p>Once you define JavaScript for your plugin, you need to complement it
with at least one native implementation. Details for each platform are
@@ -343,12 +341,12 @@ listed below, and each builds on the sim
<li><a href="guide_platforms_ios_plugin.md.html#iOS%20Plugins">iOS Plugins</a></li>
<li><a href="guide_platforms_blackberry10_plugin.md.html#BlackBerry%2010%20Plugins">BlackBerry 10 Plugins</a></li>
<li><a href="guide_platforms_wp8_plugin.md.html#Windows%20Phone%20Plugins">Windows Phone Plugins</a></li>
+<li><a href="guide_platforms_win8_plugin.md.html#Windows%208%20Plugins">Windows 8 Plugins</a></li>
</ul>
+
<p>The Tizen platform does not support plugins.</p>
-<h2>
-<a name="Plugin%20Development%20Guide_publishing_plugins">Publishing Plugins</a>
-</h2>
+<h2><a name="Plugin%20Development%20Guide_publishing_plugins">Publishing Plugins</a></h2>
<p>Once you develop your plugin, you may want to publish and share it
with the community. You can publish your plugin to the Cordova
@@ -374,6 +372,7 @@ commands.</p>
</div>
<!-- Functionality and Syntax Highlighting -->
- <script type="text/javascript" src="index.js"></script><script type="text/javascript" src="prettify/prettify.js"></script>
-</body>
+ <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/guide_hybrid_webviews_index.md.html
URL: http://svn.apache.org/viewvc/cordova/site/public/docs/en/edge/guide_hybrid_webviews_index.md.html?rev=1605933&r1=1605932&r2=1605933&view=diff
==============================================================================
--- cordova/site/public/docs/en/edge/guide_hybrid_webviews_index.md.html (original)
+++ cordova/site/public/docs/en/edge/guide_hybrid_webviews_index.md.html Thu Jun 26 23:55:47 2014
@@ -17,16 +17,18 @@
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>
+ <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>
@@ -99,6 +101,7 @@
<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="Russian" value="ru">
<option value="edge">edge</option>
<option value="3.5.0">3.5.0</option>
@@ -115,7 +118,8 @@
<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></small>
+</optgroup></select>
+ </small>
</div>
<div id="subheader">
<h1>Embedding WebViews</h1>
@@ -169,10 +173,12 @@ supported platforms:</p>
<li><a href="guide_platforms_android_webview.md.html#Android%20WebViews">Android WebViews</a></li>
<li><a href="guide_platforms_ios_webview.md.html#iOS%20WebViews">iOS WebViews</a></li>
</ul>
-</div>
+
+ </div>
</div>
<!-- Functionality and Syntax Highlighting -->
- <script type="text/javascript" src="index.js"></script><script type="text/javascript" src="prettify/prettify.js"></script>
-</body>
+ <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/guide_next_index.md.html
URL: http://svn.apache.org/viewvc/cordova/site/public/docs/en/edge/guide_next_index.md.html?rev=1605933&r1=1605932&r2=1605933&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 Thu Jun 26 23:55:47 2014
@@ -17,16 +17,18 @@
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>
+ <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>
@@ -99,6 +101,7 @@
<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="Russian" value="ru">
<option value="edge">edge</option>
<option value="3.5.0">3.5.0</option>
@@ -115,7 +118,8 @@
<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></small>
+</optgroup></select>
+ </small>
</div>
<div id="subheader">
<h1>Next Steps</h1>
@@ -189,11 +193,10 @@ Testing on a simulator vs. on a real dev
<li>
<a href="guide_next_index.md.html#Getting%20Help">Getting Help</a> </li>
</ul>
+
<h1><a name="Best%20Practices">Best Practices</a></h1>
-<h2>
-<a name="Best%20Practices_1_spa_is_your_friend">1) SPA Is Your Friend</a>
-</h2>
+<h2><a name="Best%20Practices_1_spa_is_your_friend">1) SPA Is Your Friend</a></h2>
<p>First and foremost - your Cordova applications should adopt the SPA (Single Page Application) design. Loosely defined, a SPA is a client-side application that is run from one request of a web page. The user loads an initial set of resources (HTML, CSS, and JavaScript) and further updates (showing a new view, loading data) is done via AJAX. SPAs are commonly used for more complex client-side applications. GMail is a great example of this. After you load GMail, mail views, editing, and organization are all done by updating the DOM instead of actually leaving the current page to load a completely new one. </p>
@@ -212,11 +215,10 @@ Testing on a simulator vs. on a real dev
<li><a class="external" href="http://www.sencha.com/products/touch/">Sencha Touch</a></li>
<li><a href="jquerymobile.com">jQuery Mobile</a></li>
</ul>
+
<p>And many, many, more.</p>
-<h2>
-<a name="Best%20Practices_2_performance_considerations">2) Performance Considerations</a>
-</h2>
+<h2><a name="Best%20Practices_2_performance_considerations">2) Performance Considerations</a></h2>
<p>One of the biggest mistakes a new Cordova developer can make is to assume that the performance they get on a desktop machine is the same they will get on a mobile device. While our mobile devices have gotten more powerful every year, they still lack the power and performance of a desktop. Mobile devices typically have much less RAM and a GPU that is a far cry from their desktop (or even laptop) brethren. A full list of tips here would be too much, but here are a few things to keep in mind (with a list of longer resources at the end for further research).</p>
@@ -233,9 +235,8 @@ Testing on a simulator vs. on a real dev
<li><a class="external" href="http://coenraets.org/blog/2013/10/top-10-performance-techniques-for-phonegap-and-hybrid-apps-slides-available/">"Top Ten Performance Tips for PhoneGap and Hybrid Apps"</a></li>
<li>"Fast Apps and Sites with JavaScript": http://channel9.msdn.com/<a href="cordova_events_events.md.html#Events">Events</a>/Build/2013/4-313</li>
</ul>
-<h2>
-<a name="Best%20Practices_3_recognize_and_handle_offline_status">3) Recognize and Handle Offline Status</a>
-</h2>
+
+<h2><a name="Best%20Practices_3_recognize_and_handle_offline_status">3) Recognize and Handle Offline Status</a></h2>
<p>See the previous tip about networks. Not only can you be on a slow network, it is entirely possible for your application to be completely offline. Your application should handle this in an intelligent manner. If your application does not, people will think your application is broken. Given how easy it is to handle (Cordova supports listening for both an offline and online event), there is absolutely no reason for your application to not respond well when run offline. Be sure to test (see the <a href="guide_next_index.md.html#Testing">Testing</a> section below) your application and be sure to test how your application handles when you start in one state and then switch to another.</p>
@@ -244,9 +245,7 @@ Testing on a simulator vs. on a real dev
<h1><a name="Handling%20Upgrades">Handling Upgrades</a></h1>
-<h2>
-<a name="Handling%20Upgrades_upgrading_cordova_projects">Upgrading Cordova Projects</a>
-</h2>
+<h2><a name="Handling%20Upgrades_upgrading_cordova_projects">Upgrading Cordova Projects</a></h2>
<p>If your existing project was created using Cordova 3.x, you can upgrade the project by issuing the following:</p>
@@ -263,13 +262,12 @@ Testing on a simulator vs. on a real dev
<li>Build your project</li>
<li>Test, test, test!</li>
</ul>
+
<p>Regardless of the project's prior version, it is absolutely critical that you read up on what was changed in the updated version, as the update may break your code. The best place to find this information will be in the release notes published both in the repositories and on the Cordova blog. You will want to test your app thoroughly in order to verify that it is working correctly after you perform the update.</p>
<p>Note: some plugins may not be compatible with the new version of Cordova. If a plugin is not compatible, you may be able to find a replacement plugin that does what you need, or you may need to delay upgrading your project. Alternatively, alter the plugin so that it does work under the new version and contribute back to the community.</p>
-<h2>
-<a name="Handling%20Upgrades_plugin_upgrades">Plugin Upgrades</a>
-</h2>
+<h2><a name="Handling%20Upgrades_plugin_upgrades">Plugin Upgrades</a></h2>
<p>As of Cordova 3.4, there is no mechanism for upgrading changed plugins using a single command. Instead, remove the plugin and add it back to your project, and the new version will be installed:</p>
@@ -287,10 +285,8 @@ cordova plugin add com.some.plugin
<p><a href="guide_next_index.md.html#Testing">Testing</a> your applications is super important. The Cordova team uses Jasmine but any web friendly unit testing solution will do. </p>
-<h2>
-<a name="Testing_testing_on_a_simulator_vs_on_a_real_device">
-Testing on a simulator vs. on a real device</a>
-</h2>
+<h2><a name="Testing_testing_on_a_simulator_vs_on_a_real_device">
+Testing on a simulator vs. on a real device</a></h2>
<p>Itâs not uncommon to use desktop browsers and device simulators/emulators when developing a Cordova application. However, it is incredibly important that you test your app on as many physical devices as you possibly can:</p>
@@ -301,6 +297,7 @@ Testing on a simulator vs. on a real dev
<li>It's impossible to get a good feel for how your app responds to your touch by using a simulator or an emulator. Instead, running the app on a real device can point out problems with the sizes of user interface elements, responsiveness, etc.</li>
<li>Although it would be nice to be able to test only on one device per platform, it is best to test on many devices sporting many different OS versions. For example, what works on your particular Android smartphone may fail on another Android device. What works on an iOS 7 device may fail on an iOS 6 device.</li>
</ul>
+
<p>It is, of course, impossible to test on every possible device on the market. For this reason, itâs wise to recruit many testers who have different devices. Although they wonât catch every problem, chances are good that they will discover quirks and issues that you would never find alone.</p>
<p>Tip: It is possible on Android Nexus devices to easily flash different versions of Android onto the device. This simple process will allow you to easily test your application on different levels of Android with a single device, without voiding your warranty or requiring you to âjailbreakâ or ârootâ your device. The Google Android factory images and instructions are located at: https://developers.google.com/android/nexus/images#instructions</p>
@@ -309,37 +306,27 @@ Testing on a simulator vs. on a real dev
<p><a href="guide_next_index.md.html#Debugging">Debugging</a> Cordova requires some setup. Unlike a desktop application, you can't simply open dev tools on your mobile device and start debugging, luckily there are some great alternatives.</p>
-<h2>
-<a name="Debugging_safari_remote_debugging">Safari Remote Debugging
-</a>
-</h2>
+<h2><a name="Debugging_safari_remote_debugging">Safari Remote Debugging
+</a></h2>
<p>The first option is Safari Remote <a href="guide_next_index.md.html#Debugging">Debugging</a>. This works only on OSX and only with iOS 6 (and higher). It uses Safari to connect to your device (or the simulator) and will connect the browser's dev tools to the Cordova application. You get what you expect from dev tools - DOM inspection/manipulation, a JavaScript debugger, network inspection, the console, and more. For more details, see this excellent blog post: <a class="external" href="http://moduscreate.com/enable-remote-web-inspector-in-ios-6/%5D">http://moduscreate.com/enable-remote-web-inspector-in-ios-6/</a></p>
-<h2>
-<a name="Debugging_chrome_remote_debugging">Chrome Remote Debugging
-</a>
-</h2>
+<h2><a name="Debugging_chrome_remote_debugging">Chrome Remote Debugging
+</a></h2>
<p>Virtually the same as the Safari version, this works with Android only but can be used from any desktop operating system. It requires a minimum of Android 4.4 (KitKat), minimum API level of 19, and Chrome 30+ (on the desktop). Once connected, you get the same Chrome Dev Tools experience for your mobile applications as you do with your desktop applications. Even better, the Chrome Dev Tools have a mirror option that shows your app running on the mobile device. This is more than just a view - you can scroll and click from dev tools and it updates on the mobile device. More details on Chrome Remote <a href="guide_next_index.md.html#Debugging">Debugging</a> may be found here: <a class="external" href="https://developers.google.com/chrome/mobile/docs/debugging">https://developers.google.com/chrome/mobile/docs/debugging</a></p>
<p>It is possible to use Chrome Dev Tools to inspect iOS apps, through a WebKit proxy: <a class="external" href="https://github.com/google/ios-webkit-debug-proxy/">https://github.com/google/ios-webkit-debug-proxy/</a></p>
-<h2>
-<a name="Debugging_ripple">Ripple</a>
-</h2>
+<h2><a name="Debugging_ripple">Ripple</a></h2>
<p>Ripple is a desktop based emulator for Cordova projects. Essentially it lets you run a Cordova application in your desktop application and fake various Cordova features. For example, it lets you simulate the accelerometer to test shake events. It fakes the camera API by letting you select a picture from your hard drive. Ripple lets you focus more on your custom code rather than worrying about Cordova plugins. You can find out more about Ripple here: <a class="external" href="http://ripple.incubator.apache.org/">http://ripple.incubator.apache.org/</a></p>
-<h2>
-<a name="Debugging_weinre">Weinre</a>
-</h2>
+<h2><a name="Debugging_weinre">Weinre</a></h2>
<p>Weinre creates a local server that can host a remote debug client for your Cordova applications. After you've installed and started it up, you copy a line of code into your Cordova application and then restart it. You can then open a dev tool panel on your desktop to work with the application. Weinre is not quite as fancy as Chrome and Safari Remote debugging but has the benefit of working with a much greater range of operating systems and platforms. More information may be found here: <a class="external" href="http://people.apache.org/~pmuellr/weinre/docs/latest/">http://people.apache.org/~pmuellr/weinre/docs/latest/</a></p>
-<h2>
-<a name="Debugging_other_options">Other Options</a>
-</h2>
+<h2><a name="Debugging_other_options">Other Options</a></h2>
<ul>
<li>BlackBerry 10 supports debugging as well: <a class="external" href="https://developer.blackberry.com/html5/documentation/v2_0/debugging_using_web_inspector.html">Documentation</a>
@@ -349,6 +336,7 @@ Testing on a simulator vs. on a real dev
<li>For more examples and explanation of the above debugging tips, see: <a class="external" href="http://developer.telerik.com/featured/a-concise-guide-to-remote-debugging-on-ios-android-and-windows-phone/">http://developer.telerik.com/featured/a-concise-guide-to-remote-debugging-on-ios-android-and-windows-phone/</a>
</li>
</ul>
+
<h1><a name="User%20Interface">User Interface</a></h1>
<p>Building a Cordova application that looks nice on mobile can be a challenge, especially for developers. Many people chose to use a UI framework to make this easier. Here is a short list of options you may want to consider.</p>
@@ -365,14 +353,13 @@ Testing on a simulator vs. on a real dev
<li><a class="external" href="http://topcoat.io">Topcoat</a></li>
<li><a class="external" href="http://facebook.github.io/react/">ReactJS</a></li>
</ul>
+
<p>When building your user interface, it is important to think about all platforms that you are targeting and the differences between the userâs expectations. For example, an Android application that has an iOS-style UI will probably not go over well with users. This sometimes is even enforced by the various application stores. Because of this, it is important that you respect the conventions of each platform and therefore are familiar with the various Human Interface Guidelines:
* <a class="external" href="https://developer.apple.com/library/ios/documentation/userexperience/conceptual/MobileHIG/index.html">iOS</a>
* <a class="external" href="https://developer.android.com/designWP8">Android</a>
* <a class="external" href="http://dev.windowsphone.com/en-us/design/library">Windows Phone</a></p>
-<h2>
-<a name="User%20Interface_additional_ui_articles_and_resources">Additional UI Articles and Resources</a>
-</h2>
+<h2><a name="User%20Interface_additional_ui_articles_and_resources">Additional UI Articles and Resources</a></h2>
<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>
@@ -384,6 +371,7 @@ Testing on a simulator vs. on a real dev
<li>Subscribe to the <a class="external" href="http://cordova.apache.org/#news">Cordova blog</a>.</li>
<li>Subscribe to the <a class="external" href="http://cordova.apache.org/#mailing-list">developer list</a>. Note - this is not a support group! Rather this is a place where development of Cordova is discussed.</li>
</ul>
+
<h1><a name="Getting%20Help">Getting Help</a></h1>
<p>The following links are the best places to get help for Cordova:</p>
@@ -396,10 +384,12 @@ This Google Group was the old support fo
<li>Meetup: <a class="external" href="http://phonegap.meetup.com">http://phonegap.meetup.com</a> -
Consider finding a local Cordova/PhoneGap meetup group</li>
</ul>
-</div>
+
+ </div>
</div>
<!-- Functionality and Syntax Highlighting -->
- <script type="text/javascript" src="index.js"></script><script type="text/javascript" src="prettify/prettify.js"></script>
-</body>
+ <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/guide_overview_index.md.html
URL: http://svn.apache.org/viewvc/cordova/site/public/docs/en/edge/guide_overview_index.md.html?rev=1605933&r1=1605932&r2=1605933&view=diff
==============================================================================
--- cordova/site/public/docs/en/edge/guide_overview_index.md.html (original)
+++ cordova/site/public/docs/en/edge/guide_overview_index.md.html Thu Jun 26 23:55:47 2014
@@ -17,16 +17,18 @@
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>
+ <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>
@@ -99,6 +101,7 @@
<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="Russian" value="ru">
<option value="edge">edge</option>
<option value="3.5.0">3.5.0</option>
@@ -115,7 +118,8 @@
<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></small>
+</optgroup></select>
+ </small>
</div>
<div id="subheader">
<h1>Overview</h1>
@@ -174,13 +178,12 @@ platform's language and tool set.</p></l
<li><p>a web developer and want to deploy a web app that's packaged for
distribution in various app store portals.</p></li>
<li><p>a mobile developer interested in mixing native application
-components with a <em>WebView</em> (browser window) that can access
+components with a <em>WebView</em> (special browser window) that can access
device-level APIs, or if you want to develop a plugin interface
between native and WebView components.</p></li>
</ul>
-<h2>
-<a name="Overview_basic_components">Basic Components</a>
-</h2>
+
+<h2><a name="Overview_basic_components">Basic Components</a></h2>
<p>Apache Cordova applications rely on a common <code>config.xml</code> file that provides
information about the app and specifies parameters affecting how it
@@ -189,8 +192,8 @@ adheres to the W3C's
<a class="external" href="http://www.w3.org/TR/widgets/">Packaged Web App</a>,
or <em>widget</em>, specification.</p>
-<p>The application itself is implemented as a web page, named
-<em>index.html</em> by default, that references whatever CSS, JavaScript,
+<p>The application itself is implemented as a web page, by default a local
+file named <em>index.html</em>, that references whatever CSS, JavaScript,
images, media files, or other resources are necessary for it to run.
The app executes as a <em>WebView</em> within the native application wrapper,
which you distribute to app stores.</p>
@@ -202,7 +205,8 @@ application components. (See <a href="gu
<p>A <em>plugin</em> interface is available for Cordova and native components to
communicate with each other. This enables you to invoke native code
-from JavaScript. As of version 3.0, plugins provide
+from JavaScript. Ideally, the JavaScript APIs to that native code are
+consistent across multiple device platforms. As of version 3.0, plugins provide
bindings to standard device APIs. Third-party plugins provide
additional bindings to features not necessarily available on all
platforms. You can find these third-party plugins in the
@@ -211,16 +215,23 @@ application. You can also develop your o
<a href="guide_hybrid_plugins_index.md.html#Plugin%20Development%20Guide">Plugin Development Guide</a>. Plugins may be necessary, for example, to
communicate between Cordova and custom native components.</p>
-<h2>
-<a name="Overview_development_paths">Development Paths</a>
-</h2>
+<p><strong>NOTE</strong>: As of version 3.0, when you create a Cordova project it does not have
+any plugins present. This is the new default behavior. Any plugins you
+desire, even the core plugins, must be explicitly added.</p>
+
+<p>Cordova does not provide any UI widgets or MV* frameworks. Cordova provides
+only the runtime in which those can execute. If you wish to use UI widgets
+and/or an MV* framework, you will need to select those and include them in
+your application yourself as third-party material.</p>
+
+<h2><a name="Overview_development_paths">Development Paths</a></h2>
<p>As of version 3.0, you can use two basic workflows to create a mobile
app. While you can often use either workflow to accomplish the same
task, they each offer advantages:</p>
<ul>
-<li><p><strong>Cross-platform workflow</strong>: Use this workflow if you want your app
+<li><p><strong>Cross-platform (CLI) workflow</strong>: Use this workflow if you want your app
to run on as many different mobile operating systems as possible,
with little need for platform-specific development. This workflow
centers around the <code>cordova</code> utility, otherwise known as the Cordova
@@ -251,6 +262,7 @@ greater access to development options pr
essential for complex hybrid apps. See the various <a href="guide_platforms_index.md.html#Platform%20Guides">Platform Guides</a>
for details on each platform's available shell utilities.</p></li>
</ul>
+
<p>When first starting out, it may be easiest to use the cross-platform
workflow to create an app, as described in The Command-line Interface.
You then have the option to switch to a platform-centered workflow if
@@ -270,9 +282,7 @@ you need to switch to the platform-cente
the cross-platform source code, and instead relies on the
platform-specific source code.</p>
-<h2>
-<a name="Overview_installing_cordova">Installing Cordova</a>
-</h2>
+<h2><a name="Overview_installing_cordova">Installing Cordova</a></h2>
<p>The installation of Cordova will differ depending on the workflow above
you choose:</p>
@@ -281,6 +291,7 @@ you choose:</p>
<li><p>Cross-platform workflow: see <a href="guide_cli_index.md.html#The%20Command-Line%20Interface">The Command-Line Interface</a>.</p></li>
<li><p>Platform-centered workflow: see the <a href="guide_platforms_index.md.html#Platform%20Guides">Platform Guides</a>.</p></li>
</ul>
+
<p>After installing Cordova, it is recommended that you review the <a href="guide_platforms_index.md.html#Platform%20Guides">Platform Guides</a>
for the mobile platforms that you will be developing for. It is also
recommended that you also review the <a href="guide_appdev_privacy_index.md.html#Privacy%20Guide">Privacy Guide</a>, <a href="guide_appdev_security_index.md.html#Security%20Guide">Security Guide</a>, and
@@ -292,6 +303,7 @@ to the <a href="cordova_plugins_pluginap
</div>
<!-- Functionality and Syntax Highlighting -->
- <script type="text/javascript" src="index.js"></script><script type="text/javascript" src="prettify/prettify.js"></script>
-</body>
+ <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/guide_platforms_amazonfireos_config.md.html
URL: http://svn.apache.org/viewvc/cordova/site/public/docs/en/edge/guide_platforms_amazonfireos_config.md.html?rev=1605933&r1=1605932&r2=1605933&view=diff
==============================================================================
--- cordova/site/public/docs/en/edge/guide_platforms_amazonfireos_config.md.html (original)
+++ cordova/site/public/docs/en/edge/guide_platforms_amazonfireos_config.md.html Thu Jun 26 23:55:47 2014
@@ -17,16 +17,18 @@
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>
+ <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>
@@ -99,6 +101,7 @@
<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="Russian" value="ru">
<option value="edge">edge</option>
<option value="3.5.0">3.5.0</option>
@@ -115,7 +118,8 @@
<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></small>
+</optgroup></select>
+ </small>
</div>
<div id="subheader">
<h1>Amazon Fire OS Configuration</h1>
@@ -233,10 +237,12 @@ values are <code>ERROR</code>, <code>WAR
</code></pre>
</li>
</ul>
-</div>
+
+ </div>
</div>
<!-- Functionality and Syntax Highlighting -->
- <script type="text/javascript" src="index.js"></script><script type="text/javascript" src="prettify/prettify.js"></script>
-</body>
+ <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/guide_platforms_amazonfireos_index.md.html
URL: http://svn.apache.org/viewvc/cordova/site/public/docs/en/edge/guide_platforms_amazonfireos_index.md.html?rev=1605933&r1=1605932&r2=1605933&view=diff
==============================================================================
--- cordova/site/public/docs/en/edge/guide_platforms_amazonfireos_index.md.html (original)
+++ cordova/site/public/docs/en/edge/guide_platforms_amazonfireos_index.md.html Thu Jun 26 23:55:47 2014
@@ -17,16 +17,18 @@
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>
+ <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>
@@ -99,6 +101,7 @@
<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="Russian" value="ru">
<option value="edge">edge</option>
<option value="3.5.0">3.5.0</option>
@@ -115,7 +118,8 @@
<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></small>
+</optgroup></select>
+ </small>
</div>
<div id="subheader">
<h1>Amazon Fire OS Platform Guide</h1>
@@ -168,17 +172,14 @@ deploy Cordova apps for Amazon Fire OS d
<li><a href="guide_platforms_amazonfireos_webview.md.html#Amazon%20Fire%20OS%20WebViews">Amazon Fire OS WebViews</a></li>
<li><a href="guide_platforms_amazonfireos_plugin.md.html#Amazon%20Fire%20OS%20Plugins">Amazon Fire OS Plugins</a></li>
</ul>
-<h2>
-<a name="Amazon%20Fire%20OS%20Platform%20Guide_introduction">Introduction</a>
-</h2>
+
+<h2><a name="Amazon%20Fire%20OS%20Platform%20Guide_introduction">Introduction</a></h2>
<p>By targeting the Amazon Fire OS platform, Cordova developers can create hybrid web apps that take advantage of the advanced web engine integrated into Kindle Fire devices. Amazon WebView API (AWV) is a Chromium-derived web runtime exclusive to Fire OS. A drop-in replacement for the WebView that comes with Android devices, AWV makes it possible to create better performing and more powerful hybrid web apps by providing support for a faster JavaScript engine (V8), remote debugging, and hardware optimizations for Kindle Fire devices including an accelerated 2D Canvas, and access to HTML5 features not supported by Androidâs built in WebView such as: CSS Calc, Form Validation, getUserMedia, IndexedDB, Web Workers, WebSockets and WebGL. </p>
<p>For more information about the Amazon WebView API, please see the Amazon Developer Portal's <a class="external" href="https://developer.amazon.com/public/solutions/platforms/android-fireos/docs/building-and-testing-your-hybrid-app">HTML5 Hybrid Apps page</a>. For questions about getting started and other support issues, please see the Amazon Developer Portal <a class="external" href="http://forums.developer.amazon.com/forums/category.jspa?categoryID=41">Forums - HTML5 Hybrid Apps</a>.</p>
-<h2>
-<a name="Amazon%20Fire%20OS%20Platform%20Guide_requirements_and_support">Requirements and Support</a>
-</h2>
+<h2><a name="Amazon%20Fire%20OS%20Platform%20Guide_requirements_and_support">Requirements and Support</a></h2>
<p>Developing Cordova apps for Amazon Fire OS requires installation of a variety of support files, including everything needed for Android development, as well as the Amazon WebView SDK. Check the list below for the required installs: </p>
@@ -188,9 +189,8 @@ deploy Cordova apps for Amazon Fire OS d
<li><a class="external" href="http://ant.apache.org">Apache Ant</a></li>
<li><a class="external" href="https://developer.amazon.com/public/solutions/platforms/android-fireos/docs/building-and-testing-your-hybrid-app">Amazon WebView SDK</a></li>
</ul>
-<h2>
-<a name="Amazon%20Fire%20OS%20Platform%20Guide_installation">Installation</a>
-</h2>
+
+<h2><a name="Amazon%20Fire%20OS%20Platform%20Guide_installation">Installation</a></h2>
<h3>Android SDK and Apache Ant</h3>
@@ -248,27 +248,25 @@ type <code>java</code>, if it does not r
</code></pre>
</li>
</ul>
+
<h3>Amazon WebView SDK</h3>
-<p>In order to create Cordova apps using the Amazon Fire OS platform target, you'll need to download, unpack and install the Amazon WebView SDK support files. This step will only need to be done for your first Amazon Fire OS project, or if you upgrade Cordova.</p>
+<p>In order to create Cordova apps using the Amazon Fire OS platform target, you'll need to download, unpack and install the Amazon WebView SDK support files. This step will only need to be done for your first Amazon Fire OS project.</p>
<ul>
<li><p>Download the Amazon WebView SDK from the <a class="external" href="https://developer.amazon.com/public/solutions/platforms/android-fireos/docs/building-and-testing-your-hybrid-app">Amazon Developer Portal</a>.</p></li>
<li>
-<p>Copy <code>awv_interface.jar</code> from the downloaded SDK to Cordova's working directory: </p>
+<p>Copy <code>awv_interface.jar</code> from the downloaded SDK to Cordova's working directory. Create commonlibs(shown below) folder if it doesn't exist: </p>
<p><strong>Mac/Linux:</strong>
-<code>~/.cordova/lib/amazon-fireos/cordova/[cordova_release]/framework/libs/</code></p>
+<code>~/.cordova/lib/commonlibs/</code></p>
<p><strong>Windows:</strong>
-<code>%USERPROFILE%\.cordova\lib\amazon-fireos\cordova\[cordova_release]\framework\libs</code></p>
+<code>%USERPROFILE%\.cordova\lib\commonlibs</code></p>
</li>
</ul>
-<p><strong><em>Note:</em></strong> Because of Cordova's on-demand install process, the <code>~/.cordova/lib/amazon-fireos</code> platform directory will not be created until you add the platform to your first project.</p>
-<h2>
-<a name="Amazon%20Fire%20OS%20Platform%20Guide_create_new_project_for_amazon_fire_os">Create New Project for Amazon Fire OS</a>
-</h2>
+<h2><a name="Amazon%20Fire%20OS%20Platform%20Guide_create_new_project_for_amazon_fire_os">Create New Project for Amazon Fire OS</a></h2>
<p>Use the <code>cordova</code> utility to set up a new project, as described in The
Cordova The Command-line Interface. For example, in a source-code directory:</p>
@@ -281,9 +279,7 @@ $ cordova build
<p><strong><em>Note:</em></strong> The first time the amazon-fireos platform is installed on your system, it will download the appropriate files to the Cordova working directory, but will then fail as it is missing the AWV SDK support files (see above). Follow the instructions above to install the <code>awv_interface.jar</code>, then remove and re-add the amazon-fireos platform to your project. This step will only need to be done for first Amazon Fire OS project.</p>
-<h2>
-<a name="Amazon%20Fire%20OS%20Platform%20Guide_deploy_to_device">Deploy to Device</a>
-</h2>
+<h2><a name="Amazon%20Fire%20OS%20Platform%20Guide_deploy_to_device">Deploy to Device</a></h2>
<p>To push an app directly to the device, make sure USB debugging is enabled on your device as described on the
<a class="external" href="http://developer.android.com/tools/device.html">Android Developer Site</a>,
@@ -330,6 +326,7 @@ As â Android Application</strong>.<
<li><p>Eclipse will show you hello and hello-CorddovaLib - 2 projects to be added. Add both.</p></li>
<li><p>Press <strong>Finish</strong>.</p></li>
</ul>
+
<p>Once the Eclipse window opens, a red <strong>X</strong> may appear to indicate
unresolved problems. If so, follow these additional steps:</p>
@@ -340,10 +337,12 @@ unresolved problems. If so, follow these
<li><p>Click <strong>OK</strong>.</p></li>
<li><p>Select <strong>Clean</strong> from the <strong>Project</strong> menu. This should correct all the errors in the project.</p></li>
</ul>
-</div>
+
+ </div>
</div>
<!-- Functionality and Syntax Highlighting -->
- <script type="text/javascript" src="index.js"></script><script type="text/javascript" src="prettify/prettify.js"></script>
-</body>
+ <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/guide_platforms_amazonfireos_plugin.md.html
URL: http://svn.apache.org/viewvc/cordova/site/public/docs/en/edge/guide_platforms_amazonfireos_plugin.md.html?rev=1605933&r1=1605932&r2=1605933&view=diff
==============================================================================
--- cordova/site/public/docs/en/edge/guide_platforms_amazonfireos_plugin.md.html (original)
+++ cordova/site/public/docs/en/edge/guide_platforms_amazonfireos_plugin.md.html Thu Jun 26 23:55:47 2014
@@ -17,16 +17,18 @@
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>
+ <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>
@@ -99,6 +101,7 @@
<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="Russian" value="ru">
<option value="edge">edge</option>
<option value="3.5.0">3.5.0</option>
@@ -115,7 +118,8 @@
<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></small>
+</optgroup></select>
+ </small>
</div>
<div id="subheader">
<h1>Amazon Fire OS Plugins</h1>
@@ -157,9 +161,7 @@
<p>Follow the instructions provided in the <a href="guide_platforms_android_plugin.md.html#Android%20Plugins">Android Plugins</a> Guide for an overview of developing custom plugins.</p>
-<h2>
-<a name="Amazon%20Fire%20OS%20Plugins_echo_amazon_fire_os_plugin_example">Echo Amazon Fire OS Plugin Example</a>
-</h2>
+<h2><a name="Amazon%20Fire%20OS%20Plugins_echo_amazon_fire_os_plugin_example">Echo Amazon Fire OS Plugin Example</a></h2>
<p>To match the JavaScript interface's <em>echo</em> feature described in
Application Plugins, use the <code>plugin.xml</code> to inject a <code>feature</code>
@@ -235,9 +237,7 @@ public class Echo extends CordovaPlugin
</platform>
</code></pre>
-<h2>
-<a name="Amazon%20Fire%20OS%20Plugins_using_amazon_webview_in_your_plugin">Using Amazon WebView in your plugin</a>
-</h2>
+<h2><a name="Amazon%20Fire%20OS%20Plugins_using_amazon_webview_in_your_plugin">Using Amazon WebView in your plugin</a></h2>
<p>Cordova for Amazon Fire OS makes use of custom Amazon WebView that is built on the open-source Chromium project. It is GPU accelerated and optimized for fluid performance on Kindle Fire.</p>
@@ -247,6 +247,7 @@ public class Echo extends CordovaPlugin
</div>
<!-- Functionality and Syntax Highlighting -->
- <script type="text/javascript" src="index.js"></script><script type="text/javascript" src="prettify/prettify.js"></script>
-</body>
+ <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/guide_platforms_amazonfireos_webview.md.html
URL: http://svn.apache.org/viewvc/cordova/site/public/docs/en/edge/guide_platforms_amazonfireos_webview.md.html?rev=1605933&r1=1605932&r2=1605933&view=diff
==============================================================================
--- cordova/site/public/docs/en/edge/guide_platforms_amazonfireos_webview.md.html (original)
+++ cordova/site/public/docs/en/edge/guide_platforms_amazonfireos_webview.md.html Thu Jun 26 23:55:47 2014
@@ -17,16 +17,18 @@
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>
+ <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>
@@ -99,6 +101,7 @@
<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="Russian" value="ru">
<option value="edge">edge</option>
<option value="3.5.0">3.5.0</option>
@@ -115,7 +118,8 @@
<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></small>
+</optgroup></select>
+ </small>
</div>
<div id="subheader">
<h1>Amazon Fire OS WebViews</h1>
@@ -160,18 +164,15 @@
<p>If you're unfamiliar with Amazon Fire OS, you should first familiarize
yourself with the <a href="guide_platforms_amazonfireos_index.md.html#Amazon%20Fire%20OS%20Platform%20Guide">Amazon Fire OS Platform Guide</a> and have the latest SDKs installed before you attempt the more unusual development option of embedding a WebView.</p>
-<h2>
-<a name="Amazon%20Fire%20OS%20WebViews_prerequisites">Prerequisites</a>
-</h2>
+<h2><a name="Amazon%20Fire%20OS%20WebViews_prerequisites">Prerequisites</a></h2>
<ul>
<li><p>Cordova 3.3.0 or greater</p></li>
<li><p>Android SDK updated to the latest SDK</p></li>
<li><p>Amazon WebView SDK</p></li>
</ul>
-<h2>
-<a name="Amazon%20Fire%20OS%20WebViews_guide_to_using_cordovawebview_in_a_amazon_fire_os_project">Guide to using CordovaWebView in a Amazon Fire OS Project</a>
-</h2>
+
+<h2><a name="Amazon%20Fire%20OS%20WebViews_guide_to_using_cordovawebview_in_a_amazon_fire_os_project">Guide to using CordovaWebView in a Amazon Fire OS Project</a></h2>
<ol>
<li><p>To follow these instructions, make sure you have the latest Cordova
@@ -211,6 +212,7 @@ the application:</p>
</code></pre>
</li>
</ol>
+
<p>If you use the camera, you should also implement this:</p>
<pre class="prettyprint"><code> @Override
@@ -269,10 +271,12 @@ the application:</p>
<li><p>Copy your application's HTML and JavaScript files to your Amazon Fire OS project's <code>/assets/www</code> directory.</p></li>
<li><p>Copy <code>config.xml</code> from <code>/framework/res/xml</code> to your project's <code>/res/xml</code> directory.</p></li>
</ol>
-</div>
+
+ </div>
</div>
<!-- Functionality and Syntax Highlighting -->
- <script type="text/javascript" src="index.js"></script><script type="text/javascript" src="prettify/prettify.js"></script>
-</body>
+ <script type="text/javascript" src="index.js"></script>
+ <script type="text/javascript" src="prettify/prettify.js"></script>
+ </body>
</html>