You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@cordova.apache.org by ra...@apache.org on 2016/05/16 21:17:45 UTC
svn commit: r1744142 [7/9] - in /cordova/site/public: ./ docs/en/6.x/
docs/en/6.x/config_ref/ docs/en/6.x/cordova/events/
docs/en/6.x/cordova/storage/ docs/en/6.x/guide/platforms/win8/
docs/en/6.x/plugin_ref/ docs/en/6.x/reference/cordova-cli/ docs/en/...
Modified: cordova/site/public/docs/en/6.x/reference/cordova-plugin-splashscreen/index.html
URL: http://svn.apache.org/viewvc/cordova/site/public/docs/en/6.x/reference/cordova-plugin-splashscreen/index.html?rev=1744142&r1=1744141&r2=1744142&view=diff
==============================================================================
--- cordova/site/public/docs/en/6.x/reference/cordova-plugin-splashscreen/index.html (original)
+++ cordova/site/public/docs/en/6.x/reference/cordova-plugin-splashscreen/index.html Mon May 16 21:17:45 2016
@@ -2703,11 +2703,12 @@ cordova plugin add https://github.com/ap
<li>BlackBerry 10</li>
<li>iOS</li>
<li>Windows Phone 7 and 8</li>
-<li>Windows 8</li>
-<li>Windows</li>
+<li>Windows (<code>cordova-windows</code> version >= 4.4.0 is required)</li>
<li>Browser</li>
</ul>
+<p><strong>Note</strong>: Extended splashscreen does not require the plugin on Windows (as opposed to Android and iOS) in case you don't use the plugin API, i.e. programmatic hide/show.</p>
+
<h2>Example Configuration</h2>
<p>In the top-level <code>config.xml</code> file (not the one in <code>platforms</code>), add configuration elements like those specified here.</p>
@@ -2774,15 +2775,22 @@ cordova plugin add https://github.com/ap
<h4>config.xml</h4>
<ul>
-<li> <strong>AutoHideSplashScreen</strong> (boolean, default to <code>true</code>). Indicates whether to hide splash screen automatically or not. Splash screen hidden after amount of time specified in the <code>SplashScreenDelay</code> preference.</li>
+<li><code>AutoHideSplashScreen</code> (boolean, default to <code>true</code>). Indicates whether to hide splash screen automatically or not. Splash screen hidden after amount of time specified in the <code>SplashScreenDelay</code> preference.</li>
</ul>
<div class="highlight"><pre><code class="language-xml" data-lang="xml"> <span class="nt"><preference</span> <span class="na">name=</span><span class="s">"AutoHideSplashScreen"</span> <span class="na">value=</span><span class="s">"true"</span> <span class="nt">/></span>
</code></pre></div>
<ul>
-<li> <strong>SplashScreenDelay</strong> (number, default to 3000). Amount of time in milliseconds to wait before automatically hide splash screen.</li>
+<li><code>SplashScreenDelay</code> (number, default to 3000). Amount of time in milliseconds to wait before automatically hide splash screen.</li>
</ul>
<div class="highlight"><pre><code class="language-xml" data-lang="xml"> <span class="nt"><preference</span> <span class="na">name=</span><span class="s">"SplashScreenDelay"</span> <span class="na">value=</span><span class="s">"3000"</span> <span class="nt">/></span>
</code></pre></div>
+<p>Note also that this value used to be seconds, and not milliseconds, so values less than 30 will still be treated as seconds. ( Consider this a deprecated patch that will disapear in some future version. )</p>
+
+<p>To disable the splashscreen add the following preference to <code>config.xml</code>: </p>
+<div class="highlight"><pre><code class="language-xml" data-lang="xml"><span class="nt"><preference</span> <span class="na">name=</span><span class="s">"SplashScreenDelay"</span> <span class="na">value=</span><span class="s">"0"</span><span class="nt">/></span>
+</code></pre></div>
+<p><strong>iOS Quirk</strong>: to disable the splashscreen on <code>ios</code> platform you should also add <code><preference name="FadeSplashScreenDuration" value="0"/></code> to <code>config.xml</code>.</p>
+
<ul>
<li><code>FadeSplashScreen</code> (boolean, defaults to <code>true</code>): Set to <code>false</code> to
prevent the splash screen from fading in and out when its display
@@ -2791,13 +2799,11 @@ state changes.</li>
<div class="highlight"><pre><code class="language-xml" data-lang="xml"> <span class="nt"><preference</span> <span class="na">name=</span><span class="s">"FadeSplashScreen"</span> <span class="na">value=</span><span class="s">"false"</span><span class="nt">/></span>
</code></pre></div>
<ul>
-<li><code>FadeSplashScreenDuration</code> (float, defaults to <code>3000</code>): Specifies the
+<li><code>FadeSplashScreenDuration</code> (float, defaults to <code>500</code>): Specifies the
number of milliseconds for the splash screen fade effect to execute.</li>
</ul>
-<div class="highlight"><pre><code class="language-xml" data-lang="xml"> <span class="nt"><preference</span> <span class="na">name=</span><span class="s">"FadeSplashScreenDuration"</span> <span class="na">value=</span><span class="s">"3000"</span><span class="nt">/></span>
+<div class="highlight"><pre><code class="language-xml" data-lang="xml"> <span class="nt"><preference</span> <span class="na">name=</span><span class="s">"FadeSplashScreenDuration"</span> <span class="na">value=</span><span class="s">"750"</span><span class="nt">/></span>
</code></pre></div>
-<p>Note also that this value used to be seconds, and not milliseconds, so values less than 30 will still be treated as seconds. ( Consider this a deprecated patch that will disapear in some future version. )</p>
-
<p><em>Note</em>: <code>FadeSplashScreenDuration</code> is included into <code>SplashScreenDelay</code>, for example if you have <code><preference name="SplashScreenDelay" value="3000" /></code> and <code><preference name="FadeSplashScreenDuration" value="1000"/></code> defined in <code>config.xml</code>:</p>
<ul>
@@ -2822,13 +2828,10 @@ to hide the splash-screen spinner.</li>
</code></pre></div>
<h3>Android Quirks</h3>
-<p>In your <code>config.xml</code>, you need to add the following preferences:</p>
-<div class="highlight"><pre><code class="language-xml" data-lang="xml"><span class="nt"><preference</span> <span class="na">name=</span><span class="s">"SplashScreenDelay"</span> <span class="na">value=</span><span class="s">"3000"</span> <span class="nt">/></span>
-<span class="nt"><preference</span> <span class="na">name=</span><span class="s">"SplashMaintainAspectRatio"</span> <span class="na">value=</span><span class="s">"true|false"</span> <span class="nt">/></span>
+<p>In your <code>config.xml</code>, you can add the following preferences:</p>
+<div class="highlight"><pre><code class="language-xml" data-lang="xml"><span class="nt"><preference</span> <span class="na">name=</span><span class="s">"SplashMaintainAspectRatio"</span> <span class="na">value=</span><span class="s">"true|false"</span> <span class="nt">/></span>
<span class="nt"><preference</span> <span class="na">name=</span><span class="s">"SplashShowOnlyFirstTime"</span> <span class="na">value=</span><span class="s">"true|false"</span> <span class="nt">/></span>
</code></pre></div>
-<p>The first parameter represents how long the splashscreen will appear in milliseconds. It defaults to 3000 ms.</p>
-
<p>"SplashMaintainAspectRatio" preference is optional. If set to true, splash screen drawable is not stretched to fit screen, but instead simply "covers" the screen, like CSS "background-size:cover". This is very useful when splash screen images cannot be distorted in any way, for example when they contain scenery or text. This setting works best with images that have large margins (safe areas) that can be safely cropped on screens with different aspect ratios.</p>
<p>The plugin reloads splash drawable whenever orientation changes, so you can specify different drawables for portrait and landscape orientations.</p>
@@ -2849,24 +2852,26 @@ to hide the splash-screen spinner.</li>
</code></pre></div>
<p><strong>Note</strong>: <code>SplashScreen</code> value should be absolute in order to work in a sub-page. The <code>SplashScreen</code> value is used only for the browser platform. The value will be ignored for other platforms.</p>
-<h3>iOS Quirks
+<h3>iOS Quirks</h3>
+
<ul>
<li>In iOS, the splashscreen images are called launch images. These images are mandatory on iOS.</li>
</ul>
-<h3>Windows Quirks</h3>
+Windows Quirks</h3>
<ul>
-<li><p><code>SplashScreenSpinnerColor</code> (string, defaults to system accent color): hash, rgb notation or CSS color name.</p>
-<div class="highlight"><pre><code class="language-" data-lang=""><preference name="SplashScreenSpinnerColor" value="#242424"/>
-<preference name="SplashScreenSpinnerColor" value="DarkRed"/>
-<preference name="SplashScreenSpinnerColor" value="rgb(50,128,128)"/>
-</code></pre></div></li>
-<li><p><code>SplashScreenBackgroundColor</code> (string, defaults to #464646): hex notation.</p>
-<div class="highlight"><pre><code class="language-" data-lang=""><preference name="SplashScreenBackgroundColor" value="0xFFFFFFFF"/>
-</code></pre></div></li>
+<li><code>SplashScreenSpinnerColor</code> (string, defaults to system accent color): hash, rgb notation or CSS color name.</li>
</ul>
-
+<div class="highlight"><pre><code class="language-xml" data-lang="xml"><span class="nt"><preference</span> <span class="na">name=</span><span class="s">"SplashScreenSpinnerColor"</span> <span class="na">value=</span><span class="s">"#242424"</span><span class="nt">/></span>
+<span class="nt"><preference</span> <span class="na">name=</span><span class="s">"SplashScreenSpinnerColor"</span> <span class="na">value=</span><span class="s">"DarkRed"</span><span class="nt">/></span>
+<span class="nt"><preference</span> <span class="na">name=</span><span class="s">"SplashScreenSpinnerColor"</span> <span class="na">value=</span><span class="s">"rgb(50,128,128)"</span><span class="nt">/></span>
+</code></pre></div>
+<ul>
+<li><code>SplashScreenBackgroundColor</code> (string, defaults to #464646): hex notation.</li>
+</ul>
+<div class="highlight"><pre><code class="language-xml" data-lang="xml"><span class="nt"><preference</span> <span class="na">name=</span><span class="s">"SplashScreenBackgroundColor"</span> <span class="na">value=</span><span class="s">"0xFFFFFFFF"</span><span class="nt">/></span>
+</code></pre></div>
<h2>Methods</h2>
<ul>
@@ -2874,8 +2879,7 @@ to hide the splash-screen spinner.</li>
<li>splashscreen.hide</li>
</ul>
-<h2>splashscreen.hide</h2>
-
+<h2>splashscreen.hide
<p>Dismiss the splash screen.</p>
<div class="highlight"><pre><code class="language-js" data-lang="js"><span class="nx">navigator</span><span class="p">.</span><span class="nx">splashscreen</span><span class="p">.</span><span class="nx">hide</span><span class="p">();</span>
</code></pre></div>
Modified: cordova/site/public/docs/en/dev/config_ref/images.html
URL: http://svn.apache.org/viewvc/cordova/site/public/docs/en/dev/config_ref/images.html?rev=1744142&r1=1744141&r2=1744142&view=diff
==============================================================================
--- cordova/site/public/docs/en/dev/config_ref/images.html (original)
+++ cordova/site/public/docs/en/dev/config_ref/images.html Mon May 16 21:17:45 2016
@@ -6,7 +6,7 @@
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
<meta name="format-detection" content="telephone=no">
<meta name="viewport" content="user-scalable=no, initial-scale=1, maximum-scale=1, minimum-scale=1, width=device-width" />
- <meta name="description" content="Learn how to customize icons for your Cordova app. ">
+ <meta name="description" content="Learn how to customize icons for your Cordova application. ">
<title>
@@ -2655,12 +2655,12 @@
<div id="page-toc-source">
<h1>Customize Icons</h1>
-<p>This section shows how to configure an app's icon for various platforms. Support for splash screen has moved to a Cordova plugin of its own. The configuration options can be found in the <a href="../reference/cordova-plugin-splashscreen/">Splashscreen plugin docs</a>.</p>
+<p>This section shows how to configure an application's icon for various platforms. Documentation about splash screen images can be found in the Cordova-Plugin-Splashscreen documentation <a href="../reference/cordova-plugin-splashscreen/">Splashscreen plugin docs</a>.</p>
<h2>Configuring Icons in the CLI</h2>
-<p>When working in the CLI you can define app icon(s) via <code><icon></code> element (<code>config.xml</code>).
-If you do not specify an icon then the Apache Cordova logo is used.</p>
+<p>When working in the CLI you can define application icon(s) via the <code><icon></code> element (<code>config.xml</code>).
+If you do not specify an icon, the Apache Cordova logo is used.</p>
<div class="highlight"><pre><code class="language-xml" data-lang="xml"> <span class="nt"><icon</span> <span class="na">src=</span><span class="s">"res/ios/icon.png"</span> <span class="na">platform=</span><span class="s">"ios"</span> <span class="na">width=</span><span class="s">"57"</span> <span class="na">height=</span><span class="s">"57"</span> <span class="na">density=</span><span class="s">"mdpi"</span> <span class="nt">/></span>
</code></pre></div>
<table><thead>
@@ -2695,11 +2695,11 @@ If you do not specify an icon then the A
</tr>
</tbody></table>
-<p>The following configuration can be used to define single default icon
+<p>The following configuration can be used to define a single default icon
which will be used for all platforms.</p>
<div class="highlight"><pre><code class="language-xml" data-lang="xml"> <span class="nt"><icon</span> <span class="na">src=</span><span class="s">"res/icon.png"</span> <span class="nt">/></span>
</code></pre></div>
-<p>For each platform you can also define a pixel-perfect icons set to fit
+<p>For each platform, you can also define a pixel-perfect icon set to fit
different screen resolutions.</p>
<h2>Android</h2>
@@ -2739,6 +2739,10 @@ different screen resolutions.</p>
<li><a href="http://developer.blackberry.com/html5/documentation/icon_element.html">BlackBerry's documentation</a> for targeting multiple sizes and locales.</li>
</ul>
+<h2>Browser</h2>
+
+<p>Icons are not applicable to the Browser platform.</p>
+
<h2>iOS</h2>
<div class="highlight"><pre><code class="language-xml" data-lang="xml"> <span class="nt"><platform</span> <span class="na">name=</span><span class="s">"ios"</span><span class="nt">></span>
<span class="c"><!-- iOS 8.0+ --></span>
@@ -2777,7 +2781,7 @@ different screen resolutions.</p>
<h2>Windows</h2>
-<p>For Windows the recommended approach to define app icons is to use <code>target</code> attribute.</p>
+<p>For Windows the recommended approach to define application icons is to use the <code>target</code> attribute.</p>
<div class="highlight"><pre><code class="language-xml" data-lang="xml"> <span class="nt"><platform</span> <span class="na">name=</span><span class="s">"windows"</span><span class="nt">></span>
<span class="nt"><icon</span> <span class="na">src=</span><span class="s">"res/windows/storelogo.png"</span> <span class="na">target=</span><span class="s">"StoreLogo"</span> <span class="nt">/></span>
<span class="nt"><icon</span> <span class="na">src=</span><span class="s">"res/windows/smalllogo.png"</span> <span class="na">target=</span><span class="s">"Square30x30Logo"</span> <span class="nt">/></span>
@@ -2789,16 +2793,18 @@ different screen resolutions.</p>
<span class="nt"><icon</span> <span class="na">src=</span><span class="s">"res/Windows/Wide310x150Logo.png"</span> <span class="na">target=</span><span class="s">"Wide310x150Logo"</span> <span class="nt">/></span>
<span class="nt"></platform></span>
</code></pre></div>
-<p>where <code>source</code> is the path to the icon which needs to be added.</p>
+<p>where <code>src</code> is the path to the icon which needs to be added.</p>
+
+<p>The Windows platform handles MRT icons automatically, so if you specify <code>src="res/windows/storelogo.png"</code> the following files will be copied into the application's <code>images</code> folder: <code>res/windows/storelogo.scale-100.png</code>, <code>res/windows/storelogo.scale-200.png</code>, etc.</p>
-<p>Please note that Windows platform handles MRT icons automatically, so if you specify <code>src="res/windows/storelogo.png"</code> the following files will be copied into app's <code>images</code> folder: <code>res/windows/storelogo.scale-100.png</code>, <code>res/windows/storelogo.scale-200.png</code>, etc.</p>
+<p>TODO Define what MRT is.</p>
-<p>The <code>target</code> attribute specifies the base name for resultant icons. For every icon file destination filename is calculated as <code>target + '.' + MRT_qualifiers + extension(src)</code>. For the icons to display properly in resultant app every <code>target</code> value should be the one of icon filenames, defined in application's <code>.appxmanifest</code> file.</p>
+<p>The <code>target</code> attribute specifies the base name for the resultant icons. For every icon file, its destination filename is calculated as <code>target + '.' + MRT_qualifiers + extension(src)</code>. For the icons to display properly in the application, every <code>target</code> value should be one of the icon filenames defined in the application's <code>.appxmanifest</code> file.</p>
-<p>Summarizing the above, using <code>target</code> attribute it is possible to:</p>
+<p>Summarizing the above... using the <code>target</code> attribute it is possible to:</p>
<ul>
-<li>define a group of icons for different device scale factors using single <code><icon ...></code> element, for example:
+<li>define a group of icons for different device scale factors using a single <code><icon ...></code> element, for example:
<code>xml
<icon src="res/Windows/AppListIcon.png" target="Square44x44Logo" />
</code>
@@ -2812,7 +2818,7 @@ which is equivalent to the following lin
<li>define icons with scale factors other than <code>scale-100</code> and <code>scale-240</code> (and any other MRT qualifiers)</li>
</ul>
-<p>Though it is not recommended but is still possible to define icons using <code>width</code> and <code>height</code> attributes:</p>
+<p>Although it is not recommended, it is also possible to define icons using the <code>width</code> and <code>height</code> attributes:</p>
<div class="highlight"><pre><code class="language-xml" data-lang="xml"> <span class="nt"><platform</span> <span class="na">name=</span><span class="s">"windows"</span><span class="nt">></span>
<span class="nt"><icon</span> <span class="na">src=</span><span class="s">"res/windows/logo.png"</span> <span class="na">width=</span><span class="s">"150"</span> <span class="na">height=</span><span class="s">"150"</span> <span class="nt">/></span>
<span class="nt"><icon</span> <span class="na">src=</span><span class="s">"res/windows/smalllogo.png"</span> <span class="na">width=</span><span class="s">"30"</span> <span class="na">height=</span><span class="s">"30"</span> <span class="nt">/></span>
Modified: cordova/site/public/docs/en/dev/config_ref/index.html
URL: http://svn.apache.org/viewvc/cordova/site/public/docs/en/dev/config_ref/index.html?rev=1744142&r1=1744141&r2=1744142&view=diff
==============================================================================
--- cordova/site/public/docs/en/dev/config_ref/index.html (original)
+++ cordova/site/public/docs/en/dev/config_ref/index.html Mon May 16 21:17:45 2016
@@ -3101,7 +3101,7 @@ and will be indicated as such.</p>
</tr>
<tr>
<td>Orientation(string)</td>
-<td><em>Default: default</em> <br/> Allowed values: default, landscape, portait <br/> Allows you to lock orientation and prevent the interface from rotating in response to changes in orientation. <br/> <strong>NOTE:</strong> The default value means Cordova will strip the orientation preference entry from the platform's manifest/configuration file allowing the platform to fallback to its default behavior. For iOS, to specify both portrait & landscape mode you would use the platform specific value 'all'.</td>
+<td><em>Default: default</em> <br/> Allowed values: default, landscape, portrait <br/> Allows you to lock orientation and prevent the interface from rotating in response to changes in orientation. <br/> <strong>NOTE:</strong> The default value means Cordova will strip the orientation preference entry from the platform's manifest/configuration file allowing the platform to fallback to its default behavior. For iOS, to specify both portrait & landscape mode you would use the platform specific value 'all'.</td>
</tr>
<tr>
<td>OSXLocalStoragePath(string) <br/> <mark>OS X</mark></td>
Modified: cordova/site/public/docs/en/dev/cordova/storage/storage.html
URL: http://svn.apache.org/viewvc/cordova/site/public/docs/en/dev/cordova/storage/storage.html?rev=1744142&r1=1744141&r2=1744142&view=diff
==============================================================================
--- cordova/site/public/docs/en/dev/cordova/storage/storage.html (original)
+++ cordova/site/public/docs/en/dev/cordova/storage/storage.html Mon May 16 21:17:45 2016
@@ -2912,12 +2912,10 @@ The main differences are:</p>
<p>It is available in the following variations:</p>
<ul>
-<li><strong><a href="https://github.com/litehelpers/Cordova-sqlite-storage/blob/core-master/README.md">cordova-sqlite-storage</a></strong> - core version that relies
-on native SQLite implementation. As such, it is only available for iOS
-and Android platforms.</li>
-<li><strong><a href="https://github.com/litehelpers/cordova-sqlite-ext/blob/ext-master/README.md">cordova-sqlite-ext</a></strong> - extended version with additional
-features including support for Windows and REGEXP support on Android and iOS.</li>
-<li><strong><a href="https://github.com/litehelpers/Cordova-sqlite-enterprise-free/blob/evfree-ext-rc/README.md">cordova-sqlite-evfree</a></strong> - similar to <em>cordova-sqlite-ext</em>
+<li><strong><a href="https://github.com/litehelpers/Cordova-sqlite-storage#readme">cordova-sqlite-storage</a></strong> - core version that includes its own sqlite3 implementation. It supports iOS, Android & Windows platforms.</li>
+<li><strong><a href="https://github.com/litehelpers/cordova-sqlite-ext#readme">cordova-sqlite-ext</a></strong> - extended version with additional
+features including REGEXP support on Android and iOS.</li>
+<li><strong><a href="https://github.com/litehelpers/Cordova-sqlite-enterprise-free#readme">cordova-sqlite-evfree</a></strong> - similar to <em>cordova-sqlite-ext</em>
but with improved memory handling. Available under GPL v3 or commercial license.</li>
</ul>
Modified: cordova/site/public/docs/en/dev/guide/platforms/win8/index.html
URL: http://svn.apache.org/viewvc/cordova/site/public/docs/en/dev/guide/platforms/win8/index.html?rev=1744142&r1=1744141&r2=1744142&view=diff
==============================================================================
--- cordova/site/public/docs/en/dev/guide/platforms/win8/index.html (original)
+++ cordova/site/public/docs/en/dev/guide/platforms/win8/index.html Mon May 16 21:17:45 2016
@@ -2711,11 +2711,9 @@ Windows development environment on a Mac
<a href="http://www.visualstudio.com/downloads">Visual Studio</a> matching the version
requirements listed above.</p>
-<p><br/><p align="center"><img src="/static/img/guide/platforms/win8/win8_installSDK.png" /></p><br/></p>
+<p>The tools and SDKs for the target Windows platforms (UWP, 8.1, etc.) must also be selected in the installer. They can be found under the "Windows and Web Development" heading.</p>
-<p>For Windows 10, the Visual Studio installer has an option to install tools to
-build Universal Windows Apps. You must ensure that this option is selected
-when installing to install the required SDK.</p>
+<p><br/><p align="center"><img src="/static/img/guide/platforms/win8/win8_installTools.png" /></p><br/></p>
<h2>Project Configuration</h2>
Modified: cordova/site/public/docs/en/dev/guide/platforms/win8/plugin.html
URL: http://svn.apache.org/viewvc/cordova/site/public/docs/en/dev/guide/platforms/win8/plugin.html?rev=1744142&r1=1744141&r2=1744142&view=diff
==============================================================================
--- cordova/site/public/docs/en/dev/guide/platforms/win8/plugin.html (original)
+++ cordova/site/public/docs/en/dev/guide/platforms/win8/plugin.html Mon May 16 21:17:45 2016
@@ -2701,7 +2701,7 @@ a Windows Store app for Windows 8.1 phon
</code></pre></div>
<p>The <code>echoplugin.js</code> file will forward the <code>echo</code> function call to this proxy through the <code>cordova.exec</code> command and execute this implementation.</p>
-<p>The plugin.xml file will have the settings required for our plugin. In this case, we want to add our <code>echoplugin.js</code> file in the <code>www</code> directory and the <code>echopluginProxy.js</code> file inside the <code>windows</code> source code of our application. Details of these elements can be found in the <a href="../../plugin_ref/spec.html">Plugin.xml</a> reference.</p>
+<p>The plugin.xml file will have the settings required for our plugin. In this case, we want to add our <code>echoplugin.js</code> file in the <code>www</code> directory and the <code>echopluginProxy.js</code> file inside the <code>windows</code> source code of our application. Details of these elements can be found in the <a href="../../../plugin_ref/spec.html">Plugin.xml</a> reference.</p>
<div class="highlight"><pre><code class="language-xml" data-lang="xml"><span class="cp"><?xml version="1.0" encoding="UTF-8"?></span>
<span class="nt"><plugin</span> <span class="na">xmlns=</span><span class="s">"http://apache.org/cordova/ns/plugins/1.0"</span>
<span class="na">id=</span><span class="s">"echoplugin"</span>
Modified: cordova/site/public/docs/en/dev/index.html
URL: http://svn.apache.org/viewvc/cordova/site/public/docs/en/dev/index.html?rev=1744142&r1=1744141&r2=1744142&view=diff
==============================================================================
--- cordova/site/public/docs/en/dev/index.html (original)
+++ cordova/site/public/docs/en/dev/index.html Mon May 16 21:17:45 2016
@@ -2673,7 +2673,7 @@
<li>
<h2><a href="config_ref/images.html">Customize icons</a></h2>
- <span class="summary">Learn how to customize icons for your Cordova app.</span>
+ <span class="summary">Learn how to customize icons for your Cordova application.</span>
</li>
Modified: cordova/site/public/docs/en/dev/plugin_ref/plugman.html
URL: http://svn.apache.org/viewvc/cordova/site/public/docs/en/dev/plugin_ref/plugman.html?rev=1744142&r1=1744141&r2=1744142&view=diff
==============================================================================
--- cordova/site/public/docs/en/dev/plugin_ref/plugman.html (original)
+++ cordova/site/public/docs/en/dev/plugin_ref/plugman.html Mon May 16 21:17:45 2016
@@ -2702,7 +2702,7 @@ listed on the Platform guides page.</p>
<h2>Adding a Plugin</h2>
<p>Once you have installed Plugman and have created a Cordova project, you can start adding plugins to the platform with:</p>
-<div class="highlight"><pre><code class="language-bash" data-lang="bash"><span class="gp">$ </span>plugman --platform <ios|android|blackberry10|wp8> --project <directory> --plugin <name|url|path> <span class="o">[</span>--plugins_dir <directory>] <span class="o">[</span>--www <directory>] <span class="o">[</span>--variable <name><span class="o">=</span><value> <span class="o">[</span>--variable <name><span class="o">=</span><value> ...]]
+<div class="highlight"><pre><code class="language-bash" data-lang="bash"><span class="gp">$ </span>plugman install --platform <ios|android|blackberry10|wp8> --project <directory> --plugin <name|url|path> <span class="o">[</span>--plugins_dir <directory>] <span class="o">[</span>--www <directory>] <span class="o">[</span>--variable <name><span class="o">=</span><value> <span class="o">[</span>--variable <name><span class="o">=</span><value> ...]]
</code></pre></div>
<p>Using minimum parameters, this command installs a plugin into a cordova project. You must specify a platform and cordova project location for that platform. You also must specify a plugin, with the different <code>--plugin</code> parameter forms being:</p>
@@ -2722,8 +2722,8 @@ listed on the Platform guides page.</p>
<h2>Remove a Plugin</h2>
-<p>To uninstall a plugin, you simply pass the <code>--uninstall</code> flag and provide the plugin ID.</p>
-<div class="highlight"><pre><code class="language-bash" data-lang="bash"><span class="gp">$ </span>plugman --uninstall --platform <ios|android|blackberry10|wp8> --project <directory> --plugin <id> <span class="o">[</span>--www <directory>] <span class="o">[</span>--plugins_dir <directory>]
+<p>To uninstall a plugin, you simply pass the <code>uninstall</code> command and provide the plugin ID.</p>
+<div class="highlight"><pre><code class="language-bash" data-lang="bash"><span class="gp">$ </span>plugman uninstall --platform <ios|android|blackberry10|wp8> --project <directory> --plugin <id> <span class="o">[</span>--www <directory>] <span class="o">[</span>--plugins_dir <directory>]
</code></pre></div>
<h2>Help Commands</h2>
@@ -2775,58 +2775,58 @@ platform, and reference the platform'
<ul>
<li><p>cordova-plugin-battery-status</p>
-<div class="highlight"><pre><code class="language-bash" data-lang="bash">plugman --platform <ios|android|blackberry10|wp8> --project <directory> --plugin cordova-plugin-battery-status
+<div class="highlight"><pre><code class="language-bash" data-lang="bash">plugman install --platform <ios|android|blackberry10|wp8> --project <directory> --plugin cordova-plugin-battery-status
</code></pre></div></li>
<li><p>cordova-plugin-camera</p>
-<div class="highlight"><pre><code class="language-bash" data-lang="bash">plugman --platform <ios|android|blackberry10|wp8> --project <directory> --plugin cordova-plugin-camera
+<div class="highlight"><pre><code class="language-bash" data-lang="bash">plugman install --platform <ios|android|blackberry10|wp8> --project <directory> --plugin cordova-plugin-camera
</code></pre></div></li>
<li><p>cordova-plugin-console</p>
-<div class="highlight"><pre><code class="language-bash" data-lang="bash">plugman --platform <ios|android|blackberry10|wp8> --project <directory> --plugin cordova-plugin-console
+<div class="highlight"><pre><code class="language-bash" data-lang="bash">plugman install --platform <ios|android|blackberry10|wp8> --project <directory> --plugin cordova-plugin-console
</code></pre></div></li>
<li><p>cordova-plugin-contacts</p>
-<div class="highlight"><pre><code class="language-bash" data-lang="bash">plugman --platform <ios|android|blackberry10|wp8> --project <directory> --plugin cordova-plugin-contacts
+<div class="highlight"><pre><code class="language-bash" data-lang="bash">plugman install --platform <ios|android|blackberry10|wp8> --project <directory> --plugin cordova-plugin-contacts
</code></pre></div></li>
<li><p>cordova-plugin-device</p>
-<div class="highlight"><pre><code class="language-bash" data-lang="bash">plugman --platform <ios|android|blackberry10|wp8> --project <directory> --plugin cordova-plugin-device
+<div class="highlight"><pre><code class="language-bash" data-lang="bash">plugman install --platform <ios|android|blackberry10|wp8> --project <directory> --plugin cordova-plugin-device
</code></pre></div></li>
<li><p>cordova-plugin-device-motion (accelerometer)</p>
-<div class="highlight"><pre><code class="language-bash" data-lang="bash">plugman --platform <ios|android|blackberry10|wp8> --project <directory> --plugin cordova-plugin-device-motion
+<div class="highlight"><pre><code class="language-bash" data-lang="bash">plugman install --platform <ios|android|blackberry10|wp8> --project <directory> --plugin cordova-plugin-device-motion
</code></pre></div></li>
<li><p>cordova-plugin-device-orientation (compass)</p>
-<div class="highlight"><pre><code class="language-bash" data-lang="bash">plugman --platform <ios|android|blackberry10|wp8> --project <directory> --plugin cordova-plugin-device-orientation
+<div class="highlight"><pre><code class="language-bash" data-lang="bash">plugman install --platform <ios|android|blackberry10|wp8> --project <directory> --plugin cordova-plugin-device-orientation
</code></pre></div></li>
<li><p>cordova-plugin-dialogs</p>
-<div class="highlight"><pre><code class="language-bash" data-lang="bash">plugman --platform <ios|android|blackberry10|wp8> --project <directory> --plugin cordova-plugin-dialogs
+<div class="highlight"><pre><code class="language-bash" data-lang="bash">plugman install --platform <ios|android|blackberry10|wp8> --project <directory> --plugin cordova-plugin-dialogs
</code></pre></div></li>
<li><p>cordova-plugin-file</p>
-<div class="highlight"><pre><code class="language-bash" data-lang="bash">plugman --platform <ios|android|blackberry10|wp8> --project <directory> --plugin cordova-plugin-file
+<div class="highlight"><pre><code class="language-bash" data-lang="bash">plugman install --platform <ios|android|blackberry10|wp8> --project <directory> --plugin cordova-plugin-file
</code></pre></div></li>
<li><p>cordova-plugin-file-transfer</p>
-<div class="highlight"><pre><code class="language-bash" data-lang="bash">plugman --platform <ios|android|blackberry10|wp8> --project <directory> --plugin cordova-plugin-file-transfer
+<div class="highlight"><pre><code class="language-bash" data-lang="bash">plugman install --platform <ios|android|blackberry10|wp8> --project <directory> --plugin cordova-plugin-file-transfer
</code></pre></div></li>
<li><p>cordova-plugin-geolocation</p>
-<div class="highlight"><pre><code class="language-bash" data-lang="bash">plugman --platform <ios|android|blackberry10|wp8> --project <directory> --plugin cordova-plugin-geolocation
+<div class="highlight"><pre><code class="language-bash" data-lang="bash">plugman install --platform <ios|android|blackberry10|wp8> --project <directory> --plugin cordova-plugin-geolocation
</code></pre></div></li>
<li><p>cordova-plugin-globalization</p>
-<div class="highlight"><pre><code class="language-bash" data-lang="bash">plugman --platform <ios|android|blackberry10|wp8> --project <directory> --plugin cordova-plugin-globalization
+<div class="highlight"><pre><code class="language-bash" data-lang="bash">plugman install --platform <ios|android|blackberry10|wp8> --project <directory> --plugin cordova-plugin-globalization
</code></pre></div></li>
<li><p>cordova-plugin-inappbrowser</p>
-<div class="highlight"><pre><code class="language-bash" data-lang="bash">plugman --platform <ios|android|blackberry10|wp8> --project <directory> --plugin cordova-plugin-inappbrowser
+<div class="highlight"><pre><code class="language-bash" data-lang="bash">plugman install --platform <ios|android|blackberry10|wp8> --project <directory> --plugin cordova-plugin-inappbrowser
</code></pre></div></li>
<li><p>cordova-plugin-media</p>
-<div class="highlight"><pre><code class="language-bash" data-lang="bash">plugman --platform <ios|android|blackberry10|wp8> --project <directory> --plugin cordova-plugin-media
+<div class="highlight"><pre><code class="language-bash" data-lang="bash">plugman install --platform <ios|android|blackberry10|wp8> --project <directory> --plugin cordova-plugin-media
</code></pre></div></li>
<li><p>cordova-plugin-media-capture</p>
-<div class="highlight"><pre><code class="language-bash" data-lang="bash">plugman --platform <ios|android|blackberry10|wp8> --project <directory> --plugin cordova-plugin-media-capture
+<div class="highlight"><pre><code class="language-bash" data-lang="bash">plugman install --platform <ios|android|blackberry10|wp8> --project <directory> --plugin cordova-plugin-media-capture
</code></pre></div></li>
<li><p>cordova-plugin-network-information</p>
-<div class="highlight"><pre><code class="language-bash" data-lang="bash">plugman --platform <ios|android|blackberry10|wp8> --project <directory> --plugin cordova-plugin-network-information
+<div class="highlight"><pre><code class="language-bash" data-lang="bash">plugman install --platform <ios|android|blackberry10|wp8> --project <directory> --plugin cordova-plugin-network-information
</code></pre></div></li>
<li><p>cordova-plugin-splashscreen</p>
-<div class="highlight"><pre><code class="language-bash" data-lang="bash">plugman --platform <ios|android|blackberry10|wp8> --project <directory> --plugin cordova-plugin-splashscreen
+<div class="highlight"><pre><code class="language-bash" data-lang="bash">plugman install --platform <ios|android|blackberry10|wp8> --project <directory> --plugin cordova-plugin-splashscreen
</code></pre></div></li>
<li><p>cordova-plugin-vibration</p>
-<div class="highlight"><pre><code class="language-bash" data-lang="bash">plugman --platform <ios|android|blackberry10|wp8> --project <directory> --plugin cordova-plugin-vibration
+<div class="highlight"><pre><code class="language-bash" data-lang="bash">plugman install --platform <ios|android|blackberry10|wp8> --project <directory> --plugin cordova-plugin-vibration
</code></pre></div></li>
</ul>
Modified: cordova/site/public/docs/en/dev/reference/cordova-cli/index.html
URL: http://svn.apache.org/viewvc/cordova/site/public/docs/en/dev/reference/cordova-cli/index.html?rev=1744142&r1=1744141&r2=1744142&view=diff
==============================================================================
--- cordova/site/public/docs/en/dev/reference/cordova-cli/index.html (original)
+++ cordova/site/public/docs/en/dev/reference/cordova-cli/index.html Mon May 16 21:17:45 2016
@@ -2703,6 +2703,10 @@
<td>help <command></td>
<td>Get help for a command</td>
</tr>
+<tr>
+<td>telemetry</td>
+<td>Turn telemetry collection on or off</td>
+</tr>
</tbody></table>
<h2>Project Command List</h2>
@@ -2779,6 +2783,10 @@
<td>--nohooks</td>
<td>Suppress executing hooks (taking RegExp hook patterns as parameters)</td>
</tr>
+<tr>
+<td>--no-telemetry</td>
+<td>Disable telemetry collection for the current command.</td>
+</tr>
</tbody></table>
<h2>Platform-specific options</h2>
@@ -2794,8 +2802,12 @@ cordova create myApp com.myCompany.myApp
cd myApp
# Add camera plugin to the project and remember that in config.xml
cordova plugin add cordova-plugin-camera --save
+# Add camera plugin to the project and remember that in config.xml. Use npm install to fetch.
+cordova plugin add cordova-plugin-camera --save --fetch
# Add android platform to the project and remember that in config.xml
cordova platform add android --save
+# Add android platform to the project and remember that in config.xml. Use npm install to fetch.
+cordova platform add android --save --fetch
# Check to see if your system is configured for building android platform.
cordova requirements android
# Build the android and emit verbose logs.
@@ -2942,11 +2954,12 @@ www/
<h3>Syntax</h3>
<div class="highlight"><pre><code class="language-bash" data-lang="bash">cordova <span class="o">{</span>platform | platforms<span class="o">}</span> <span class="o">[</span>
- add <platform-spec> <span class="o">[</span>...] <span class="o">{</span>--save | <span class="nv">link</span><span class="o">=</span><path> <span class="o">}</span> |
- <span class="o">{</span>remove | rm<span class="o">}</span> platform <span class="o">[</span>...] |
+ add <platform-spec> <span class="o">[</span>...] <span class="o">{</span>--save | <span class="nv">link</span><span class="o">=</span><path> | --fetch <span class="o">}</span> |
+ <span class="o">{</span>remove | rm<span class="o">}</span> platform <span class="o">[</span>...] <span class="o">{</span>--save | --fetch<span class="o">}</span>|
<span class="o">{</span>list | ls<span class="o">}</span> |
check |
- save <span class="o">]</span>
+ save |
+ update <span class="o">]</span>
</code></pre></div>
<table><thead>
<tr>
@@ -2971,6 +2984,11 @@ www/
<td>When <code><platform-spec></code> is a local path, links the platform library directly instead of making a copy of it (support varies by platform; useful for platform development)</td>
</tr>
<tr>
+<td></td>
+<td>--fetch</td>
+<td>Fetches the platform using <code>npm install</code> and stores it into the apps <code>node_modules</code> directory</td>
+</tr>
+<tr>
<td>remove <code><platform></code> [...]</td>
<td></td>
<td>Remove specified platforms</td>
@@ -2981,6 +2999,11 @@ www/
<td>Delete specified platforms from <code>config.xml</code> after removing them</td>
</tr>
<tr>
+<td></td>
+<td>--fetch</td>
+<td>Removes the platform using <code>npm uninstall</code> and removes it from the apps <code>node_modules</code> directory</td>
+</tr>
+<tr>
<td>update <code>platform</code> [...]</td>
<td></td>
<td>Update specified platforms</td>
@@ -2991,6 +3014,11 @@ www/
<td>Updates the version specified in <code>config.xml</code></td>
</tr>
<tr>
+<td></td>
+<td>--fetch</td>
+<td>Fetches the platform using <code>npm install</code> and stores it into the apps <code>node_modules</code> directory</td>
+</tr>
+<tr>
<td>list</td>
<td></td>
<td>List all installed and available platforms</td>
@@ -3066,6 +3094,10 @@ www/
<li><p>Add pinned version of the <code>android</code> and <code>ios</code> platform and save the downloaded version to <code>config.xml</code>:</p>
<div class="highlight"><pre><code class="language-" data-lang="">cordova platform add android ios --save
</code></pre></div></li>
+<li><p>Add pinned version of the <code>android</code> and <code>ios</code> platform and save the downloaded version to <code>config.xml</code>. Install
+to the project using <code>npm install</code> and store it in the apps <code>node_modules</code> directory:</p>
+<div class="highlight"><pre><code class="language-" data-lang="">cordova platform add android ios --save --fetch
+</code></pre></div></li>
<li><p>Add <code>android</code> platform with <a href="http://semver.org/">semver</a> version ^5.0.0 and save it to <code>config.xml</code>:</p>
<div class="highlight"><pre><code class="language-" data-lang="">cordova platform add android@^5.0.0 --save
</code></pre></div></li>
@@ -3081,6 +3113,10 @@ www/
<li><p>Remove <code>android</code> platform from the project and from <code>config.xml</code>:</p>
<div class="highlight"><pre><code class="language-" data-lang="">cordova platform rm android --save
</code></pre></div></li>
+<li><p>Remove <code>android</code> platform from the project and from <code>config.xml</code>. Run <code>npm uninstall</code> to remove it
+from the <code>node_modules</code> directory.</p>
+<div class="highlight"><pre><code class="language-" data-lang="">cordova platform rm android --save --fetch
+</code></pre></div></li>
<li><p>List available and installed platforms with version numbers. This is useful to find version numbers when reporting issues:</p>
<div class="highlight"><pre><code class="language-" data-lang="">cordova platform ls
</code></pre></div></li>
@@ -3097,8 +3133,8 @@ www/
<h3>Syntax</h3>
<div class="highlight"><pre><code class="language-bash" data-lang="bash">cordova <span class="o">{</span>plugin | plugins<span class="o">}</span> <span class="o">[</span>
- add <plugin-spec> <span class="o">[</span>..] <span class="o">{</span>--searchpath<span class="o">=</span><directory> | --noregistry | --link | --save | --browserify | --force<span class="o">}</span> |
- <span class="o">{</span>remove | rm<span class="o">}</span> <span class="o">{</span><pluginid> | <name><span class="o">}</span> --save |
+ add <plugin-spec> <span class="o">[</span>..] <span class="o">{</span>--searchpath<span class="o">=</span><directory> | --noregistry | --link | --save | --browserify | --force | --fetch<span class="o">}</span> |
+ <span class="o">{</span>remove | rm<span class="o">}</span> <span class="o">{</span><pluginid> | <name><span class="o">}</span> --save --fetch |
<span class="o">{</span>list | ls<span class="o">}</span> |
search <span class="o">[</span><keyword>] |
save |
@@ -3119,7 +3155,7 @@ www/
<tr>
<td></td>
<td>--searchpath <code><directory></code></td>
-<td>When looking up plugins by ID, look in this directory and each of its subdirectories before hitting the registry. Multiple search paths can be specified. Use ':' as a separator in *nix based systems and ';' for Windows.</td>
+<td>When looking up plugins by ID, look in this directory and each of its subdirectories before hitting the registry. Multiple search paths can be specified. Use ':' as a separator in <code>*nix</code> based systems and ';' for Windows.</td>
</tr>
<tr>
<td></td>
@@ -3147,6 +3183,11 @@ www/
<td><em>Introduced in version 6.1.</em> Forces copying source files from the plugin even if the same file already exists in the target directory.</td>
</tr>
<tr>
+<td></td>
+<td>--fetch</td>
+<td>Fetches the plugin using <code>npm install</code> and stores it into the apps <code>node_modules</code> directory</td>
+</tr>
+<tr>
<td>remove `<pluginid></td>
<td><name>` [...]</td>
<td></td>
@@ -3157,6 +3198,11 @@ www/
<td>Remove the specified plugin from config.xml</td>
</tr>
<tr>
+<td></td>
+<td>--fetch</td>
+<td>Removes the plugin using <code>npm uninstall</code> and removes it from the apps <code>node_modules</code> directory</td>
+</tr>
+<tr>
<td>list</td>
<td></td>
<td>List currently installed plugins</td>
@@ -3210,7 +3256,7 @@ www/
</tr>
<tr>
<td>subdir</td>
-<td>Sub-directory to find plugin.xml for the specified plugin.</td>
+<td>Sub-directory to find plugin.xml for the specified plugin. (Doesn't work with <code>--fetch</code> option)</td>
</tr>
</tbody></table>
@@ -3235,6 +3281,9 @@ based on the following criteria (listed
<li><p>Add <code>cordova-plugin-camera</code> with <a href="http://semver.org/">semver</a> version ^2.0.0 and save it to <code>config.xml</code>:</p>
<div class="highlight"><pre><code class="language-" data-lang="">cordova plugin add cordova-plugin-camera@^2.0.0 --save
</code></pre></div></li>
+<li><p>Add <code>cordova-plugin-camera</code> with <a href="http://semver.org/">semver</a> version ^2.0.0 and <code>npm install</code> it. It will be stored in the <code>node_modules</code> directory:</p>
+<div class="highlight"><pre><code class="language-" data-lang="">cordova plugin add cordova-plugin-camera@^2.0.0 --fetch
+</code></pre></div></li>
<li><p>Clone the specified git repo, checkout to tag <code>2.1.0</code>, look for plugin.xml in the <code>plugin</code> directory, and add it to the project. Save the <code>plugin-spec</code> to <code>config.xml</code>:</p>
<div class="highlight"><pre><code class="language-" data-lang="">cordova plugin add https://github.com/apache/cordova-plugin-camera.git#2.1.0:plugin --save
</code></pre></div></li>
@@ -3247,6 +3296,9 @@ based on the following criteria (listed
<li><p>Remove the plugin from the project and the <code>config.xml</code>:</p>
<div class="highlight"><pre><code class="language-" data-lang="">cordova plugin rm camera --save
</code></pre></div></li>
+<li><p>Remove the plugin from the project and <code>npm uninstall</code> it. Removes it from the <code>node_modules</code> directory:</p>
+<div class="highlight"><pre><code class="language-" data-lang="">cordova plugin rm camera --fetch
+</code></pre></div></li>
<li><p>List all plugins installed in the project:</p>
<div class="highlight"><pre><code class="language-" data-lang="">cordova plugin ls
</code></pre></div></li>
@@ -3261,7 +3313,7 @@ copies plugin files for specified platfo
<h3>Syntax</h3>
<div class="highlight"><pre><code class="language-" data-lang="">cordova prepare [<platform> [..]]
- [--browserify]
+ [--browserify | --fetch]
</code></pre></div>
<h3>Options</h3>
@@ -3279,6 +3331,10 @@ copies plugin files for specified platfo
<td>--browserify</td>
<td>Compile plugin JS at build time using browserify instead of runtime.</td>
</tr>
+<tr>
+<td>--fetch</td>
+<td>When restoring plugins or platforms, fetch will <code>npm install</code> the missing modules.</td>
+</tr>
</tbody></table>
<h2>cordova compile command</h2>
@@ -3511,6 +3567,45 @@ base of your project.</p>
<h3>Syntax</h3>
<div class="highlight"><pre><code class="language-" data-lang="">cordova serve [port]
</code></pre></div>
+<h2>cordova telemetry command</h2>
+
+<h3>Synopsis</h3>
+
+<p>Turns telemetry collection on or off.</p>
+
+<h3>Syntax</h3>
+<div class="highlight"><pre><code class="language-" data-lang="">cordova telemetry [STATE]
+</code></pre></div>
+<table><thead>
+<tr>
+<th>Option</th>
+<th>Description</th>
+</tr>
+</thead><tbody>
+<tr>
+<td>on</td>
+<td>Turn telemetry collection on.</td>
+</tr>
+<tr>
+<td>off</td>
+<td>Turn telemetry collection off.</td>
+</tr>
+</tbody></table>
+
+<h3>Details</h3>
+
+<p>A timed prompt asking the user to opt-in or out is displayed the first time cordova is run.
+ It lasts for 30 seconds, after which the user is automatically opted-out if he doesn't provide any answer.
+ In CI environments, the <code>CI</code> environment variable can be set, which will prevent the prompt from showing up.
+ Telemetry collection can also be turned off on a single command by using the <code>--no-telemetry</code> flag.</p>
+
+<h3>Examples</h3>
+<div class="highlight"><pre><code class="language-" data-lang="">cordova telemetry on
+cordova telemetry off
+cordova build --no-telemetry
+</code></pre></div>
+<p>For details, see our privacy notice: https://cordova.apache.org/privacy</p>
+
<h2>cordova help command</h2>
<h3>Synopsis</h3>
Modified: cordova/site/public/docs/en/dev/reference/cordova-plugin-media-capture/index.html
URL: http://svn.apache.org/viewvc/cordova/site/public/docs/en/dev/reference/cordova-plugin-media-capture/index.html?rev=1744142&r1=1744141&r2=1744142&view=diff
==============================================================================
--- cordova/site/public/docs/en/dev/reference/cordova-plugin-media-capture/index.html (original)
+++ cordova/site/public/docs/en/dev/reference/cordova-plugin-media-capture/index.html Mon May 16 21:17:45 2016
@@ -3339,6 +3339,37 @@ the following default values:</p>
<li><p><strong>duration</strong>: Supported: audio and video files only.</p></li>
</ul>
+<h2>Android Lifecycle Quirks</h2>
+
+<p>When capturing audio, video, or images on the Android platform, there is a chance that the
+application will get destroyed after the Cordova Webview is pushed to the background by
+the native capture application. See the <a href="http://cordova.apache.org/docs/en/latest/guide/platforms/android/index.html#lifecycle-guide">Android Lifecycle Guide</a> for
+a full description of the issue. In this case, the success and failure callbacks passed
+to the capture method will not be fired and instead the results of the call will be
+delivered via a document event that fires after the Cordova <a href="http://cordova.apache.org/docs/en/latest/cordova/events/events.html#resume">resume event</a>.</p>
+
+<p>In your app, you should subscribe to the two possible events like so:</p>
+<div class="highlight"><pre><code class="language-javascript" data-lang="javascript"><span class="kd">function</span> <span class="nx">onDeviceReady</span><span class="p">()</span> <span class="p">{</span>
+ <span class="c1">// pendingcaptureresult is fired if the capture call is successful</span>
+ <span class="nb">document</span><span class="p">.</span><span class="nx">addEventListener</span><span class="p">(</span><span class="s1">'pendingcaptureresult'</span><span class="p">,</span> <span class="kd">function</span><span class="p">(</span><span class="nx">mediaFiles</span><span class="p">)</span> <span class="p">{</span>
+ <span class="c1">// Do something with result</span>
+ <span class="p">});</span>
+
+ <span class="c1">// pendingcaptureerror is fired if the capture call is unsuccessful</span>
+ <span class="nb">document</span><span class="p">.</span><span class="nx">addEventListener</span><span class="p">(</span><span class="s1">'pendingcaptureerror'</span><span class="p">,</span> <span class="kd">function</span><span class="p">(</span><span class="nx">error</span><span class="p">)</span> <span class="p">{</span>
+ <span class="c1">// Handle error case</span>
+ <span class="p">});</span>
+<span class="p">}</span>
+
+<span class="c1">// Only subscribe to events after deviceready fires</span>
+<span class="nb">document</span><span class="p">.</span><span class="nx">addEventListener</span><span class="p">(</span><span class="s1">'deviceready'</span><span class="p">,</span> <span class="nx">onDeviceReady</span><span class="p">);</span>
+</code></pre></div>
+<p>It is up you to track what part of your code these results are coming from. Be sure to
+save and restore your app's state as part of the <a href="http://cordova.apache.org/docs/en/latest/cordova/events/events.html#pause">pause</a> and
+<a href="http://cordova.apache.org/docs/en/latest/cordova/events/events.html#resume">resume</a> events as appropriate. Please note that these events will only
+fire on the Android platform and only when the Webview was destroyed during a capture
+operation.</p>
+
</div>
</div>
Modified: cordova/site/public/docs/en/dev/reference/cordova-plugin-splashscreen/index.html
URL: http://svn.apache.org/viewvc/cordova/site/public/docs/en/dev/reference/cordova-plugin-splashscreen/index.html?rev=1744142&r1=1744141&r2=1744142&view=diff
==============================================================================
--- cordova/site/public/docs/en/dev/reference/cordova-plugin-splashscreen/index.html (original)
+++ cordova/site/public/docs/en/dev/reference/cordova-plugin-splashscreen/index.html Mon May 16 21:17:45 2016
@@ -2715,6 +2715,8 @@ cordova plugin add https://github.com/ap
<li>Browser</li>
</ul>
+<p><strong>Note</strong>: Extended splashscreen does not require the plugin on Windows (as opposed to Android and iOS) in case you don't use the plugin API, i.e. programmatic hide/show.</p>
+
<h2>Example Configuration</h2>
<p>In the top-level <code>config.xml</code> file (not the one in <code>platforms</code>), add configuration elements like those specified here.</p>
@@ -2781,15 +2783,22 @@ cordova plugin add https://github.com/ap
<h4>config.xml</h4>
<ul>
-<li> <strong>AutoHideSplashScreen</strong> (boolean, default to <code>true</code>). Indicates whether to hide splash screen automatically or not. Splash screen hidden after amount of time specified in the <code>SplashScreenDelay</code> preference.</li>
+<li><code>AutoHideSplashScreen</code> (boolean, default to <code>true</code>). Indicates whether to hide splash screen automatically or not. Splash screen hidden after amount of time specified in the <code>SplashScreenDelay</code> preference.</li>
</ul>
<div class="highlight"><pre><code class="language-xml" data-lang="xml"> <span class="nt"><preference</span> <span class="na">name=</span><span class="s">"AutoHideSplashScreen"</span> <span class="na">value=</span><span class="s">"true"</span> <span class="nt">/></span>
</code></pre></div>
<ul>
-<li> <strong>SplashScreenDelay</strong> (number, default to 3000). Amount of time in milliseconds to wait before automatically hide splash screen.</li>
+<li><code>SplashScreenDelay</code> (number, default to 3000). Amount of time in milliseconds to wait before automatically hide splash screen.</li>
</ul>
<div class="highlight"><pre><code class="language-xml" data-lang="xml"> <span class="nt"><preference</span> <span class="na">name=</span><span class="s">"SplashScreenDelay"</span> <span class="na">value=</span><span class="s">"3000"</span> <span class="nt">/></span>
</code></pre></div>
+<p>Note also that this value used to be seconds, and not milliseconds, so values less than 30 will still be treated as seconds. ( Consider this a deprecated patch that will disapear in some future version. )</p>
+
+<p>To disable the splashscreen add the following preference to <code>config.xml</code>: </p>
+<div class="highlight"><pre><code class="language-xml" data-lang="xml"><span class="nt"><preference</span> <span class="na">name=</span><span class="s">"SplashScreenDelay"</span> <span class="na">value=</span><span class="s">"0"</span><span class="nt">/></span>
+</code></pre></div>
+<p><strong>iOS Quirk</strong>: to disable the splashscreen on <code>ios</code> platform you should also add <code><preference name="FadeSplashScreenDuration" value="0"/></code> to <code>config.xml</code>.</p>
+
<ul>
<li><code>FadeSplashScreen</code> (boolean, defaults to <code>true</code>): Set to <code>false</code> to
prevent the splash screen from fading in and out when its display
@@ -2798,13 +2807,11 @@ state changes.</li>
<div class="highlight"><pre><code class="language-xml" data-lang="xml"> <span class="nt"><preference</span> <span class="na">name=</span><span class="s">"FadeSplashScreen"</span> <span class="na">value=</span><span class="s">"false"</span><span class="nt">/></span>
</code></pre></div>
<ul>
-<li><code>FadeSplashScreenDuration</code> (float, defaults to <code>3000</code>): Specifies the
+<li><code>FadeSplashScreenDuration</code> (float, defaults to <code>500</code>): Specifies the
number of milliseconds for the splash screen fade effect to execute.</li>
</ul>
-<div class="highlight"><pre><code class="language-xml" data-lang="xml"> <span class="nt"><preference</span> <span class="na">name=</span><span class="s">"FadeSplashScreenDuration"</span> <span class="na">value=</span><span class="s">"3000"</span><span class="nt">/></span>
+<div class="highlight"><pre><code class="language-xml" data-lang="xml"> <span class="nt"><preference</span> <span class="na">name=</span><span class="s">"FadeSplashScreenDuration"</span> <span class="na">value=</span><span class="s">"750"</span><span class="nt">/></span>
</code></pre></div>
-<p>Note also that this value used to be seconds, and not milliseconds, so values less than 30 will still be treated as seconds. ( Consider this a deprecated patch that will disapear in some future version. )</p>
-
<p><em>Note</em>: <code>FadeSplashScreenDuration</code> is included into <code>SplashScreenDelay</code>, for example if you have <code><preference name="SplashScreenDelay" value="3000" /></code> and <code><preference name="FadeSplashScreenDuration" value="1000"/></code> defined in <code>config.xml</code>:</p>
<ul>
@@ -2829,13 +2836,10 @@ to hide the splash-screen spinner.</li>
</code></pre></div>
<h3>Android Quirks</h3>
-<p>In your <code>config.xml</code>, you need to add the following preferences:</p>
-<div class="highlight"><pre><code class="language-xml" data-lang="xml"><span class="nt"><preference</span> <span class="na">name=</span><span class="s">"SplashScreenDelay"</span> <span class="na">value=</span><span class="s">"3000"</span> <span class="nt">/></span>
-<span class="nt"><preference</span> <span class="na">name=</span><span class="s">"SplashMaintainAspectRatio"</span> <span class="na">value=</span><span class="s">"true|false"</span> <span class="nt">/></span>
+<p>In your <code>config.xml</code>, you can add the following preferences:</p>
+<div class="highlight"><pre><code class="language-xml" data-lang="xml"><span class="nt"><preference</span> <span class="na">name=</span><span class="s">"SplashMaintainAspectRatio"</span> <span class="na">value=</span><span class="s">"true|false"</span> <span class="nt">/></span>
<span class="nt"><preference</span> <span class="na">name=</span><span class="s">"SplashShowOnlyFirstTime"</span> <span class="na">value=</span><span class="s">"true|false"</span> <span class="nt">/></span>
</code></pre></div>
-<p>The first parameter represents how long the splashscreen will appear in milliseconds. It defaults to 3000 ms.</p>
-
<p>"SplashMaintainAspectRatio" preference is optional. If set to true, splash screen drawable is not stretched to fit screen, but instead simply "covers" the screen, like CSS "background-size:cover". This is very useful when splash screen images cannot be distorted in any way, for example when they contain scenery or text. This setting works best with images that have large margins (safe areas) that can be safely cropped on screens with different aspect ratios.</p>
<p>The plugin reloads splash drawable whenever orientation changes, so you can specify different drawables for portrait and landscape orientations.</p>
@@ -2862,19 +2866,20 @@ to hide the splash-screen spinner.</li>
<li>In iOS, the splashscreen images are called launch images. These images are mandatory on iOS.</li>
</ul>
-<h3>Windows Quirks</h3>
+Windows Quirks</h3>
<ul>
-<li><p><code>SplashScreenSpinnerColor</code> (string, defaults to system accent color): hash, rgb notation or CSS color name.</p>
-<div class="highlight"><pre><code class="language-" data-lang=""><preference name="SplashScreenSpinnerColor" value="#242424"/>
-<preference name="SplashScreenSpinnerColor" value="DarkRed"/>
-<preference name="SplashScreenSpinnerColor" value="rgb(50,128,128)"/>
-</code></pre></div></li>
-<li><p><code>SplashScreenBackgroundColor</code> (string, defaults to #464646): hex notation.</p>
-<div class="highlight"><pre><code class="language-" data-lang=""><preference name="SplashScreenBackgroundColor" value="0xFFFFFFFF"/>
-</code></pre></div></li>
+<li><code>SplashScreenSpinnerColor</code> (string, defaults to system accent color): hash, rgb notation or CSS color name.</li>
</ul>
-
+<div class="highlight"><pre><code class="language-xml" data-lang="xml"><span class="nt"><preference</span> <span class="na">name=</span><span class="s">"SplashScreenSpinnerColor"</span> <span class="na">value=</span><span class="s">"#242424"</span><span class="nt">/></span>
+<span class="nt"><preference</span> <span class="na">name=</span><span class="s">"SplashScreenSpinnerColor"</span> <span class="na">value=</span><span class="s">"DarkRed"</span><span class="nt">/></span>
+<span class="nt"><preference</span> <span class="na">name=</span><span class="s">"SplashScreenSpinnerColor"</span> <span class="na">value=</span><span class="s">"rgb(50,128,128)"</span><span class="nt">/></span>
+</code></pre></div>
+<ul>
+<li><code>SplashScreenBackgroundColor</code> (string, defaults to #464646): hex notation.</li>
+</ul>
+<div class="highlight"><pre><code class="language-xml" data-lang="xml"><span class="nt"><preference</span> <span class="na">name=</span><span class="s">"SplashScreenBackgroundColor"</span> <span class="na">value=</span><span class="s">"0xFFFFFFFF"</span><span class="nt">/></span>
+</code></pre></div>
<h2>Methods</h2>
<ul>
@@ -2882,8 +2887,7 @@ to hide the splash-screen spinner.</li>
<li>splashscreen.hide</li>
</ul>
-<h2>splashscreen.hide</h2>
-
+<h2>splashscreen.hide
<p>Dismiss the splash screen.</p>
<div class="highlight"><pre><code class="language-js" data-lang="js"><span class="nx">navigator</span><span class="p">.</span><span class="nx">splashscreen</span><span class="p">.</span><span class="nx">hide</span><span class="p">();</span>
</code></pre></div>
Modified: cordova/site/public/feed.xml
URL: http://svn.apache.org/viewvc/cordova/site/public/feed.xml?rev=1744142&r1=1744141&r2=1744142&view=diff
==============================================================================
--- cordova/site/public/feed.xml (original)
+++ cordova/site/public/feed.xml Mon May 16 21:17:45 2016
@@ -6,8 +6,8 @@
</description>
<link>https://cordova.apache.org/</link>
<atom:link href="https://cordova.apache.org/feed.xml" rel="self" type="application/rss+xml"/>
- <pubDate>Mon, 09 May 2016 17:28:14 -0700</pubDate>
- <lastBuildDate>Mon, 09 May 2016 17:28:14 -0700</lastBuildDate>
+ <pubDate>Mon, 16 May 2016 11:48:38 -0700</pubDate>
+ <lastBuildDate>Mon, 16 May 2016 11:48:38 -0700</lastBuildDate>
<generator>Jekyll v2.5.3</generator>
<item>
Added: cordova/site/public/privacy/index.html
URL: http://svn.apache.org/viewvc/cordova/site/public/privacy/index.html?rev=1744142&view=auto
==============================================================================
--- cordova/site/public/privacy/index.html (added)
+++ cordova/site/public/privacy/index.html Mon May 16 21:17:45 2016
@@ -0,0 +1,231 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+ <meta charset="utf-8">
+ <meta http-equiv="X-UA-Compatible" content="IE=edge,chrome=1">
+ <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
+ <meta name="format-detection" content="telephone=no">
+ <meta name="viewport" content="user-scalable=no, initial-scale=1, maximum-scale=1, minimum-scale=1, width=device-width" />
+ <meta name="description" content=" ">
+
+ <title>
+
+
+ Apache Cordova CLI Privacy Policy - Apache Cordova
+
+
+ </title>
+
+ <link rel="SHORTCUT ICON" href="/favicon.ico"/>
+
+
+
+
+
+
+ <link rel="canonical" href="https://cordova.apache.org/privacy/">
+
+ <!-- CSS -->
+ <link rel="stylesheet" type="text/css" href="/static/css/main.css">
+ <link rel="stylesheet" type="text/css" href="/static/css/lib/syntax.css">
+ <!-- Algolia Search CSS -->
+ <link rel="stylesheet" href="https://cdn.jsdelivr.net/docsearch.js/1/docsearch.min.css" />
+
+ <!-- Fonts -->
+ <!-- For attribution information, see www/attributions.html -->
+ <link href='https://fonts.googleapis.com/css?family=Raleway:700,400,300,700italic,400italic,300italic' rel='stylesheet' type='text/css'>
+
+ <!-- HTML5 shim and Respond.js for IE8 support of HTML5 elements and media queries -->
+ <!--[if lt IE 9]>
+ <script src="https://oss.maxcdn.com/html5shiv/3.7.2/html5shiv.min.js"></script>
+ <script src="https://oss.maxcdn.com/respond/1.4.2/respond.min.js"></script>
+ <![endif]-->
+ <script type="text/javascript">
+ var disqus_developer = 1; // this would set it to developer mode
+ </script>
+
+ <!-- JS -->
+ <script defer type="text/javascript" src="/static/js/lib/jquery-2.1.1.min.js"></script>
+ <script defer type="text/javascript" src="/static/js/lib/bootstrap.min.js"></script>
+ <script defer type="text/javascript" src="/static/js/lib/ZeroClipboard.js"></script>
+
+ <script>
+ (function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){
+ (i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o),
+ m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m)
+ })(window,document,'script','//www.google-analytics.com/analytics.js','ga');
+ ga('create', 'UA-64283057-3', 'auto');
+ ga('send', 'pageview');
+</script>
+
+</head>
+
+<body>
+ <header>
+ <a class="scroll-point pt-top" name="top"></a>
+ <nav class="navbar navbar-inverse navbar-fixed-top">
+ <div class="container-fluid">
+ <div class="navbar-header">
+ <button type="button" class="navbar-toggle collapsed" data-toggle="collapse" data-target="#navbar" aria-expanded="false" aria-controls="navbar">
+ <span class="sr-only">Toggle navigation</span>
+ <span class="icon-bar"></span>
+ <span class="icon-bar"></span>
+ <span class="icon-bar"></span>
+ </button>
+ <a class="navbar-brand" href="/"><img id="logo_top" src="/static/img/cordova-logo-newbrand.svg"/></a>
+ </div>
+ <div id="navbar" class="navbar-collapse collapse">
+ <div class="nav_bar_center">
+ <ul class="nav navbar-nav">
+ <li >
+ <a href="/docs/en/latest/">Documentation</a>
+ </li>
+ <li >
+ <a href="/plugins">Plugins</a>
+ </li>
+ <li >
+ <a href="/blog" id="blog_button">Blog<span class="badge" id="new_blog_count"></span></a>
+ </li>
+ <li >
+ <a href="/contribute">Contribute</a>
+ </li>
+ <li>
+ <a href="/#getstarted">Get Started</a>
+ </li>
+ <li>
+ <form class="navbar-form navbar-right" id="header-search-form" role="search">
+ <div class="input-group">
+
+
+
+ <input id="header-search-field" type="text" placeholder="Search '6.x' docs..." class="form-control hidden-xs" autocomplete="off">
+ </div>
+ </form>
+ </li>
+ </ul>
+ </div>
+ </div><!--/.navbar-collapse -->
+ </div>
+ </nav>
+ <div id="_fixed_navbar_spacer" style="padding-top:50px"></div>
+</header>
+
+<div class="page container">
+ <h1>Apache Cordova CLI Privacy Policy</h1>
+
+<p>When you opt into telemetry, information about your usage of Apache Cordova CLI is collected. The collected information consists of the following:</p>
+
+<ul>
+<li>IP address</li>
+<li>OS type and version</li>
+<li>Node version</li>
+<li>Cordova version</li>
+<li>Commands executed, time of execution and status (success/failure)</li>
+</ul>
+
+<p>This information is saved in Google Analytics and handled by Google as described in their <a href="http://www.google.com/policies/privacy/">privacy policy</a>. See the <a href="http://cordova.apache.org/docs/en/latest/reference/cordova-cli/index.html#cordova-telemetry-command">documentation for instructions on how to disable telemetry</a> if you prefer not to share your data.</p>
+
+<p>We use the gathered information to help us make our tool more useful and to better understand how it is used. We do not track or collect personally identifiable information or associate gathered data with any personally identifying information from other sources.</p>
+
+<p>By opting into telemetry, you consent to the collection of this data in the manner and for the purpose described above.</p>
+
+<p>The Apache Cordova community welcomes your questions or comments regarding this Privacy Policy. Send them to dev@cordova.apache.org</p>
+
+</div>
+
+<div class="blue-divider"></div>
+<footer>
+ <div class="container">
+ <div class="row">
+ <div class="col-sm-9">
+ <h1>More Resources</h1>
+ <div class="row">
+ <div class="col-sm-4">
+ <h2>General</h2>
+ <ul class="nav">
+ <li>
+ <a target="_blank" href="https://projects.apache.org/project.html?cordova">Apache Project Page</a>
+ </li>
+ <li>
+ <a href="https://dist.apache.org/repos/dist/release/cordova/">Source Distribution</a>
+ </li>
+ <li>
+ <a target="_blank" href="http://www.apache.org/licenses/LICENSE-2.0">License</a>
+ </li>
+ <li>
+ <a href="/artwork">Artwork</a>
+ </li>
+ </ul>
+ </div>
+ <div class="col-sm-4">
+ <h2>Development</h2>
+ <ul class="nav">
+ <li><a target="_blank" href="https://github.com/apache?utf8=%E2%9C%93&query=cordova-">Source Code</a></li>
+ <li><a target="_blank" href="https://issues.apache.org/jira/browse/CB/">Issue Tracker</a></li>
+ <li><a target="_blank" href="http://stackoverflow.com/questions/tagged/cordova">Stack Overflow</a></li>
+ <li><a href="/contact">Mailing List</a></li>
+ </ul>
+ </div>
+ <div class="col-sm-4">
+ <h2>Apache Software Foundation</h2>
+ <ul class="nav">
+ <li>
+ <a target="_blank" href="http://www.apache.org/">About ASF</a>
+ </li>
+ <li>
+ <a target="_blank" href="http://www.apache.org/foundation/sponsorship.html">Become a Sponsor</a>
+ </li>
+ <li>
+ <a target="_blank" href="http://www.apache.org/foundation/thanks.html">Thanks</a>
+ </li>
+ <li>
+ <a target="_blank" href="http://www.apache.org/security/">Security</a>
+ </li>
+ </ul>
+ </div>
+ </div>
+ </div>
+ <div class="col-sm-3">
+ <h1>Contribute</h1>
+ <p style="padding-top:20px"><strong>Help Cordova move forward!</strong></p>
+ <p>Report bugs, improve the docs, or contribute to the code.</p>
+ <a href="/contribute" class="btn btn-lg btn-primary">
+ Learn More
+ </a>
+ <p style="padding-top:20px"> <a href="https://twitter.com/apachecordova" class="twitter-follow-button" data-show-count="false">Follow @apachecordova</a></p>
+ <script async defer src="https://slack.cordova.io/slackin.js"></script>
+ </div>
+</div>
+<p class="copyright_text">
+ Copyright © 2012, 2013, 2015 The Apache Software Foundation, Licensed under the <a target="_blank" href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.<br/>
+ Apache and the Apache feather logos are <a target="_blank" href="http://www.apache.org/foundation/marks/list/">trademarks</a> of The Apache Software Foundation.
+ <br/>
+ "Raleway" font used under license. For details see the <a href="/attributions/">attributions page</a>.
+</p>
+
+ </div>
+</footer>
+
+
+ <script defer type="text/javascript" src="/static/js/index.js"></script>
+ <script defer type="text/javascript" src="/static/js/twitter.js"></script>
+
+
+
+
+
+
+
+
+<script type="text/javascript" src="https://cdn.jsdelivr.net/docsearch.js/1/docsearch.min.js"></script>
+<script type="text/javascript">
+ docsearch({
+ apiKey: '0a916ab198bd93d031aa70611271e42e',
+ indexName: 'cordova',
+ inputSelector: '#header-search-field',
+ algoliaOptions: { 'facetFilters': ["version: 6.x", "language: en"] }
+ });
+</script>
+
+</body>
+</html>
---------------------------------------------------------------------
To unsubscribe, e-mail: commits-unsubscribe@cordova.apache.org
For additional commands, e-mail: commits-help@cordova.apache.org